OpenClaw 简介
OpenClaw 是一个自托管的 AI 网关，能够将微信、Telegram、Discord 等常用通讯软件与 AI 模型连接起来。通过它，你可以实现消息自动回复或在群聊中召唤 AI 助手。
环境准备
硬件要求
| 配置 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS 10.15+ / Linux / Windows WSL2 | macOS 12+ |
| 内存 | 8GB | 16GB+ |
| 存储空间 | 5GB | 20GB+ |
| 网络 | 能访问国际互联网 | 稳定带宽 |
软件依赖
确保系统已安装 Node.js 22 或更高版本。
# 检查当前版本
node --version
若未安装，推荐使用 nvm 管理：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
macOS 用户也可通过 Homebrew 安装：
brew install node@22
安装方式
macOS 原生安装
Mac 用户可直接下载官方 App，体验较为流畅。
# 方法一：Homebrew 安装
brew install openclaw/tap/openclaw
安装后会在菜单栏生成图标。
命令行安装（跨平台）
适用于 Linux、WSL 及 macOS。
# 全局安装 CLI 工具
npm install -g openclaw
# 验证版本
openclaw --version
# 初始化向导
openclaw setup
运行 setup 后会进入交互式引导，按提示选择即可。注意部分渠道（如 Telegram）需提前申请 Bot Token。
Docker 部署（服务器端）
适合生产环境或远程服务器。
# 拉取镜像
docker pull openclaw/openclaw:latest
# 创建配置目录
mkdir -p ~/.openclaw
# 启动容器
docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest
配置详解
配置文件通常位于 ~/.openclaw/openclaw.json。基础结构如下：
{
"gateway": {
"port": 18789,
"verbose": true
},
"channels": {
"telegram": {
"enabled": true,
"botToken": "YOUR_BOT_TOKEN_HERE"
},
"discord": {
"enabled": true,
"botToken": "YOUR_DISCORD_BOT_TOKEN"
}
},
"model": {
"provider": "anthropic",
"model": "claude-sonnet-4-20250514",
"apiKey": "sk-ant-xxx..."
}
}
⚠️ 安全建议：敏感信息（如 API Key）建议使用环境变量注入，避免明文写入配置文件。
渠道接入
Telegram
- 在 Telegram 搜索
@BotFather，发送/newbot创建机器人。 - 设置名称并获取 Token。
- 使用命令更新配置：
openclaw config set channels.telegram.botToken "你的 Token" - 启动网关并在 Telegram 中搜索 Bot 用户名发送
/start配对。
Discord
- 访问 Discord 开发者后台创建新应用。
- 在 Bot 页面添加机器人并复制 Token（开启 Message Content Intent）。
- 通过 OAuth2 URL Generator 生成邀请链接，将 Bot 加入目标服务器。
启动与验证
启动网关服务：
# 前台运行查看日志
openclaw gateway --verbose
# 后台运行
openclaw gateway &
健康检查：
openclaw health
浏览器访问 http://127.0.0.1:18789 可打开控制台界面。
常见问题
端口占用
若报错 Port 18789 already in use，可查询进程或更换端口：
lsof -i :18789
# 或指定端口启动
openclaw gateway --port 18790
Telegram 无响应
检查 Token 是否正确，并确保已在 Telegram 中与 Bot 发起过 /start 对话。
Discord 权限缺失
确认 Bot 权限设置充足，且已在 Developer Portal 中开启必要的 Intents。
注意事项
- 公网部署时务必配置访问密码。
- AI 对话消耗 API Token，请注意费用预算。
- 避免在对话中输入敏感个人信息。
- 定期关注官方 Release 更新以修复安全漏洞。
参考资料
- 官方文档：https://docs.openclaw.ai
- GitHub 仓库：https://github.com/openclaw/openclaw
