Skip to main content
通过以下步骤,你可以在 Windows + WSL 环境中安装 OpenClaw 并接入极鸽。
当前流程依赖可正常访问外部网络的环境。如果你在安装过程中遇到异常,请联系技术支持。

前置准备

  • 你使用的是 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.xnpm -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 终端中运行:
启动成功后,在浏览器中打开 http://127.0.0.1:18789/页面会要求你输入令牌。这个令牌可以在 openclaw.json 中的 gateway.auth.token 找到,例如:
将该令牌填入页面后,你就可以开始使用 OpenClaw。

可选优化

  • 使用国内镜像加速依赖安装:npm config set registry https://registry.npmmirror.com
  • 安装 VS Code 和 WSL 扩展后,你可以在 WSL 中运行 code . 直接打开项目

注意事项

  • 建议使用 NVM 安装 Node.js,这样可以避免权限问题
  • Node.js 版本需要大于等于 22
  • 全局安装 npm 包时不要使用 sudo