当前流程依赖可正常访问外部网络的环境。如果你在安装过程中遇到异常,请联系技术支持。
前置准备
- 你使用的是 Windows 系统
- 你可以使用管理员权限打开终端
- 建议提前安装 Terminal Canary,后续复制和粘贴更方便
安装步骤
1
安装 WSL
用管理员身份打开 Terminal Canary、PowerShell 或 CMD,然后运行:安装完成后,重启电脑。首次打开 Ubuntu(WSL)时,系统会提示你创建用户名和密码。
2
更新 Linux 系统
在 Ubuntu 终端中运行:
3
安装 Git
4
安装 NVM
5
安装 Node.js
推荐安装 Node.js 24:正常情况下,
node -v 会显示 v24.x.x,npm -v 会显示 11.x.x。6
将 GitHub SSH 改为 HTTPS
如果当前环境访问 GitHub SSH 有问题,可以执行:
7
安装 OpenClaw
8
定位配置文件
如果你还不确定配置文件位置,可以先搜索:常见路径如下:
- Linux:
/home/用户名/.openclaw或/home/用户名/.config/openclaw - Windows:
\\wsl$\Ubuntu\home\用户名\.openclaw
9
配置 OpenClaw
用文本编辑器打开 如果你需要更多模型,可以在此基础上继续添加
openclaw.json,替换为以下内容:models。10
启动 OpenClaw
在 Ubuntu 终端中运行:启动成功后,在浏览器中打开 将该令牌填入页面后,你就可以开始使用 OpenClaw。
http://127.0.0.1:18789/。页面会要求你输入令牌。这个令牌可以在 openclaw.json 中的 gateway.auth.token 找到,例如:可选优化
- 使用国内镜像加速依赖安装:
npm config set registry https://registry.npmmirror.com - 安装 VS Code 和 WSL 扩展后,你可以在 WSL 中运行
code .直接打开项目
注意事项
- 建议使用 NVM 安装 Node.js,这样可以避免权限问题
- Node.js 版本需要大于等于 22
- 全局安装 npm 包时不要使用
sudo