一、产品简介
OpenClaw 是开源自托管 AI 网关，可本地部署运行 AI 智能体，支持对接多类聊天渠道、接入主流大模型，并通过技能 / 插件拓展能力。所有数据留存本地，隐私可控、不经过第三方服务器。
- ClawHub：官方技能仓库，类比 Node.js 的 npm，提供海量社区技能；
- 龙虾技能库：ClawHub 国内镜像站，提供镜像加速、中文适配与安全校验，适配国内网络环境。
二、前置系统要求
部署前先核对环境标准，避免安装报错：
表格
| 项目 | 详细要求 |
|---|---|
| Node.js | 最低 22.14+，推荐 24.x LTS 稳定版 |
| 操作系统 | macOS、主流 Linux、Windows（优先使用 WSL2） |
| 磁盘空间 | 预留至少 500MB 空闲空间 |
| 网络 | 全程联网，国内需配置镜像加速提升下载速度 |
检查本地 Node 版本
执行命令查看当前版本：
bash
运行
node --version
若版本不达标，推荐使用 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
三、国内镜像前置配置（必做）
国内网络直接拉取官方源速度慢、易超时，优先配置镜像再执行安装。
1. 配置 npm 淘宝镜像
bash
运行
# 全局切换为淘宝镜像源（永久生效）
npm config set registry shturl.cc/t47EysKanTW6asYr8opC
# 查看当前镜像，确认配置成功
npm config get registry
2. 配置 ClawHub 国内镜像
技能下载、更新专用镜像，解决拉取失败问题：
bash
运行
clawhub config set registry https://cn.clawhub-mirror.com
四、多种安装方式（任选其一）
方式一：一键脚本安装（新手首选，推荐）
全自动检测环境、安装依赖，操作最简单。
macOS / Linux / WSL2
bash
运行
curl -sL https://get.openclaw.ai | bash
Windows 原生 PowerShell
powershell
iwr https://get.openclaw.ai/win | iex
方式二：npm 全局安装（已有 Node 环境）
bash
运行
npm install -g openclaw
方式三：pnpm 安装
bash
运行
pnpm add -g openclaw
方式四：bun 安装
bash
运行
bun add -g openclaw
五、安装校验 & 环境诊断
1. 验证程序是否安装成功
输出版本号即代表安装完成：
bash
运行
openclaw --version
2. 全环境体检（排障必备）
自动检测 Node 版本、依赖、配置文件、目录权限，逐项给出结果与修复建议：
bash
运行
openclaw doctor
所有项显示 ✅ 即为环境正常。
六、首次初始化引导
新装完成后，执行交互式向导完成基础配置：
bash
运行
openclaw onboard
向导依次完成以下配置：
- 选择大模型服务商（国内推荐：通义千问、DeepSeek）
- 填写对应平台 API Key
- 设置智能体基础信息
- 选配聊天对接渠道（可暂时跳过）
七、网关启停 & 可视化面板
1. 启动核心网关 Gateway
bash
运行
openclaw gateway start
2. 访问可视化管理面板
网关启动后，浏览器打开地址，可可视化管理状态、渠道、会话：
plaintext
http://127.0.0.1:18789/
3. 常用网关管理指令
bash
运行
# 查看网关运行状态
openclaw gateway status
# 停止网关服务
openclaw gateway stop
八、新手后续学习路线
部署完成后，建议按顺序上手进阶功能：
- 安装首个自定义技能，熟悉
clawhub技能管理流程 - 对接微信、Telegram 等聊天渠道，实现多端交互
- 精细化配置大模型参数，适配使用场景
- 查阅故障排查文档，提前规避常见问题
九、国内高频问题解答
Q1：下载 / 安装速度极慢？
A：确认已完成上文 npm + ClawHub 双镜像配置，镜像可大幅提速。
Q2：提示权限不足 EACCES？
A：不要使用 sudo npm install -g。优先用 nvm 管理 Node；若不使用 nvm，可修改 npm 全局目录权限。
Q3：安装后终端提示 openclaw: 未找到命令？
A：将 npm 全局目录加入系统环境变量，查看目录路径：
bash
运行
npm bin -g
把输出路径写入系统 PATH 即可。
Q4：Windows 原生环境频繁安装失败？
A：推荐改用 WSL2 子系统，在 WSL2 内按照 Linux 流程安装，兼容性与稳定性更佳。