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..."
  }
}

🔐 安全提醒：建议优先使用环境变量而非直接在配置文件中写入敏感信息。

渠道配置详解

Telegram 配置

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

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

3. 启动测试：

openclaw gateway

在 Telegram 中搜索你的 Bot 用户名，发送 /start 进行配对。

Discord 配置

1. 创建应用：访问 Discord 开发者后台，点击 New Application。
2. 创建 Bot：进入 Bot 页面添加机器人，复制 Bot Token（记得开启 Message Content Intent）。
3. 邀请 Bot：在 OAuth2 URL Generator 中勾选 bot 权限，生成链接并在浏览器中打开授权到目标服务器。

启动与验证

启动 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 发消息没反应

1. 检查 Bot Token 是否正确。
2. 确保已经和 Bot 发起对话（需先私聊 /start）。
3. 查看详细日志：openclaw gateway --verbose。

Q3：Discord 提示'Missing Access'

1. 检查 Bot 权限是否足够。
2. 确认 Bot 已在服务器中。
3. 在 Discord Developer Portal 检查 Intents 设置。

注意事项

1. 网络安全：部署在公网时务必配置访问密码。
2. Token 消耗：AI 对话需要消耗 API Token，请注意费用控制。
3. 隐私安全：不要在对话中输入敏感个人信息。
4. 及时更新：关注官方 releases 以获取安全补丁。

参考资料

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