本页内容
本页内容
主流消息传递
Telegram 设置
在 BotFather 中创建机器人,为 OpenClaw 提供其代币,批准第一个 DM,并将机器人添加到组中。
快速设置
在 BotFather 中创建机器人令牌
这两种流程最终都会得到一个你可以粘贴到 OpenClaw 中的 token——任选其一:
- 聊天流程:打开Telegram并与**@BotFather**聊天。确认该句柄正是
@BotFather。运行/newbot,按照提示操作,然后保存令牌。 - 网页流:打开Bot父亲的网页应用程序。它在每个 Telegram 客户端中运行,包括 web.telegram.org. 在 UI 中创建机器人,然后复制其令牌。
配置令牌和 DM 策略
最快的选项是 CLI。它会为您将令牌写入您的配置中:
要手动编辑配置,请将其放入 ~/.openclaw/openclaw.json 中:
Env 后备:TELEGRAM_BOT_TOKEN(仅限默认帐户)。指定帐户必须使用 botToken 或 tokenFile。 Telegram 不 使用 openclaw channels login telegram。在 config 或 env 中设置令牌,然后启动网关。
验证通道
使用默认的 [hot reload](/gateway/configuration/hot-reload),正在运行的网关将应用新的通道配置。检查 Telegram 是否准备就绪:如果网关离线,请使用 openclaw gateway start 启动它以获取托管服务,或使用 openclaw gateway 在此终端中运行它。如果您更改了服务环境,请重新启动网关以加载它。
批准您的第一个 DM
打开 Telegram 并向您的机器人发送任何消息。该消息创建下一个命令列出的配对请求:
配对代码将在 1 小时后过期。
将机器人添加到组中
将机器人添加到您的组中,然后获取组访问需要的两个 ID:
- 你的 Telegram 用户 ID,用于
allowFrom/groupAllowFrom - Telegram 群聊 ID,作为
channels.telegram.groups下的键
从 openclaw logs --follow、转发的 ID 机器人或机器人 API getUpdates 获取群聊 ID。允许组后,/whoami@<bot_username> 确认用户和组 ID。
以-100开头的负超群ID是群聊ID。它们属于 channels.telegram.groups,而不是 groupAllowFrom。
Telegram 侧设置
隐私模式和群组可见性
Telegram 机器人的默认设置是 隐私模式,这会限制它们接收哪些群消息。
要查看所有群消息,可以:
- 通过
/setprivacy禁用隐私模式,或 - 将机器人设为群管理员。
切换隐私模式后,请在每个群中移除并重新添加机器人,以便 Telegram 应用该更改。
组权限
管理员状态在 Telegram 群设置中控制。管理员机器人会接收所有群消息,这对于需要始终在线的群组行为很有用。
有用的 BotFather 切换
/setjoingroups— allow/deny 组添加/setprivacy— 群可见性行为
如果您更喜欢 UI 而不是聊天命令,则可以在 BotFather 的网络应用程序 中使用相同的设置。