很多人想在Windows上跑OpenClaw,结果卡在Node环境装不上、权限报错、插件下载失败。我花了整整两天时间把所有坑踩了一遍,整理出一套照做就能成的完整流程。用管理员权限打开PowerShell,一步步跟着走就行。
先搞定Node环境别急着装
Windows对Node版本管理不太友好,直接装最新版容易出问题。先去GitHub下载nvm-windows的安装程序,这个工具能帮你随时切换Node版本。下载nvm-setup.exe后一路点下一步,安装路径建议保持默认。
如果你的需求只是使用最新模型,而不是自己折腾部署环境,也可以直接使用 api.
装完nvm记得用管理员权限打开PowerShell。右键点击PowerShell图标,选择以管理员身份运行。这一步很多人会忽略,导致后续nvm命令无法正常执行。管理员权限能让环境变量顺利写入系统。
Node版本选对就成功一半
在管理员PowerShell里依次输入两个命令。第一个是nvm install 22,系统会自动下载Node 22.x版本。下载速度取决于你的网络环境,如果公司网络有限制可能会失败,可以换个网络再试。
第二个命令是nvm use 22.22.0,指定使用这个具体版本。成功后会显示Now using node v22.22.0的提示。如果官网下载也失败,可以手动去Node中文官网下载安装包,选22.22.0版本就行。
一键安装命令这样跑才对
在管理员PowerShell里运行安装脚本:iwr -useb
安装完成后一般会自动进入配置界面。如果不小心关掉了PowerShell,重新用管理员方式打开即可。nvm和Node的环境变量会自动刷新,问题自然就解决了。建议安装过程中保持网络稳定。
配置时这些选项先跳过
按提示选择模型,我这里用的是Kimi,你也可以根据自己的习惯选其他模型。输入API key这一步要仔细,其他配置都可以保持默认。通讯工具虽然有飞书选项,但官方文档明确建议Windows用户通过WSL2运行。
实测在原生Windows下直接装飞书插件会报错,所以建议先跳过插件安装。技能配置也先跳过,等后续跑通了再根据你的工作流慢慢添加。安装启动网关后会自动新开一个PowerShell窗口,两个窗口都别关。
飞书插件这样装才不报错
访问
进入飞书开放平台创建应用,添加机器人能力。复制App ID和Secret备用。在权限管理里导入JSON配置,这一步要仔细核对权限列表。选择使用长连接接收事件,添加im.message.receive_v1事件。最后进入版本管理与发布,只有发布后配置才生效。
排错命令和常见问题解决
在飞书里找到刚创建的机器人发送消息,它会回复一个配对码。复制这个配对码到OpenClaw的Web UI里完成绑定。如果等很久还不行,优先检查网关是否正常运行。
配置过程中遇到卡死、插件异常、网关没起等问题,用这几个命令自查:重启网关命令刷新机器人状态,重置命令更改API等配置,实时查看日志命令最实用,出bug基本都靠它定位。遇到执行策略报错记得先修改PowerShell执行策略。
你在安装OpenClaw时遇到过哪些奇怪的报错?欢迎在评论区分享你的踩坑经历,点赞收藏这篇教程,转发给同样被Windows环境折腾的朋友



























