最近“小龙虾”(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 中:

  1. 右键“此电脑” → 属性 → 高级系统设置 → 环境变量
  2. 在“系统变量”中找到 Path,点击编辑
  3. 新建,粘贴你的 npm 全局路径
  4. 确定保存,重启 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 所有操作日志,出了事能回溯追责

🦞 如何开启龙虾管家?

  1. 下载安装 腾讯电脑管家 最新版(18.0 及以上)
  2. 打开后,在首页找到 “安全” Tab → 点击 “龙虾管家” 入口
  3. 一键开启防护,它会自动识别你电脑上的 OpenClaw

💡 贴心提示:安装 OpenClaw 后,电脑管家会自动弹窗询问是否开启龙虾管家,非常省心 。

✨ 实测亮点:文件保护真的绝

我亲自试了一下它的“文件安全保护”功能:

  1. 在龙虾管家里添加了一个敏感文件夹 D:\私人文件
  2. 让 OpenClaw 去修改里面的内容
  3. 电脑管家瞬间弹窗拦截,提示“越权访问已阻止”

这个逻辑很清晰:给 AI 管家一把钥匙,但别给它保险柜密码。你把大部分权限开放给它干活,但核心隐私区域锁死——这才是正确的安全姿势 。


📝 五、写在最后

回顾整个折腾过程,有几个核心经验分享给大家:

  1. Windows 用户别死磕官方脚本:npm 全局安装更稳定、可控性更高
  2. Node.js 版本必须 ≥22:这是 90% 安装问题的根源
  3. 国内用户一定要换 npm 镜像:不然安装能等到天荒地老
  4. 安全不是小事:强烈建议开启腾讯电脑管家的“龙虾管家”,尤其是文件保护和端口检测功能,百利无一害

OpenClaw 的潜力巨大,但只有部署顺畅 + 安全防护到位,才能放心地让这个“小龙虾”为我们打工。希望这份指南能帮你少踩坑,早日玩转属于自己的 AI 智能体!


Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐