OpenClaw 安装教程（Windows + WSL）

OpenClaw 安装教程（Windows + WSL）

##注意：

1. 请确保您的电脑有 Terminal Canary，如果没有建议先安装，这回比PowerShell让你在后续的操作中更为便捷，鼠标右键即可粘贴剪切板，不论您使用的是 Terminal Canary、PowerShell、CMD，都请用管理员身份运行。

一、安装 WSL

1. 打开 Terminal Canary（管理员）运行：

wsl--install

2. 安装完成后重启电脑。

3. 打开 Ubuntu（WSL）终端，首次启动会创建用户名和密码。

二、更新 Linux 系统

sudoaptupdate&&sudoaptupgrade-y

三、安装 Git

sudoaptinstallgit-y

检查：

git--version

四、安装 NVM（Node 版本管理器）

curl-fsSLhttps://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bashsource~/.bashrc

五、安装 Node.js（推荐 v24）

nvminstall24nvm use24node-v# 应显示 v24.x.xnpm-v# 应显示 11.x.x

六、解决 GitHub SSH 访问问题（改用 HTTPS）

gitconfig--globalurl."https://github.com/".insteadOf"git@github.com:"gitconfig--globalurl."https://github.com/".insteadOf"ssh://git@github.com/"

七、安装 OpenClaw

npminstall-gopenclaw

测试：

openclaw--help

八、可选优化

1. 使用国内 npm 镜像，提高下载速度：

npmconfigsetregistry https://registry.npmmirror.com

2. 配置文件路径：

   • Linux:/home/用户名/.openclaw或/home/用户名/.config/openclaw
   • Windows:\\wsl$\Ubuntu\home\用户名\.openclaw

3. WSL + VSCode 配合使用：

   • 安装 VSCode 和 WSL 扩展
   • 在 WSL 中运行code .直接打开项目

九、快速定位配置文件

find~-name"*openclaw*"2>/dev/null

十、配置文件

文件管理器里面通过记事本 打开openclaw.json文件，并修改配置文件，替换内容如下：

{"models":{"mode":"merge","providers":{"jige2":{"baseUrl":"https://jige.rsss.xyz/v1","apiKey":"sk-你在极鸽平台创建的令牌，复制进来即可","api":"openai-responses","models":[{"id":"gpt-5.3-codex","name":"gpt-5.3-codex","reasoning":false,"input":["text","image"],"contextWindow":128000},{"id":"gpt-5.4","name":"gpt-4","reasoning":true,"input":["text","image"],"contextWindow":128000}]}}},"agents":{"defaults":{"model":{"primary":"jige2/gpt-5.3-codex"},"models":{"jige2/gpt-5.3-codex":{"alias":"gpt-5.3-codex"},"jige2/gpt-5.4":{"alias":"gpt-5.3-codex"}},"compaction":{"mode":"safeguard"}}},"tools":{"profile":"coding","web":{"fetch":{"enabled":true}}}}

如果您需要更多的模型，可在这个基础上继续添加models

##十一、启动OpenClaw

1. 回到之前安装open claw的控制台，ubuntu下输入

openclaw gateway

以启动openclaw
2. 启动成功后，浏览器打开 http://127.0.0.1:18789/
3. 打开后页面会让输入一个令牌，这个令牌在openclaw.json文件下面，如：

"gateway":{"mode":"local","auth":{"mode":"token","token":"05****，把openclaw生成的这个令牌输入到页面的令牌框就可以开始openclaw之旅了"}}

十二、注意事项

• 使用 NVM 安装 Node 可以避免权限问题
• Node 版本必须 >=22
• npm global 安装不要用sudo，用 NVM 安装的 Node 已经有权限
• 使用此教程安装openclaw，需要Vpn，同时也需要购买AI token服务，如果你有，你直接配置，如果你没有，敬请关注极鸽 他们提供专业服务