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 OpenClawnpm i-g openclaw# Meet your lobsteropenclaw onboard安装过程中会选择是否本电脑本人使用yes,选择快速安装还是手动配置快速安装QuickStartai大模型需要然后输入对应的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 gatewaystart# 启动网关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 智能体