经过反复的折腾，我终于在Windows上成功跑通了OpenClaw。这期间遇到了无数个坑：WSL网络不通、端口转发失败、GitHub Models地址错误、模型ID不识别、技能无法调用、网关假死……/(ㄒoㄒ)/~~
现在把完整的安装配置流程和踩过的坑都整理出来，按照这个顺序操作，你应该能一次成功。
1.1 安装Node.js（必选）
为什么选Node.js？ OpenClaw基于Node.js运行，必须装。
访问 Node.js官网 https://nodejs.org/
下载 22.x LTS版本（不要下载最新版，LTS最稳）
安装时注意：
✅ 安装路径改为 D:NodeJs（避免C盘爆满）
✅ 勾选“自动安装必要工具”
✅ 勾选“添加到PATH”
安装完成后，打开PowerShell验证：
GPT plus 代充 只需 145
1.2 配置PowerShell执行策略（必选）
如果遇到 无法加载文件 npm.ps1 的报错：
1.3 设置npm全局路径到D盘（推荐，避免C盘爆满）
GPT plus 代充 只需 145
GPT plus 代充 只需 145
重启PowerShell使配置生效
2.1 全局安装OpenClaw
预期结果：
GPT plus 代充 只需 145
如果报错：
- EACCES 权限错误 → 用管理员身份运行
- 网络超时 → 切换网络或使用代理
2.2 验证安装
3.1 运行配置向导
GPT plus 代充 只需 145
3.2 配置模型提供商（我选的是智谱，完全免费可替换自己的ai key）
- 当问到 Model/auth provider 时：
- 选择 Custom Provider（自定义提供商）
- API Base URL：输入 https://open.bigmodel.cn/api/paas/v4
- API Key：输入你的智谱API Key（获取方式见第四章）
- Endpoint compatibility：选择 OpenAI-compatible
- Model ID：输入 glm-5
- 注意： 智谱的模型ID就是 glm-5，不要加任何前缀后缀。
3.3 完成向导
- 通讯渠道 → Skip for now（先不配）
- 技能配置 → No（稍后手动装）
- 最后选择 → Restart（重启网关）
4.1 注册账号
- 访问 智谱开放平台 https://bigmodel.cn/
- 手机号注册登录
- 新用户自动获得 2000万tokens免费额度
4.2 创建API Key
- 登录后进入控制台
- 左侧菜单找到 “API密钥”
- 点击 “新建API密钥”
- 输入名称（比如 "openclaw"）
- 复制生成的Key（格式：一串数字.字母）
5.1 安装ClawHub（技能商店）
5.2 安装file-manager技能
GPT plus 代充 只需 145
5.3 验证技能安装
6.1 编辑配置文件
GPT plus 代充 只需 145
6.2 替换为完整配置
GPT plus 代充 只需 145
7.1 打开控制面板
GPT plus 代充 只需 145
7.2 登录
使用配置文件中的Token登录（可在配置文件中查看 gateway.auth.token）
7.3 测试指令
在聊天界面输入：
坑1：C盘爆满 症状： 安装到一半提示磁盘空间不足
原因： npm默认安装到C盘，OpenClaw依赖多
解决： 提前配置npm路径到D盘
GPT plus 代充 只需 145
坑2：PowerShell禁止运行脚本
解决：
坑3：在WSL里折腾
症状：WSL的IP地址每次重启都变
Windows浏览器访问不了WSL的127.0.0.1
端口转发规则各种失灵
教训： 不要用WSL！直接Windows原生安装，省去99%的网络问题。
坑4：GitHub Models地址错误
错误地址：
坑5：模型ID不识别
错误格式：
deepseek-v3-0324 ❌
glm-4.7-flash ❌
正确格式：
deepseek/deepseek-v3-0324 ✅
glm-5 ✅
坑6：Token权限不足
症状： 返回401 Unauthorized
解决： 生成GitHub Token时必须勾选 read:models 权限
坑7：以为免费就是永久免费
真相： 硅基流动的免费额度用完后会收费，我0.07元账单就是例子
教训： 用智谱GLM-5，明确标注“免费调用”
坑8：端口被占用
症状： 网关启动超时，端口18789被占用
排查：
GPT plus 代充 只需 145
解决：
坑9：网关假死
症状：
Runtime: unknownRPC probe: ok（诡异吧？類）端口没监听
解决：
GPT plus 代充 只需 145
坑10：技能显示ready但用不了
症状：
原因1： profile 设置不对
GPT plus 代充 只需 145
原因2： 技能需要刷新
在聊天界面发送：
原因3： 问问题的方式不对
GPT plus 代充 只需 145
坑11：不认识的配置项
症状：
原因： 新版OpenClaw不支持直接配置filesystem，要通过file-manager技能实现
解决： 删除不认识的配置，用技能替代
坑12：配置文件语法错误
症状： 网关启动失败，提示JSON解析错误
常见错误：缺少逗号、多了一个逗号、引号不匹配
解决： 用JSON验证工具检查格式
第七章：网络穿透的坑
坑13：ngrok免费域名不被企业微信信任
症状： 企业微信提示“域名主体校验未通过”
原因： 已认证的企业微信必须用备案域名，IP和ngrok域名都不行
解决：
- 用未认证的企业微信小号测试（不需要备案）
- 或者购买已备案域名
坑14：重启后配置丢失
原因： 忘记保存配置文件
教训： 每次改配置前备份
GPT plus 代充 只需 145
坑15：日志不会看
症状： 遇到问题不知道从哪查起
正确姿势：
GPT plus 代充 只需 145
从WSL到Windows，从GitHub Models到智谱，从403到200，这一路踩了无数坑。希望这篇文档能帮你一次性成功，不用像我一样折腾几天几夜。
最后的忠告：
- 不要用WSL，直接Windows原生安装
- 不要用GitHub Models，用智谱GLM-5（完全免费）
- 配置文件备份，每次改配置前先备份
- 先看日志再问问题，openclaw logs –follow 是最好的老师
祝你一次成功！🎉
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/236886.html