设置
在 BotFather 中创建机器人,将其 Token 交给 OpenClaw,批准第一条私信,然后将机器人添加到群组。
快速设置¶
1. 在 BotFather 中创建机器人 Token
两种流程最终都会得到一个 Token,你将其粘贴到 OpenClaw 中——任选其一:
- 聊天流程:打开 Telegram 并与 @BotFather 聊天。确认该用户名确实是
@BotFather。运行/newbot,按照提示操作,并保存 Token。 - 网页流程:打开 BotFather 网页应用。它可在所有 Telegram 客户端中运行,包括 web.telegram.org。在界面中创建机器人,然后复制其 Token。
2. 配置 Token 与私信策略
最快的方式是使用 CLI。它会将 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 gateway start` 以托管服务方式启动,
或在当前终端中运行 `openclaw gateway`。如果你更改了
服务环境,请重启网关以加载更改。
4. 批准你的第一条私信
打开 Telegram,向你的机器人发送任意消息。该消息会创建
配对请求,供下一条命令列出:
配对码的有效期为 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