OpenClaw Telegram 渠道接入指南-05r

OpenClaw 支持通过 Telegram Bot API 连接 Telegram。本指南将帮助你快速完成 Telegram 渠道的配置。

快速开始

第一步：在 BotFather 创建机器人

打开 Telegram，搜索并联系 @BotFather（确认用户名完全一致）。

发送 /newbot 按照提示创建机器人，并保存好 Token。

第二步：配置 Token 和私信策略

在 OpenClaw 配置文件中添加：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing",
      "groups": { "*": { "requireMention": true } }
    }
  }
}

或者通过环境变量：

TELEGRAM_BOT_TOKEN=...

注意： Telegram 不使用 openclaw channels login telegram 命令，直接在配置文件中设置即可。

第三步：启动 Gateway 并配对

openclaw gateway
openclaw pairing list telegram
openclaw pairing approve telegram [CODE]

配对码有效期为1小时。

第四步：将机器人添加到群组

将机器人添加到你的群组，然后配置 channels.telegram.groups 和 groupPolicy 来控制访问。

Telegram 端设置

隐私模式和群组可见性

Telegram 机器人默认启用隐私模式，这会限制它们在群组中接收的消息。

如果机器人需要查看所有群组消息，可以：

通过 /setprivacy 禁用隐私模式，或
将机器人设为群组管理员

切换隐私模式后，需要将机器人从群组中移除并重新添加，Telegram 才会应用更改。

群组权限

管理员机器人会接收所有群组消息，适合需要”始终在线”群组行为的场景。

有用的 BotFather 命令

/setjoingroups — 允许/禁止被添加到群组
/setprivacy — 群组可见性行为设置

访问控制

私信策略 (DM Policy)

channels.telegram.dmPolicy 控制私信访问：

pairing — 配对模式（默认）
allowlist — 白名单模式，需要在 allowFrom 中添加用户ID
open — 开放模式，allowFrom 需设为 "*"
disabled — 禁用

查找你的 Telegram 用户 ID

更安全的方式（无需第三方机器人）：

私信给你的机器人
运行 openclaw logs --follow
从日志中读取 from.id

或者使用官方 Bot API：

curl "https://api.telegram.org/bot[bot_token]/getUpdates"

OpenClaw Telegram 渠道接入指南