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

​
前置准备

  • 你使用的是 Windows 系统
  • 你可以使用管理员权限打开终端
  • 建议提前安装 Terminal Canary，后续复制和粘贴更方便

​
安装步骤

1

安装 WSL

用管理员身份打开 Terminal Canary、PowerShell 或 CMD，然后运行：
wsl --install
安装完成后，重启电脑。首次打开 Ubuntu（WSL）时，系统会提示你创建用户名和密码。
2

更新 Linux 系统

在 Ubuntu 终端中运行：
sudo apt update && sudo apt upgrade -y
3

安装 Git

sudo apt install git -y
git --version
4

安装 NVM

curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
5

安装 Node.js

推荐安装 Node.js 24：
nvm install 24
nvm use 24
node -v
npm -v
正常情况下，node -v 会显示 v24.x.x，npm -v 会显示 11.x.x。
6

将 GitHub SSH 改为 HTTPS

如果当前环境访问 GitHub SSH 有问题，可以执行：
git config --global url."https://github.com/".insteadOf "git@github.com:"
git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"
7

安装 OpenClaw

npm install -g openclaw
openclaw --help
8

定位配置文件

如果你还不确定配置文件位置，可以先搜索：
find ~ -name "*openclaw*" 2>/dev/null
常见路径如下：
  • Linux：/home/用户名/.openclaw 或 /home/用户名/.config/openclaw
  • Windows：\\wsl$\Ubuntu\home\用户名\.openclaw
9

配置 OpenClaw

用文本编辑器打开 openclaw.json，替换为以下内容：
{
  "models": {
    "mode": "merge",
    "providers": {
      "jige": {
        "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-5.4",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 128000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "jige/gpt-5.3-codex"
      },
      "models": {
        "jige/gpt-5.3-codex": {
          "alias": "gpt-5.3-codex"
        },
        "jige/gpt-5.4": {
          "alias": "gpt-5.4"
        }
      },
      "compaction": {
        "mode": "safeguard"
      }
    }
  },
  "tools": {
    "profile": "coding",
    "web": {
      "fetch": {
        "enabled": true
      }
    }
  }
}
如果你需要更多模型，可以在此基础上继续添加 models。
10

启动 OpenClaw

在 Ubuntu 终端中运行：
openclaw gateway
启动成功后，在浏览器中打开 http://127.0.0.1:18789/。页面会要求你输入令牌。这个令牌可以在 openclaw.json 中的 gateway.auth.token 找到，例如：
"gateway": {
  "mode": "local",
  "auth": {
    "mode": "token",
    "token": "05****"
  }
}
将该令牌填入页面后，你就可以开始使用 OpenClaw。

​
可选优化

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

​
注意事项

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