OpenClaw 接入 Telegram 教程:建机器人、填令牌、批准配对
官方文档把 Telegram 列为设置最快的渠道:只需一个机器人令牌,不用装任何插件。国内用户即便不翻墙使用 Telegram 客户端有门槛,服务器端连接 Telegram API 通常是通畅的,所以它也常被当作服务器部署时的首验渠道。
第一步:创建机器人令牌
两条路任选其一,都会得到一串令牌:
- 聊天流程:在 Telegram 里找到官方机器人管理器(用户名必须逐字核对,谨防仿冒),发送 /newbot,按提示命名,保存返回的令牌。
- 网页流程:打开机器人管理器的 Web 应用创建,适合不想在手机上操作的场景。
第二步:写进配置
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "你的令牌",
"dmPolicy": "pairing",
"groups": { "*": { "requireMention": true } }
}
}
}
配置要点:令牌也可以放环境变量(仅默认账号有效);私信策略 pairing 是默认值,含义见下文;群组配置里的 requireMention 表示群里必须 @ 机器人才触发。
第三步:启动并批准配对
openclaw gateway
openclaw pairing list telegram
openclaw pairing approve telegram <配对码>
你用自己的 Telegram 账号给机器人发条私信,它会回一个配对码;在网关侧批准后对话才放行。配对码一小时过期,每渠道最多同时挂三个待处理请求。
第四步(可选):拉进群组
- 先收集两个 ID:你的数字用户 ID(进 allowFrom 或群组发送者白名单)和群聊 ID(负数、以 -100 开头,放 channels.telegram.groups 下)。
- 查 ID 的土办法:把群消息转发给查 ID 机器人,或开 openclaw logs --follow 看入站消息的 chat.id。
- 机器人默认开着隐私模式,群里只能看到部分消息;用机器人管理器的 /setprivacy 关掉,或直接设为群管理员,改完要把机器人移出群再拉回来才生效。
体验增强项
- 流式回复:默认 partial 模式,先发一条预览消息再反复编辑,像打字机一样;工具执行进度也会实时显示。
- 会话内命令:/status 看状态、/dashboard 在满足条件时可直接在 Telegram 里打开控制面板小程序。
- 多账号:一个网关可以挂多个机器人令牌,用 accounts 分块配置。