OpenClaw 自托管 AI 网关安装部署全流程

详细配置

配置文件通常位于 ~/.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。

Discord 接入

1. 创建应用：访问 Discord Developer Portal，新建 Application。
2. 启用 Bot：在 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 无响应 检查 Token 是否正确，确保已私聊 Bot 发送过 /start，并通过 --verbose 查看详细日志。

Q3：Discord 权限不足 确认 Bot 已在服务器内，且 Developer Portal 中的 Intents 设置已开启消息内容读取权限。

注意事项

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

参考资料

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