Telegram 接入

Telegram 是 OpenClaw 推荐的首选消息渠道，配置简单且功能完整。

创建 Bot

1. 在 Telegram 搜索 @BotFather 并发送 /newbot。
2. 按提示设置 Bot 名称和用户名。
3. 获取 Bot Token（格式如 123456789:ABCdefGHIjklMNO）。

配置

在 ~/.openclaw/openclaw.json 中添加 Telegram 渠道：

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123456789:ABCdefGHIjklMNO",
      dmPolicy: "pairing",
      groups: {
        "*": { requireMention: true },
      },
    },
  },
}

启动与配对

# 重启 Gateway 使配置生效
openclaw gateway restart

# 查看待配对用户
openclaw pairing list telegram

# 批准配对
openclaw pairing approve telegram <配对码>

配对完成后，即可在 Telegram 私聊中直接与 Bot 对话。

群聊配置

默认群聊需要 @ 机器人才会触发回复。如需关闭此限制：

{
  channels: {
    telegram: {
      groups: {
        "*": { requireMention: false },
      },
    },
  },
}

在 Telegram 中，Bot 需要关闭 Privacy Mode 才能读取所有群消息。通过 @BotFather -> /mybots -> Bot Settings -> Group Privacy -> Turn off 关闭。

常见问题

私聊不回复

1. 确认 Bot Token 正确。
2. 检查 Gateway 是否正常运行：openclaw gateway status
3. 查看日志：openclaw logs --follow

群聊不回复

1. 确认已关闭 Telegram Privacy Mode。
2. 确认 requireMention 配置符合预期。
3. 群聊中需要使用 @你的Bot用户名 触发。

国内网络无法连接

配置代理：

{
  channels: {
    telegram: {
      proxy: "socks5://127.0.0.1:7890",
    },
  },
}