跳转至

设置

在 BotFather 中创建机器人,将其 Token 交给 OpenClaw,批准第一条私信,然后将机器人添加到群组。

快速设置

1. 在 BotFather 中创建机器人 Token

两种流程最终都会得到一个 Token,你将其粘贴到 OpenClaw 中——任选其一:

  • 聊天流程:打开 Telegram 并与 @BotFather 聊天。确认该用户名确实是 @BotFather。运行 /newbot,按照提示操作,并保存 Token。
  • 网页流程:打开 BotFather 网页应用。它可在所有 Telegram 客户端中运行,包括 web.telegram.org。在界面中创建机器人,然后复制其 Token。

2. 配置 Token 与私信策略

最快的方式是使用 CLI。它会将 Token 写入你的配置:
openclaw channels add --channel telegram --token <bot-token>
若要手动编辑配置,请将以下内容放入 `~/.openclaw/openclaw.json`:
{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
      groups: { "*": { requireMention: true } },
    },
  },
}
环境变量回退:`TELEGRAM_BOT_TOKEN`(仅默认账户)。命名账户必须使用 `botToken` 或 `tokenFile`。
Telegram **不**使用 `openclaw channels login telegram`。在配置或环境变量中设置 Token,然后启动网关。

3. 验证通道

<a id="restart-the-gateway" />
借助默认的[热重载](../../gateway/configuration/hot-reload.md),正在运行的
网关会应用新的通道配置。检查 Telegram 是否就绪:
openclaw channels status --probe
如果网关离线,请使用 `openclaw gateway start` 以托管服务方式启动,
或在当前终端中运行 `openclaw gateway`。如果你更改了
服务环境,请重启网关以加载更改。

4. 批准你的第一条私信

打开 Telegram,向你的机器人发送任意消息。该消息会创建
配对请求,供下一条命令列出:
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
配对码的有效期为 1 小时。

5. 将机器人添加到群组

将机器人添加到你的群组,然后获取群组访问所需的两个 ID:

  • 你的 Telegram 用户 ID,用于 allowFrom / groupAllowFrom
  • Telegram 群组聊天 ID,作为 channels.telegram.groups 下的键

从 openclaw logs --follow、转发 ID 机器人或 Bot API getUpdates 获取群组聊天 ID。群组获得允许后,/whoami@<bot_username> 会确认用户和群组 ID。

以 -100 开头的负值超级群组 ID 就是群组聊天 ID。它们应放在 channels.telegram.groups 下,而不是 groupAllowFrom。

Note

Token 解析是区分账户的。tokenFile 优先于 botToken,botToken 优先于环境变量。配置始终优先于 TELEGRAM_BOT_TOKEN,后者仅对默认账户生效。成功启动后,OpenClaw 会将机器人身份缓存最长 24 小时,因此重启时会跳过额外的 getMe 调用。更改或移除 Token 会清除该缓存。

Telegram 端设置

隐私模式与群组可见性

Telegram 机器人默认启用隐私模式,这会限制它们能收到的群组消息。

要查看所有群组消息,可以:

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

切换隐私模式后,在每个群组中移除并重新添加机器人,以便 Telegram 应用更改。

群组权限

管理员状态在 Telegram 群组设置中控制。管理员机器人会收到所有群组消息,适用于始终在线的群组行为。

实用的 BotFather 开关
  • /setjoingroups — 允许/拒绝加入群组
  • /setprivacy — 群组可见性行为

如果你更倾向于使用界面而非聊天命令,也可以在 BotFather 网页应用 中找到相同的设置。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw