OpenClaw 是什么？
一句话说明：OpenClaw 是一个可部署在本地或服务器上的开源 AI Agent 框架，具备 Gateway（通信）、Dashboard（控制台）和 Skills（能力插件）三大核心模块。
| 对比项 | 普通 AI 工具 | OpenClaw |
|---|---|---|
| 运行位置 | 云端 | 本地 / VPS |
| 权限 | 受限 | 可控高权限 |
| 持久运行 | 否 | 是 |
| 自动执行 | 弱 | 强 |
| 可二开 | 几乎不可 | 完全可 |
OpenClaw 不是'聊天机器人'，而是一个真正意义上的 AI 执行体。
为什么一定要'认真搭'？
OpenClaw 具备的能力包括但不限于：
- 读写本地文件
- 调用系统命令
- 请求外部 API
- 长时间后台运行
- 通过 Gateway 接入 Telegram / Discord 等
这意味着它是'高权限 Agent'。不建议直接装在日常办公电脑，强烈建议使用独立 VPS、Docker 或隔离环境。
部署环境选择
推荐配置（实战可用）
- 系统：Ubuntu 20.04 / 22.04
- CPU：2 核起步（4 核更稳）
- 内存：4GB 起步（8GB 更舒服）
- 用途：只跑 OpenClaw，不混别的服务
Linux 更专业、稳定、通用。
基础环境准备
1. 更新系统 & 基础工具
sudo apt update
sudo apt install -y git curl unzip
2. 安装 Node.js（OpenClaw 必需）
官方要求 Node 18+，推荐用 nvm：
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18
验证：
node -v
npm -v
3. 安装 pnpm
源码部署 & 二开基本都用它：
npm install -g pnpm
安装 OpenClaw
方式一：CLI 全局安装（最快）
适合想快速跑起来且不改源码的用户。
npm install -g openclaw
验证：
openclaw --version
看到版本号，说明 CLI 安装成功。
方式二：源码部署（专业玩家 / 二开）
适合想改 UI、接自己系统或写自定义 skills 的用户。
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
Onboard 初始化
OpenClaw 不是装完就能用，必须执行 onboarding。
CLI 安装方式：
openclaw onboard --install-daemon
源码方式：
pnpm openclaw onboard --install-daemon
这个步骤会做几件事：
- 初始化 Gateway
- 生成本地配置
- 注册运行服务（daemon）
- 绑定 Dashboard
- 创建 Agent 身份
90% 的问题都发生在'没正确 onboard'。
检查 Gateway 是否正常运行
openclaw gateway status
正常情况下你会看到 running、healthy、listening on port xxx。如果不是，直接看日志：
openclaw gateway logs
启动 Dashboard
openclaw dashboard
你将看到 Agent 状态、会话记录、Skills 管理、Gateway 连接情况、系统日志。
Skills（能力插件）怎么理解？
你可以把 Skills 理解成 AI 能调用的'函数 + 权限集合'。
比如：
- 查询区块链数据
- 调用内部 API
- 执行脚本
- 发送 Telegram 消息
- 读取服务器状态
新手建议顺序：
- 只读类 skills
- 通知 / 查询类
- 再考虑执行型
不要一上来给它 root 权限。
常见问题排查
- Gateway 起不来：Node 版本不对、端口被占用、没 onboard 完。
- Dashboard 打不开：防火墙没放端口、服务器没映射、服务未运行。
- Skill 不生效：权限没授权、配置未 reload、写法不符合 schema。
- Agent 行为不可控：skills 权限过大、prompt 未限制、没做沙箱。
- 一直报错但不知道为什么：不看 gateway logs、不看 dashboard logs。
- 直接装在生产服务器：这是最危险的。
验收标准
满足以下 5 条，即可视为搭建成功： ✅ CLI 正常 ✅ Gateway running ✅ Dashboard 可访问 ✅ 能启用至少 1 个 skill ✅ Agent 能完成一次完整任务
