OpenClaw「龙虾」本地部署指南
OpenClaw（昵称「龙虾」）是一个能驻留在本地电脑上的 AI 智能体，具备读写文件、操控浏览器、自动化办公等能力，甚至可接入 QQ 变身私人机器人。虽然网上存在各类收费服务，但自行安装全程免费且更安全。以下整合官方文档与高频踩坑经验，带你从零完成部署、接入与运维。
前置准备与安全红线
基础硬件与系统要求
| 系统类型 | 最低要求 | 推荐配置 |
|---|---|---|
| Windows | Windows 10 64 位 | Windows 11 64 位，优先使用 WSL2 |
| macOS | macOS 12+ | macOS 14+，M 系列芯片 |
| Linux | 内核 4.15+，1 核 1G 内存 | Ubuntu 22.04 LTS，2 核 2G 内存 |
注意：需保持稳定的网络环境以下载依赖包和调用模型。
核心安全提示
OpenClaw 拥有本地文件读写及系统命令执行权限，请务必遵守以下红线：
- 切勿安装来源不明的第三方技能包，防止恶意代码风险。
- AppID、AppSecret、API Key 等敏感信息严禁泄露或上传至公开仓库。
- 新手建议先在虚拟机、云服务器或备用机上测试，避免误操作影响主力机数据。
- 国内用户务必先配置 npm 国内镜像，否则 90% 的安装失败源于网络超时。
前置环境安装
OpenClaw 基于 Node.js 运行，必须满足 Node 版本 ≥ v22。Windows 用户还需安装 Git。
1. 安装 Node.js 前往官网下载 LTS 长期支持版本（自动附带 npm）。安装时选择默认选项，完成后验证：
node --version
npm --version
输出版本号 ≥ v22 即为成功。
2. Windows 用户必装 Git 下载并安装 Git，验证命令如下：
git --version
3. 配置国内 npm 镜像 直接访问官方源极易超时，建议切换淘宝镜像：
npm config set registry https://registry.npmmirror.com
npm cache clean --force
npm config get registry
全平台安装教程
方案一：一键脚本安装（推荐）
Windows 系统 右键开始菜单选择「Windows PowerShell (管理员)」，执行以下命令：
irm -useb https://openclaw.ai/install.ps1 | iex
等待出现「OpenClaw installed successfully!」提示。
macOS / Linux / WSL2 打开终端执行：
curl -fsSL https://openclaw.ai/install.sh | bash
方案二：手动安装（备用）
若脚本失败，可通过 pnpm 手动安装：
npm install -g pnpm
pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw --version
