OpenClaw(小龙虾)Windows 避坑安装指南
最近“小龙虾”(OpenClaw)可以说是 AI 圈最火的话题之一,这个能真正执行任务的 AI 智能体让无数人看到了自动化的无限可能。作为一个热衷于折腾各种 AI 工具的开发者,我也第一时间在 Windows 上尝试部署,结果一上来就被泼了冷水——官方 PowerShell 一键脚本直接报错,折腾半天没跑通。
经过一番研究,我发现用 npm 手动安装才是最稳定、最适合 Windows 用户的方案。今天就把这份“避坑指南”分享给大家,顺便聊聊腾讯电脑管家新出的“龙虾管家”——这个专门保护小龙虾安全的工具,真的让我很惊喜!
📌 一、为什么官方脚本会报错?
很多 Windows 用户在运行官方的一键安装命令时:
iwr -useb https://openclaw.ai/install.ps1 | iex
会遇到各种奇怪的问题:
- 执行策略限制(PowerShell 默认禁止脚本运行)
- 网络原因导致安装脚本下载失败或超时
- 自动检测 Node.js 环境失败
- 权限不足导致部分组件安装被拦截
与其和这些报错死磕,不如直接改用 npm 全局安装,步骤清晰、可控性高、成功率 100%。
🛠️ 二、环境准备(保姆级,照着做就行)
1. 安装 Node.js(关键!版本必须对)
OpenClaw 要求 Node.js 版本 ≥ 22,版本不对会导致 EBADENGINE 报错 。
- 下载地址:Node.js 官网
- 选择 LTS 版本(推荐 22.x 或更高),Windows 64 位安装包
- 安装时务必勾选 “Add to PATH”(自动添加到系统环境变量)
验证安装:
node -v # 应显示 v22.x.x 或更高
npm -v # 显示 npm 版本号
💡 小贴士:如果你之前装过低版本 Node,可以用
nvm for Windows来管理多版本 Node 。
2. 配置 npm 镜像 一般情况不需要安装
3. 安装 Git(可选但建议)
部分插件和 Skills 的安装需要 Git 支持 。
- 下载地址:Git 官网
- 安装时保持默认选项,确保 “Add Git to PATH” 被勾选
🦞 三、npm 安装 OpenClaw(稳定方案)
步骤 1:全局安装
以管理员身份打开 PowerShell(重要!),执行:
# Install OpenClaw
npm i -g openclaw
# Meet your lobster
openclaw onboard
安装过程中,会选择,是否本电脑本人使用(yes),选择快速安装还是手动配置(快速安装QuickStart),ai大模型需要,然后输入对应的key,默认模型(不用修改),选择插件(跳过,Skills ,大概多次都跳过就好),选择UI(选择webui)
安装完成后会返回网页地址
问题 1:解决 openclaw: command not found 问题
有时安装成功了,但输入 openclaw 提示找不到命令。这是 npm 全局 bin 目录不在 PATH 里导致的 。
解决方案:
# 找到 npm 全局路径
npm prefix -g
然后把输出的路径(例如 C:\Users\你的用户名\AppData\Roaming\npm)添加到系统环境变量 Path 中:
- 右键“此电脑” → 属性 → 高级系统设置 → 环境变量
- 在“系统变量”中找到
Path,点击编辑 - 新建,粘贴你的 npm 全局路径
- 确定保存,重启 PowerShell
验证:
openclaw --version # 有输出就 OK 了
问题 2:初始化配置向导
openclaw onboard
根据提示完成配置:
- 选择 QuickStart 快速模式
- 选择你喜欢的 AI 模型(推荐 Kimi / OpenAI / Anthropic)
- 输入 API Key(去对应平台申请)
- 聊天载体建议先选
tui(终端交互),方便测试 - Skills 可以暂时跳过,后续按需添加
问题 3:配置ws网关、
有时候ws打不开,所以需要重新配置
openclaw config
选择local,选择Gateway,端口默认,选择lan,选择密码登录,选择关闭off,设置密码,选择configure;
找到controlUi,在里面添加两行代码
"dangerouslyAllowHostHeaderOriginFallback": true,
"dangerouslyDisableDeviceAuth":true,
案例
"controlUi": {
"dangerouslyAllowHostHeaderOriginFallback": true,
"dangerouslyDisableDeviceAuth":true,
"allowInsecureAuth": true
},
重启,
根据提示完成配置:
- 选择 QuickStart 快速模式
- 选择你喜欢的 AI 模型(推荐 Kimi / OpenAI / Anthropic)
- 输入 API Key(去对应平台申请)
- 聊天载体建议先选
tui(终端交互),方便测试 - Skills 可以暂时跳过,后续按需添加
配置完成后会自动启动 Gateway,浏览器会打开控制台页面http://127.0.0.1:18789/。
步骤 4:常用命令速查
openclaw gateway start # 启动网关
openclaw gateway status # 查看状态
openclaw logs --follow # 查看实时日志(排查问题神器)
openclaw doctor # 诊断并自动修复常见问题
openclaw dashboard # 打开控制面板
🛡️ 四、腾讯“龙虾管家”:给小龙虾加把安全锁
OpenClaw 的能力很强大——它能读取文件、执行脚本、访问系统资源。但能力越强,风险越大:一旦被恶意劫持,你的浏览器、本地文件、隐私数据都可能面临泄露风险 。
最近腾讯电脑管家推出了 18.0 版本,首发了一个叫 “龙虾管家” 的 AI 安全沙箱功能,专门为 OpenClaw 这类智能体设计,体验下来真的很香。
🔒 龙虾管家的核心能力
| 防护维度 | 具体功能 |
|---|---|
| Skills 安全检测 | 安装 Skills 时自动扫描,发现恶意 Skills 立即拦截 |
| 文件安全保护 | 自定义敏感文件夹(如证件、银行流水),禁止 AI 访问/修改 |
| 系统安全防护 | 保护注册表、系统关键文件,防止越权操作 |
| 端口暴露检测 | 一键扫描公网端口,防止你的小龙虾变成“肉鸡” |
| 全流程行为审计 | 记录 AI 所有操作日志,出了事能回溯追责 |
🦞 如何开启龙虾管家?
- 下载安装 腾讯电脑管家 最新版(18.0 及以上)
- 打开后,在首页找到 “安全” Tab → 点击 “龙虾管家” 入口
- 一键开启防护,它会自动识别你电脑上的 OpenClaw
💡 贴心提示:安装 OpenClaw 后,电脑管家会自动弹窗询问是否开启龙虾管家,非常省心 。
✨ 实测亮点:文件保护真的绝
我亲自试了一下它的“文件安全保护”功能:
- 在龙虾管家里添加了一个敏感文件夹
D:\私人文件 - 让 OpenClaw 去修改里面的内容
- 电脑管家瞬间弹窗拦截,提示“越权访问已阻止”
这个逻辑很清晰:给 AI 管家一把钥匙,但别给它保险柜密码。你把大部分权限开放给它干活,但核心隐私区域锁死——这才是正确的安全姿势 。
📝 五、写在最后
回顾整个折腾过程,有几个核心经验分享给大家:
- Windows 用户别死磕官方脚本:npm 全局安装更稳定、可控性更高
- Node.js 版本必须 ≥22:这是 90% 安装问题的根源
- 国内用户一定要换 npm 镜像:不然安装能等到天荒地老
- 安全不是小事:强烈建议开启腾讯电脑管家的“龙虾管家”,尤其是文件保护和端口检测功能,百利无一害
OpenClaw 的潜力巨大,但只有部署顺畅 + 安全防护到位,才能放心地让这个“小龙虾”为我们打工。希望这份指南能帮你少踩坑,早日玩转属于自己的 AI 智能体!
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐



所有评论(0)