OpenClaw 安装部署指南
🤔 什么是 OpenClaw？
OpenClaw 是一个自托管的 AI 网关，可以将常用的聊天软件（微信、Telegram、Discord、iMessage 等）与 AI 助手连接。
- 📱 在微信上发消息，AI 自动回复
- 💬 在 Discord 群里 @它，AI 参与讨论
- 📲 人在外面用 WhatsApp 随时召唤私人 AI
🛠️ 环境准备
硬件要求
| 配置 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS 10.15+ / Linux / Windows WSL2 | macOS 12+ |
| 内存 | 8GB | 16GB+ |
| 存储空间 | 5GB | 20GB+ |
| 网络 | 能访问国际互联网 | 稳定带宽 |
软件要求
# 检查 Node.js 版本（需要 Node 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 用户（最简单）
推荐使用官方 App：
# 方法 1：直接下载安装包
# 访问 https://github.com/openclaw/openclaw/releases 下载 .dmg 文件
# 方法 2：使用 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 需要先找 @BotFather 申请 Bot Token，Discord 需要创建开发者应用。
方式三：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 配置步骤
Step 1：创建 Bot
- 打开 Telegram，搜索 @BotFather
- 发送
/newbot命令 - 给你的 Bot 起个名字（比如'我的 AI 助手'）
- 给你的 Bot 设置用户名（必须以
_bot结尾） - 复制 Bot Father 给你的 Token
Step 2：配置 OpenClaw
openclaw config set channels.telegram.botToken "你的 Token"
Step 3：启动并测试
openclaw gateway # 在 Telegram 中搜索你的 Bot 用户名，发送 /start 进行配对
Discord 配置步骤
Step 1：创建 Discord 应用
- 访问 https://discord.com/developers/applications
- 点击'New Application'
Step 2：创建 Bot
- 进入'Bot'页面
- 点击'Add Bot'
- 复制 Bot Token（记得开启 Message Content Intent）
Step 3：邀请 Bot 到服务器
- 进入'OAuth2' -> 'URL Generator'
- 勾选 bot 权限
- 复制生成的 URL，在浏览器中打开并选择服务器
🚀 启动与验证
启动 Gateway
# 前台运行（查看日志）
openclaw gateway --verbose
# 后台运行
openclaw gateway &
验证
openclaw health
打开控制台：浏览器访问 http://127.0.0.1:18789
架构流程图
用户发送消息 → 聊天渠道 → Gateway → AI Model → 返回消息
🔍 常见问题汇总
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 更新安全补丁
