Windows系统下顺利安装并运行OpenClaw
- 2026-03-07 20:36:00
- gmpfan
- 转贴 626
要在Windows系统下顺利安装并运行OpenClaw，需遵循
环境准备→安装配置→验证运行的流程，并注意规避常见的权限、网络及环境冲突问题。以下是
2026年3月最新的完整安装指南（整合CSDN、阿里云开发者社区等权威来源）：
一、核心前提：环境准备
很多人安装OpenClaw失败，90%是环境没配好，先把基础环境搭稳，后面一路绿灯。
系统与硬件要求
系统：Windows 10 21H2及以上、Windows 11（必须支持WSL2，官方原生推荐WSL2运行，兼容性最好）
硬件：内存≥8GB（推荐16GB，本地跑模型更流畅），硬盘剩余空间≥20GB，CPU支持虚拟化（BIOS里开启，默认大多是开启的）
网络：能正常访问GitHub、npm官方源，不用特殊工具，普通网络即可
OpenClaw的运行依赖 Node.js、 Git及 Python/FFmpeg（部分功能需要），需提前安装并配置：
1. 安装Node.js（≥v18.0.0，推荐v20 LTS或v22）
- 下载地址：
- 验证安装：打开 管理员PowerShell，运行node -v，输出v18.x.x或更高版本即为成功。
- 注意：若已安装旧版本，需升级至v18+（可通过nvm工具管理多版本，如nvm install 20 && nvm use 20）。
2. 安装Git（用于技能依赖下载）
- 方式1（推荐）：通过winget（Windows包管理器）安装：打开管理员PowerShell，运行winget install git.git。
- 方式2：手动下载安装包：
- 验证安装：运行git --version，输出git version 2.x.x即为成功。
3. （可选）安装Python 3.9+与FFmpeg（部分技能需要）
- Python：用于运行video-frames等技能，下载地址：
FFmpeg：用于音视频处理，下载地址：
https://blog.csdn.net/jiangjunshow/article/details/157876339
https://www.cnblogs.com/lrzy/p/19676806
二、安装OpenClaw
Windows下推荐
手动npm安装（避免网络问题，便于排查），步骤如下：
1. 设置npm镜像源（加速国内下载）
打开管理员PowerShell，运行：
2. 全局安装OpenClaw
运行以下命令安装最新版本：
- 验证安装：运行openclaw --version，输出3.x.x（如3.1.0）即为成功。
- 若安装失败：
- 检查Node.js版本是否符合要求（≥v18）；
- 清除npm缓存：npm cache clean --force，重新安装；
- 以管理员身份运行PowerShell（避免权限不足）。
三、初始化配置
安装完成后，需通过
初始化向导配置OpenClaw的基本参数（如模型、通道、技能）：
1. 启动初始化向导
运行以下命令：
- 风险提示：首次启动会提示“I understand this is powerful and inherently risky. Continue?”，选择“Yes”。
2. 配置模型（以Kimi为例）
- 选择“QuickStart”（快速部署），随后按提示选择模型（如“Kimi-K2.5”）。
- 输入 模型API Key（如模力方舟或Kimi的API Key），其他参数默认即可。
3. 配置通道（可选，后续可补充）
- 若需接入飞书、Discord等通道，可在初始化时选择“Configure Channels”，按提示填写App ID、Secret等信息；
- 若暂时不需要，可选择“Skip for now”（后续通过openclaw plugins install命令安装插件）。
4. 启动网关
初始化完成后，运行以下命令启动OpenClaw网关（后台服务）：
- 验证网关状态：运行openclaw gateway status，输出“Gateway is running”即为成功。
四、验证安装
打开浏览器，访问http://127.0.0.1:18789/（本地网关地址），若能看到OpenClaw的控制台界面，且发送消息后能收到回复，说明安装成功。
五、常见问题排查
1. 权限错误（EACCES）
- 原因：全局安装时权限不足。
- 解决：
- 以管理员身份运行PowerShell；
- 或修改npm全局目录权限：mkdir ~/.npm-global && npm config set prefix '~/.npm-global'，并将~/.npm-global/bin添加到PATH（通过$PROFILE文件）。
2. openclaw: command not found
- 原因：npm全局bin目录未加入PATH。
- 解决：
- 运行npm bin -g，获取全局bin路径（如C:\Users\<用户名>\AppData\Roaming\npm）；
- 将该路径添加到系统环境变量（通过“控制面板→系统→高级系统设置→环境变量→用户变量→Path”）。
3. 网关启动失败（unauthorized: gateway token mismatch）
- 原因：配置文件中的gateway.auth.token与服务端不一致。
- 解决：
- 查看当前服务token：echo $env:OPENCLAW_GATEWAY_TOKEN（PowerShell）；
- 更新配置文件openclaw.json（位于C:\Users\<用户名>\.openclaw\`）中的gateway.auth.token`为上述值；
- 重启网关：openclaw gateway restart。
4. 网络问题（无法下载技能或模型）
- 原因：国内网络访问境外资源受限。
- 解决：
- 使用npm镜像源（已设置）；
- 手动下载技能ZIP包（如从GitHub），解压至`C:\Users<用户名>.openclaw\skills`目录；
- 配置代理（如git config --global http.proxy http://127.0.0.1:7890）。
六、（可选）接入飞书机器人
若需将OpenClaw接入飞书，实现“飞书发指令，AI做执行”的闭环，可参考以下步骤（详细指南见）：
1. 安装飞书插件
运行以下命令安装飞书适配插件：
2. 配置飞书开放平台
- 进入
- 复制App ID和App Secret，填入OpenClaw控制台的“飞书配置”页面；
- 批量导入权限（如im:message:send_as_bot、im:chat.members:bot_access等），并订阅im.message.receive_v1事件。
3. 发布版本并绑定
- 发布飞书应用版本，随后在飞书机器人聊天窗口获取配对码；
- 将配对码发送至OpenClaw控制台，完成绑定。
总结
Windows下安装OpenClaw的核心是
正确配置环境（Node.js、Git）、
选择合适的安装方式（手动npm）、
仔细完成初始化配置。若遇到问题，可通过openclaw doctor（诊断工具）或查看日志（openclaw logs --follow）排查。
如需更详细的飞书接入或其他通道配置，可参考阿里云开发者社区的
相关视频
活到老，学到老。
友情链接
