1. Windows下openclaw部署的血泪史
三周前接手一个金融数据分析项目时,第一次听说openclaw这个工具。官方文档只有寥寥几页,GitHub上的issue里堆满了Windows用户的哀嚎。作为团队里唯一的Windows用户,我硬着头皮开始了这场持续72小时的安装拉锯战。现在把完整的踩坑记录和最终验证通过的方案整理出来,特别提醒:所有操作基于Windows 10 21H2版本,Node.js环境建议用14.x或16.x长期支持版。
重要提示:安装过程中会涉及修改系统环境变量和注册表,建议先创建系统还原点
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备:那些文档没告诉你的前置条件
2.1 Node.js版本选择的玄学
官方文档只说"需要Node.js环境",但实测发现:
- Node.js 18+版本会导致openclaw的native模块编译失败
- 12.x版本缺少必要的ES6特性支持
- 最稳定的组合是Node.js 14.21.3 + npm 6.14.18
推荐使用nvm-windows管理多版本:
bash复制nvm install 14.21.3
nvm use 14.21.3
2.2 PowerShell的权限陷阱
以管理员身份运行PowerShell是必须的,但还要额外执行:
powershell复制Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
否则会遇到脚本执行权限错误。更坑的是,某些杀毒软件会拦截PowerShell的模块安装操作,建议临时关闭实时防护。
2.3 被忽视的构建工具链
除了常规的Python和C++构建工具,还需要特别注意:
- Windows SDK版本必须匹配Visual Studio版本
- 需要单独安装Python 3.8(3.9+会有兼容性问题)
- 必须勾选"Desktop development with C++"组件
验证环境是否完备:
bash复制npm config set msvs_version 2019
npm config set python python3.8
3. 完整安装流程:从崩溃到重生的12个步骤
3.1 源码获取的坑点
不要直
