Windows环境安装Openclaw踩坑

ClarkC.2026-02-17 12:42

参考Openclaw官方文档的操作步骤，在Windows系统从源码安装时，遇到了以下几个问题。

第一，安装使用管理员权限的Powershell

第二，注意Node版本>=22

第三，在执行pnpm ui:build时报错Error: spawn EINVAL

解决方法：修改源码中的\openclaw\scripts\ui.js文件，将如下函数：

javascript 复制代码

function run(cmd, args) {
  const child = spawn(cmd, args, {
    cwd: uiDir,
    stdio: "inherit",
    env: process.env,
  });
  child.on("exit", (code, signal) => {
    if (signal) {
      process.exit(1);
    }
    process.exit(code ?? 1);
  });
}

修改为：

javascript 复制代码

function run(cmd, args) {
  const child = spawn(cmd, args, {
    cwd: uiDir,
    stdio: "inherit",
    env: process.env,
    shell: true       //windows安装添加
  });
  child.on("exit", (code, signal) => {
    if (signal) {
      process.exit(1);
    }
    process.exit(code ?? 1);
  });
}

第四，执行pnpm build的时遇到bash报错

解决方法：将bash添加到windows的PATH环境变量。

第五，执行openclaw onboard --install-daemon需要在前面添加pnpm

第六，使用时chat不回复

在配置文件C:\Users\UserName\.openclaw\openclaw.json中，models配置项中的contextWindow默认为4096，要求最小值为16000，需要手动修改，保存即可生效：

bash 复制代码

  "models": {
    "mode": "merge",
    "providers": {
      "custom-api-deepseek-chat": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "sk-f4db943f3ca94477be9706759ee1fe91",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "deepseek-chat (Custom Provider)",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 16000,    //4096修改为16000以上
            "maxTokens": 4096
          }
        ]
      }
    }
  },