OpenClaw 完整安装教程

从零开始，一步步搭建你的 AI Agent。

环境要求

• Linux 服务器（Ubuntu 22.04+ 推荐）或 macOS
• Node.js v22+
• 至少 2GB 内存

第一步：安装 Node.js

推荐使用 nvm 管理 Node.js 版本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
node -v  # 确认 v22.x

第二步：安装 OpenClaw

npm install -g openclaw
openclaw --version  # 确认安装成功

第三步：初始化配置

openclaw init

交互式向导会引导你完成：
- 选择 AI 模型提供商（Anthropic / OpenAI / 自定义代理）
- 填入 API Key
- 选择消息平台（飞书 / Telegram / Discord 等）
- 设置工作区目录

也可以跳过向导，手动编辑配置文件：

nano ~/.openclaw/openclaw.json

第四步：安装 ClawHub CLI

ClawHub 是 OpenClaw 的技能市场：

npm install -g clawhub

第五步：安装基础技能

# 安全审查（建议第一个装）
clawhub install skill-vetter

# 自我进化（让 Agent 越用越聪明）
clawhub install self-improving

# 内容摘要
clawhub install summarize

# 技能搜索
clawhub install find-skills

第六步：启动网关

openclaw gateway start

检查状态：

openclaw status

查看日志：

openclaw logs --follow

第七步：连接消息平台

飞书

1. 在飞书开放平台创建企业自建应用
2. 获取 App ID 和 App Secret
3. 配置事件订阅回调地址：http://你的服务器IP:18789/webhooks/feishu/main
4. 在 config.json 中填入凭证（参考配置文件教程）

Telegram

1. 找 @BotFather 创建 Bot
2. 获取 Bot Token
3. 运行 openclaw init 选择 Telegram 配置

Discord

1. 在 Discord Developer Portal 创建应用
2. 创建 Bot 并获取 Token
3. 配置 OAuth2 权限并邀请到服务器

常见问题

Q: 启动报错 "port already in use"

# 查看占用端口的进程
ss -tlnp | grep 18789
# 杀掉或换端口

Q: Agent 不回复消息

1. 检查 openclaw status 是否正常
2. 检查 openclaw logs 有无报错
3. 确认 API Key 有效
4. 确认消息平台的 Webhook 配置正确

Q: 如何更新 OpenClaw

npm update -g openclaw
openclaw gateway restart

Q: 如何备份配置

cp -r ~/.openclaw ~/.openclaw.backup
cp -r /workspace /workspace.backup

有问题欢迎回帖讨论！