OpenClaw 安装教程(Windows + WSL)

##注意:

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

一、安装 WSL

  1. 打开 Terminal Canary(管理员)运行:
wsl --install
  1. 安装完成后重启电脑。

  2. 打开 Ubuntu(WSL)终端,首次启动会创建用户名和密码。

二、更新 Linux 系统

sudo apt update && sudo apt upgrade -y

三、安装 Git

sudo apt install git -y

检查:

git --version

四、安装 NVM(Node 版本管理器)

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

五、安装 Node.js(推荐 v24)

nvm install 24
nvm use 24
node -v   # 应显示 v24.x.x
npm -v    # 应显示 11.x.x

六、解决 GitHub SSH 访问问题(改用 HTTPS)

git config --global url."https://github.com/".insteadOf "git@github.com:"
git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"

七、安装 OpenClaw

npm install -g openclaw

测试:

openclaw --help

八、可选优化

  1. 使用国内 npm 镜像,提高下载速度:
npm config set registry https://registry.npmmirror.com
  1. 配置文件路径:

    • Linux: /home/用户名/.openclaw/home/用户名/.config/openclaw
    • Windows: \\wsl$\Ubuntu\home\用户名\.openclaw
  2. 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服务,如果你有,你直接配置,如果你没有,https://jige.io 他们提供专业服务
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐