OpenClaw 自托管 AI 网关安装部署实战指南

运行 setup 后按提示操作即可。注意部分渠道（如 Telegram、Discord）需要额外申请 Bot Token。

方式三：Docker 部署（服务器推荐）

适合部署在远程服务器上，便于持久化管理。

# 1. 拉取镜像
docker pull openclaw/openclaw:latest

# 2. 创建配置目录
mkdir -p ~/.openclaw

# 3. 启动容器
# 注意：端口映射为 18789，数据卷挂载到本地
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 配置

1. 创建 Bot：在 Telegram 搜索 @BotFather，发送 /newbot，按提示命名并获取 Token。
2. 配置 OpenClaw：

openclaw config set channels.telegram.botToken "你的 Token"

3. 测试连接：启动网关后，在 Telegram 中搜索 Bot 用户名并发送 /start。

openclaw gateway

Discord 配置

1. 创建应用：访问 Discord 开发者中心，新建 Application。
2. 添加 Bot：进入 Bot 页面，点击 Add Bot 并复制 Token（务必开启 Message Content Intent）。
3. 邀请至服务器：在 OAuth2 -> URL Generator 中勾选 bot 权限，生成链接并在浏览器中授权。

启动与验证

启动网关

前台运行可实时查看日志：

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 无响应

• 确认 Token 无误。
• 确保已与 Bot 私聊过 /start。
• 查看详细日志：openclaw gateway --verbose

Q3：Discord 提示 'Missing Access'

• 检查 Bot 是否已邀请至目标服务器。
• 确认 Developer Portal 中的 Intents 设置已开启。

注意事项

1. 网络安全：公网部署时务必配置访问密码或限制 IP。
2. Token 消耗：AI 对话会产生 API 费用，请留意用量。
3. 隐私保护：避免在对话中输入个人敏感信息。
4. 及时更新：关注官方 Release 以获取安全补丁和功能更新。

相关链接

• 官方文档：https://docs.openclaw.ai
• GitHub 仓库：https://github.com/openclaw/openclaw