什么是 OpenClaw？
OpenClaw 是一个开源的自托管 AI Gateway（网关），让你在自己的设备上运行 AI 智能体。它可以连接多种聊天渠道（WhatsApp、Telegram、微信等），管理 AI 模型，并通过技能和插件扩展智能体的能力。 简单来说，OpenClaw 就是你的私人 AI 管家——你拥有完全的控制权，数据不经过第三方服务器。 ClawHub 是 OpenClaw 的官方技能注册中心，类似 npm 之于 Node.js，托管了数千个社区贡献的技能。龙虾技能库是 ClawHub 的国内中文版，提供中文翻译、安全检测和镜像加速。系统要求
在安装之前，请确认你的系统满足以下要求： | 要求 | 说明 | |------|------| | Node.js | 推荐 Node 24（最新 LTS），最低要求 Node 22.14+ | | 操作系统 | macOS、Linux、Windows（推荐 WSL2） | | 磁盘空间 | 至少 500MB 可用空间 | | 网络 | 需要联网下载依赖和技能 | 检查你的 Node.js 版本： ``bash
node --version
`
如果版本低于 22.14，请先升级 Node.js。推荐使用 nvm 管理 Node 版本：
`bash
安装 nvm（如果还没有）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
安装并使用 Node 24
nvm install 24
nvm use 24
`
安装 OpenClaw
OpenClaw 提供多种安装方式，选择最适合你的一种。
方式一：一键安装脚本（推荐）
最简单的安装方式，一条命令搞定：
macOS / Linux：
`bash
curl -sL https://get.openclaw.ai | bash
`
Windows（PowerShell）：
`powershell
iwr https://get.openclaw.ai/win | iex
`
安装脚本会自动检测系统环境、安装依赖并完成配置。
方式二：npm 安装
如果你已经有 Node.js 环境，可以直接用 npm 安装：
`bash
npm install -g openclaw
`
方式三：pnpm 安装
`bash
pnpm add -g openclaw
`
方式四：bun 安装
`bash
bun add -g openclaw
`
国内镜像加速
国内用户安装时可能遇到下载速度慢的问题，建议配置镜像加速：
`bash
npm 使用淘宝镜像安装
npm install -g openclaw --registry https://registry.npmmirror.com
或者全局配置淘宝镜像
npm config set registry https://registry.npmmirror.com
`
配置 ClawHub 镜像源加速技能下载：
`bash
clawhub config set registry https://cn.clawhub-mirror.com
`
验证安装
安装完成后，运行以下命令验证：
`bash
查看版本号
openclaw --version
`
如果正确显示版本号（如 v1.x.x），说明安装成功。
运行诊断工具检查环境是否完整：
`bash
openclaw doctor
`
openclaw doctor 会检查 Node.js 版本、依赖完整性、配置文件等，并给出修复建议。如果所有检查项都显示 ✅，说明环境没有问题。
初始化配置
首次安装后，运行引导向导完成初始配置：
`bash
openclaw onboard
`
引导向导会帮你完成：
- 选择 AI 模型提供商（推荐国内用户选择通义千问或 DeepSeek）
- 配置 API Key
- 设置智能体基本信息
- 选择聊天渠道
启动 Gateway
配置完成后，启动 OpenClaw Gateway 网关：
`bash
openclaw gateway start
`
Gateway 启动后，你可以通过浏览器访问仪表板：
`
http://127.0.0.1:18789/
`
仪表板提供了可视化的管理界面，你可以在这里查看智能体状态、管理渠道连接、查看会话记录等。
检查 Gateway 状态
`bash
openclaw gateway status
`
停止 Gateway
`bash
openclaw gateway stop
`
下一步
安装完成后，推荐按以下顺序继续学习：
1. 安装第一个技能：阅读《安装你的第一个技能》教程，体验技能安装流程
2. 连接聊天渠道：阅读《聊天渠道连接教程》，将智能体连接到你常用的聊天应用
3. 配置模型：阅读《模型提供商配置教程》，选择适合你的 AI 模型
4. 遇到问题：查看《常见问题与故障排查》教程
常见问题
Q: 安装速度很慢怎么办？
A: 确保已配置国内镜像源，参考上方"国内镜像加速"章节。
Q: 提示权限不足（EACCES）？
A: 避免使用 sudo npm install -g，推荐使用 nvm 管理 Node.js，或修改 npm 全局目录权限。
Q: 安装后命令找不到？
A: 检查 PATH 环境变量是否包含 npm 全局 bin 目录。运行 npm bin -g` 查看路径，确保它在你的 PATH 中。
Q: Windows 上安装失败？
A: 推荐使用 WSL2（Windows Subsystem for Linux），在 WSL2 中按 Linux 方式安装，体验更好。
#OpenClaw安装 #国内安装教程 #Gateway网关 #AI智能体 #龙虾技能库