Windows环境安装Openclaw踩坑

2026-05-05阅读 0热度 0

windows

在Windows上从源码安装OpenClaw？这几个坑你得先避开

照着OpenClaw官方文档的步骤，在Windows系统上从源码安装，理论上是个清晰的过程。但实际操作起来，你可能会碰到一些官方文档里没细说的“拦路虎”。下面就把我踩过的几个关键坑和解决方案梳理出来，帮你一次性跑通。

第一，务必使用管理员权限的Powershell

这不是建议，而是必须。很多涉及系统级目录创建或写入的操作，没有管理员权限会直接报错，第一步就可能卡住。

第二，注意Node版本需≥22

版本要求是硬性指标。如果你的Node版本低于22，后续的依赖安装和构建步骤几乎百分之百会出问题。安装前先用 node -v 确认一下。

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

这是Windows环境下比较典型的一个问题。解决方法是修改源码中的一个文件。

找到 \openclaw\scripts\ui.js 文件，定位到如下函数：

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);
});
}

将其修改为（关键是添加 shell: true 选项）：

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命令。根本原因在于，构建脚本中可能调用了某些类Unix的命令。最简单的解决方案，就是把bash的路径添加到Windows的PATH环境变量中（如果你安装了Git for Windows或WSL，其自带的bash通常就在对应目录下）。

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

这一点容易忽略。在项目目录下，直接运行 openclaw onboard --install-daemon 可能会命令未找到。正确的姿势是使用 pnpm openclaw onboard --install-daemon，通过pnpm来执行项目本地的命令行工具。

第六，安装一切顺利，但使用时chat不回复

这个问题最隐蔽，也最让人头疼。界面正常，但发送消息后没有反应。问题通常出在配置文件的一个关键参数上。

打开配置文件 C:\Users\你的用户名\.openclaw\openclaw.json，找到 models 配置项。里面每个模型定义都有一个 contextWindow 参数，它的默认值可能是4096。

问题就在这里：某些模型（如你配置的DeepSeek）要求这个值必须达到一个最低阈值，比如16000。将这个值从默认的4096修改为16000或更高，保存配置文件后重启应用，通常就能立刻生效。

"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
}]
}
},
}

以上这六个点，都是在真实安装过程中可能遇到的实际障碍。逐一 check 并解决，就能大大提升在Windows上成功部署OpenClaw源码版的概率。