OpenClaw 安装部署全流程
OpenClaw 是一个自托管的 AI 网关，能够将微信、Telegram、Discord、iMessage 等常用聊天软件与 AI 助手连接起来。通过它，你可以在微信上发消息获得自动回复，在 Discord 群里 @AI 参与讨论，或者随时召唤你的私人 AI。
环境准备
硬件要求
| 配置 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS 10.15+ / Linux / Windows WSL2 | macOS 12+ |
| 内存 | 8GB | 16GB+ |
| 存储空间 | 5GB | 20GB+ |
| 网络 | 能访问国际互联网 | 稳定带宽 |
软件要求
需要 Node.js 22+ 版本。检查版本命令如下：
node --version
如果没有安装 Node.js，推荐使用 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，体验最丝滑。
- 访问 GitHub Releases 页面下载
.dmg文件。 - 或使用 Homebrew 安装：
brew install openclaw/tap/openclaw
安装完成后，打开 OpenClaw.app，它会出现在菜单栏。
方式二：命令行安装（跨平台）
这是最通用的安装方式，适用于 Linux、Windows WSL 和 Mac。
# 1. 全局安装 OpenClaw CLI
npm install -g openclaw
# 2. 验证安装
openclaw --version
# 3. 初始化设置
openclaw setup
运行 openclaw setup 后，会出现交互式引导，按提示选择即可。注意部分渠道（如 Telegram、Discord）需要先申请 Bot Token。
方式三：Docker 部署（适合服务器）
如果是部署在服务器上，Docker 是最省心的选择。
# 1. 拉取镜像
docker pull openclaw/openclaw:latest
# 2. 创建配置目录
mkdir -p ~/.openclaw
# 3. 运行容器
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..."
}
}
安全提醒：建议在生产环境中使用环境变量而非直接在配置文件写入敏感信息。
渠道配置详解
Telegram 配置
- 创建 Bot：在 Telegram 中搜索
@BotFather，发送/newbot命令，按提示命名并获取 Token。 - 配置 OpenClaw：
openclaw config set channels.telegram.botToken "你的 Token" - 启动并测试：
在 Telegram 中搜索你的 Bot 用户名，发送openclaw gateway/start进行配对。
Discord 配置
- 创建应用：访问 Discord Developers，点击 "New Application"。
- 创建 Bot：进入 "Bot" 页面，添加 Bot 并复制 Token（记得开启 Message Content Intent）。
- 邀请 Bot：进入 "OAuth2" -> "URL Generator"，勾选 bot 权限，生成 URL 并在浏览器中打开授权到服务器。
启动与验证
启动 Gateway 服务：
# 前台运行（查看日志）
openclaw gateway --verbose
# 后台运行
openclaw gateway &
验证服务状态：
openclaw health
打开控制台，浏览器访问 http://127.0.0.1:18789。
常见问题汇总
Q1：启动报错 'Port 18789 already in use'
lsof -i :18789
# 或者换端口
openclaw gateway --port 18790
Q2：Telegram Bot 发消息没反应
- 检查 Bot Token 是否正确。
- 确保已经和 Bot 发起对话（需要先私聊
/start）。 - 查看详细日志：
openclaw gateway --verbose。
Q3：Discord 提示 'Missing Access'
- 检查 Bot 权限是否足够。
- 确保 Bot 已在服务器中。
- 在 Discord Developer Portal 检查 Intents 设置。
注意事项
- 网络安全：部署在公网时务必配置访问密码。
- Token 消耗：AI 对话需要消耗 API Token，注意费用预算。
- 隐私安全：不要在对话中输入敏感个人信息。
- 及时更新：关注官方 releases 更新安全补丁。
参考资料
- 官方文档：https://docs.openclaw.ai
- GitHub 仓库：https://github.com/openclaw/openclaw
