说真的，OpenClaw这个名字在开发者圈子里已经越来越响了。最近评论区、私信里来问安装方法的人一波接一波，好多都是第一次接触这类工具的新手。我琢磨着，与其一个个回复，不如直接写篇详细的安装教程，从下载到搞定一次性说清楚。废话不多说，开干。

OpenClaw最新版本一键部署包下载地址：https://top.wokk.cn/

先说系统要求

在开始装之前，先确认你的机器条件够不够。OpenClaw对硬件其实挺友好的，不是非得搞台高配服务器。但有几个底线你必须满足：

操作系统：Windows 10/11（64位）、Ubuntu 20.04及以上、macOS 12及以上都行。我个人推荐用Ubuntu Server或者Windows Server，稳定性更好一些。纯开发测试的话，自己的笔记本也完全够。

内存：最低4GB，推荐8GB以上。如果你同时要跑AI模型之类的重活，16GB起步比较稳。

硬盘：至少留20GB的空闲空间。日志和缓存文件会随时间增长，别一开始就卡着容量线搞。

网络：需要能访问外网。安装过程中要拉取一些依赖包，全程断网是不行的。如果在国内，后面我会说怎么配镜像加速。

运行时环境：需要Node.js 18+和Python 3.9+。后面安装步骤里我会帮你一起搞定，不用提前装。

第一步：下载安装包

去官网下载页面，选择跟你系统对应的版本。Windows用户下.exe安装包，Linux用户下.deb或者直接用包管理器装，Mac用户下.dmg。

下载速度如果比较慢，可以试试用迅雷或者IDM多线程下载，能快不少。

下完之后校验一下文件完整性。Windows上可以用PowerShell跑：

Get-FileHash 你的安装包路径 -Algorithm SHA256

把算出来的哈希值跟官网提供的对一下，一致就说明文件没被篡改过。这一步很多人嫌麻烦跳过了，但安全起见还是建议做一下。

第二步：执行安装

这一步分系统来说。

Windows用户：

双击安装包，一路Next就行。安装路径建议用默认的，不要装到带中文或者空格的目录下（比如C:\Program Files\OpenClaw就没问题，但C:\我的软件\OpenClaw就可能出幺蛾子）。

安装过程中会弹出Node.js和Python的安装选项。如果你电脑上已经装了对应版本，可以跳过。如果没有，建议勾选让安装程序一起装，省得后面手动折腾。

安装完成后，打开命令行（Win+R输入cmd或者PowerShell），验证一下：

openclaw --version

能看到版本号就说明装好了。

Linux用户（Ubuntu）：

如果是deb包

sudo dpkg -i openclaw_latest_amd64.deb
sudo apt-get install -f # 解决依赖

或者用包管理器

sudo apt update
sudo apt install openclaw

装完同样跑一下openclaw --version确认。

macOS用户：

打开dmg文件，把OpenClaw拖到Applications文件夹。然后在终端里验证：

openclaw --version

如果提示"command not found"，需要手动把路径加到PATH里：

echo ‘export PATH=“/Applications/OpenClaw/bin:$PATH”’ >> ~/.zshrc
source ~/.zshrc

第三步：初始配置

装好之后别急着用，先做一下基本配置。运行初始化命令：

openclaw init

这个命令会引导你完成几个配置项：

1. 设置管理员账号密码。这个很重要，建议用强密码。如果后面要对外暴露服务，弱密码被人扫到就麻烦了。

2. 选择端口。默认是8080端口。如果你的8080已经被别的服务占了，可以改成别的，比如9090、3000之类的。

3. 数据存储路径。OpenClaw的数据（配置、日志、缓存等）默认存在用户目录下。你可以自定义到一个空间更大的分区。

4. 语言设置。选择简体中文，这样界面和提示信息都是中文的，对新手更友好。

初始化完成之后，启动服务：

openclaw gateway start

看到"Gateway started successfully"之类的提示就OK了。浏览器打开http://localhost:8080（如果你改了端口就换成对应端口），能看到管理界面就说明一切正常。

汉化包安装

OpenClaw原生支持多语言，但默认安装可能不包含完整的中文语言包。如果你发现界面上还有一些英文没有翻译过来，可以手动安装汉化包。

汉化包的安装方法：

openclaw locale install zh-CN

安装完之后重启服务就能生效了：

openclaw gateway restart

如果汉化包安装失败，大概率是网络问题。国内用户可以手动下载汉化包文件，然后离线安装：

openclaw locale install ./zh-CN-pack.zip

汉化包文件一般包含一个locale文件夹，里面有翻译用的json文件。如果你想自己改翻译内容，直接编辑对应的json就行。比如把某个专业术语换成你更习惯的说法，完全支持自定义。

常见问题排查

安装过程中遇到问题是正常的，别慌。我把最常见的问题和解决办法整理了一下。

问题1：安装后命令行找不到openclaw

这种情况基本上是PATH没配好。Windows用户检查一下系统环境变量，把OpenClaw的bin目录加进去。Linux和Mac用户检查一下_/.bashrc或/.zshrc里的PATH配置。

问题2：端口被占用

用netstat -ano | findstr 8080（Windows）或者lsof -i :8080（Linux/Mac）看看是什么程序占用了8080端口。要么关掉那个程序，要么给OpenClaw换一个端口。换端口的方法是修改配置文件里的port字段。

问题3：依赖安装失败

如果是网络问题，国内用户可以配置npm和pip的镜像源。npm用淘宝源：

npm config set registry https://registry.npmmirror.com

pip用清华源：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

配完镜像之后再重新跑安装命令，基本就能顺利通过了。

问题4：权限不足

Windows用户右键"以管理员身份运行"命令行再装。Linux用户加sudo。Mac用户有时候也需要sudo。

问题5：服务启动后立刻退出

这种情况先看日志。日志文件通常在数据目录下的logs文件夹里。打开最新的日志文件看看报错信息。最常见的原因是配置文件格式错误——比如多了一个逗号、少了一个引号之类的。用JSON校验工具检查一下配置文件。

卸载和更新

顺便说一下卸载和更新的方法。

卸载：Windows用户在控制面板的"程序和功能"里找到OpenClaw卸载就行。Linux用户sudo apt remove openclaw。Mac用户把Applications里的OpenClaw删掉，然后清理一下配置目录。

更新：直接跑以下命令就行，OpenClaw会自动检查并下载最新版本：

openclaw update

更新前建议先备份一下配置文件和数据目录，以防万一。

到这里，OpenClaw的安装就全部搞定了。整个过程不难，关键是要有耐心，一步一步来。遇到报错不要急着重启重装，先看日志、查原因，大部分问题都能快速定位解决。如果实在搞不定，评论区留言，我看到都会回。