最近 AI Agent（智能体）概念火得一塌糊涂，作为一名 Windows 用户，我终于折腾成功了 OpenClaw（原名 Clawdbot/Moltbot）。
最近 AI Agent（智能体）概念火得一塌糊涂，作为一名 Windows 用户，我终于折腾成功了 OpenClaw（原名 Clawdbot/Moltbot）。这就不是一个简单的聊天机器人，它是一个能帮**作电脑、发 Telegram、写代码、甚至管理日程的 真正的 AI 助理。
虽然官方说安装很简单，但实际操作中我在 Windows 上遇到了不少坑（脚本报错、SSH 权限、Git 缺失等）。为了让大家少走弯路，我把我的完整安装流程和所有报错解决方案整理出来，亲测有效！
一、 准备工作（这一步最重要！）
很多人安装失败就是因为环境没装好。在开始之前，请确保你的 Windows 电脑上安装了以下两个软件：
- Node.js (v20 以上版本)
Node.js夸克网盘链接：https://pan.quark.cn/s/b681d393ac31
- Git for Windows (必须装！)
Git for Windows 夸克网盘链接：https://pan.quark.cn/s/fa2ac2b1b4f6 - 避坑点：OpenClaw 安装时需要从 GitHub 拉取组件，没有 Git 会直接报错。
- 下载安装时，记得勾选 “Git from the command line”，确保在 CMD/PowerShell 里能用。
二、 安装步骤（避开官方脚本坑）
1. 不要用官方的一键脚本！
官方文档里的那个 PowerShell 命令 () 在国内网络环境下极其不稳定，经常会因为抓不到脚本而返回一堆 HTML 代码，导致报错。
推荐方案：直接用 npm 安装 以管理员身份打开 PowerShell（win+r，然后输入cmd），输入：
2. 如果因为网络卡住
如果下载太慢，可以临时挂一下梯子，或者尝试配置 Git 走 HTTPS（见后文排雷指南）。
三、 初始化配置 (Onboarding)
安装完成后，输入以下命令开始“孵化”你的 AI：
这时候你会进入一个全黑客风的 TUI（终端界面），操作非常带感：
选择yes
1.选择模型 (Model)：
-
- 强烈推荐：Qwen (通义千问)。
- 理由：国内直连速度快，甚至不需要梯子；价格极低（新用户送几百万 Token），且 的逻辑能力完全够用。
- 配置方式：选择 -> ，终端会弹出一个链接，浏览器扫码登录阿里云即可，连 API Key 都不用复制，非常丝滑。
2.连接通讯软件 (Telegram)：
-
- 如果你想在手机上控制它，建议连接 Telegram。
- 去 申请一个 Token 填进去。
- 关键点：在 那里，建议填入你的 User ID（纯数字），而不是用户名，这样最稳定。
四、 ⚠️ 血泪踩坑 & 排雷指南 (重点！)
我在安装过程中把能踩的坑全踩了一遍，如果遇到以下报错，照着修就行：
坑位 1：官方脚本报错
报错现场：
原因：网络问题导致下载下来的不是 脚本，而是网站的 HTML 页面。 解决：放弃 命令，直接使用上文提到的 。
坑位 2：SSH 权限报错
报错现场：
原因：npm 试图用 SSH 协议下载依赖包，但你电脑没配 GitHub 的 SSH Key。 解决：强制 Git 走 HTTPS 通道。在终端执行这行命令：
然后重新运行安装命令。
坑位 3：提示
报错现场： 安装明明显示成功，但输入 或 没反应。 原因：
- 包名改了（现在叫 ）。
- npm 的运行路径没加到 Windows 环境变量里。 解决： 最简单的办法是使用 来运行：
或者手动把 npm 的路径（通常在 ）加到系统环境变量 Path 中。
坑位 4：Git 缺失报错 /
报错现场：
原因：电脑里没装 Git，或者装了但没加到环境变量。 解决：去 Git 官网下载安装包，安装时无脑“下一步”，装完后重启终端即可。
坑位 5：Telegram 设置无法解析用户名
报错现场： 在设置 时填入 报错 。 解决： 机器人刚启动时可能无法通过 API 检索用户名。直接找 获取你的一串数字 ID，填数字 ID 绝对不会错。
#AI #OpenClaw #人工智能 #教程 #Windows
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/236127.html