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. 在 Telegram 搜索 @BotFather，发送 /newbot 创建机器人。
2. 设置名称并获取 Token。
3. 使用命令更新配置：

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

4. 启动网关并在 Telegram 中搜索 Bot 用户名发送 /start 配对。

Discord

1. 访问 Discord 开发者后台创建新应用。
2. 在 Bot 页面添加机器人并复制 Token（开启 Message Content Intent）。
3. 通过 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。

注意事项

1. 公网部署时务必配置访问密码。
2. AI 对话消耗 API Token，请注意费用预算。
3. 避免在对话中输入敏感个人信息。
4. 定期关注官方 Release 更新以修复安全漏洞。

参考资料

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