## 什么是 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智能体 #龙虾技能库