最近在折腾OpenClaw,发现这玩意儿装起来还真不是点两下"下一步"就完事的。踩了不少坑,也终于跑通了。想着肯定还有很多人跟之前的我一样,对着满屏命令行发愁,干脆写个完整教程,手把手带你从零装好。
本文适用对象:
Windows 10/11用户 想本地部署AI助手、配置大模型的 有一定动手能力,不是纯小白
环境要求:
Windows 10 及以上(64位) 至少8GB内存(16GB更佳) 20GB以上硬盘空间 Node.js 18或更高版本 网络通畅(访问GitHub/Moonshot等)
一、Node.js安装
OpenClaw基于Node.js运行,必须先装好这个环境。
第一步:下载Node.js
打开浏览器,访问 Node.js官网:https://nodejs.org/
看到首页的大按钮,点击"LTS"版本(长期支持版,更稳定)。Windows用户下载.msi安装包,大约30MB左右。
第二步:安装
下载完成后双击运行,一路点"Next"就行。装在哪?默认C盘,不用改。
第三步:验证
按Win+R,输入cmd,回车。弹出黑色命令行窗口,输入:
Copy
node -v
npm -v
看到版本号(比如v20.x.x和10.x.x)就说明装好了。
二、OpenClaw安装
**第一步:安装OpenClaw
打开命令行,输入:
Copy
npm install -g openclaw
等待安装完成。大概需要1-3分钟,取决于网速。
**第二步:启动引导
安装完成后,直接输入:
Copy
openclaw start
新版本会弹出可视化引导界面(TUI),不再是纯命令行。界面顶部有黄色警告横幅,提示安全注意事项,记得认真看。中间是安装步骤清单,逐项打勾。
第三步:首次配置
引导界面会提示你:
选择安装模式(首次安装选"全新安装") 设置工作目录(建议默认) 配置管理员密码
三、大模型配置
这是最关键的一步。OpenClaw支持多个大模型提供商,国内用户推荐用MiniMax或Moonshot(Kimi),速度快,稳定性好。
方法一:MiniMax配置
访问 MiniMax开放平台:https://www.minimaxi.com/ 注册账号并实名认证 创建API Key(个人中心→API Keys→新建) 复制API Key
然后在OpenClaw配置文件中填写:
方法二:Moonshot(Kimi)配置
访问 Moonshot控制台:https://platform.moonshot.cn/ 注册并认证 创建API Key 配置格式相同,只是provider name换成
。moonshot新版v2026.4.20变化:
默认集成Moonshot,新用户开箱即用 支持模型分级定价,用多少花多少 Token用量报告更详细
四、飞书频道配置
OpenClaw可以接入飞书,实现机器人自动回复。
第一步:创建飞书应用
打开 飞书开放平台:https://open.feishu.cn/ 点击"创建应用" 填写应用名称和描述 获取App ID和App Secret
第二步:配置权限
在应用权限管理中,添加以下权限:
接收消息 发送消息 获取群信息
第三步:配置机器人
在OpenClaw配置文件中添加:
第四步:启动
Copy
openclaw channel add feishu
按提示完成验证,即可使用。
五、微信接入(可选)
如果想接入微信,需要使用wechaty或类似方案。OpenClaw v2026.4.20优化了微信消息处理流程,稳定性提升。
注意:微信对机器人有限制,建议先测试再正式使用。
六、常见问题排查
Q:安装时报错"permission denied"
以管理员身份运行命令行:
Copy
右击命令提示符 → 更多 → 以管理员身份运行
Q:模型调用返回401错误
检查API Key是否正确,确认余额是否充足。
Q:飞书机器人没有反应
检查应用权限是否开通,机器人是否已添加到群聊。
Q:启动后显示"waiting for gateway"
等待几秒钟,首次启动需要加载模型。如果长时间无响应,输入openclaw status查看状态。
七、结尾
OpenClaw装起来其实不算难,就是中间环节多,需要耐心配置。新版v2026.4.20在安装体验上改进了不少,向导更清晰,对新手更友好。
配置好之后,你就能拥有自己的本地AI助手,接入微信、飞书等多个平台,还是挺香的。
有问题欢迎留言,看到会回。
夜雨聆风