连接 Telegram
为你的 Agent 创建一个 Telegram 机器人，在手机上与它聊天。
连接 Telegram 后，无论身在何处，你都可以在手机上给 Agent 发消息。定时任务也可以把结果发送给你。
第 1 步：创建机器人
- 打开 Telegram，与 @BotFather 开始对话。
- 发送
/newbot。 - 选择一个显示名称，例如
Mona。 - 选择一个以
bot结尾的用户名，例如mona_assistant_bot。 - BotFather 会回复一个 token，形如
123456789:AAH...。复制它。
请妥善保管 token。任何拿到它的人都能控制你的机器人。
第 2 步：把机器人连接到你的 Agent
officeclaws telegram setTelegram bot token: 123456789:AAH...
Telegram channel configured.
为了应用新设置，telegram set 会自动重启 Agent 的容器，因此 Agent 会有几秒钟不可用。如果再次运行 telegram set 时没有加 --dm-policy，模式会恢复为 pairing。
第 3 步：配对你的 Telegram 账号
默认情况下，机器人只与你批准的人对话。这种模式称为 pairing。
-
在 Telegram 中打开你的机器人（搜索它的用户名），给它发送任意消息。
-
机器人会回复一个 配对码。
-
在你的电脑上，列出待处理的请求：
officeclaws telegram pairingsCODE USERNAME USER-ID EXPIRES K7Q2XM alex 123456789 2026-10-17T12:30:00Z -
批准请求：
officeclaws telegram approve K7Q2XM -
再给机器人发一条消息。现在 Agent 会回复了。
记下你的 USER-ID。 把 定时任务 的结果发送到 Telegram 时需要用到它。
谁可以给机器人发消息
用 --dm-policy 选择模式：
officeclaws telegram set --dm-policy pairing| 模式 | 谁可以给 Agent 发消息 |
|---|---|
pairing（默认，推荐） | 只有你通过配对码批准的人 |
allowlist | 只有 Agent 允许列表中的账号 |
open | 任何找到这个机器人的人。不推荐。 他们会消耗你的 ChatGPT 额度。 |
disabled | 任何人都不行。机器人会忽略私信。 |
其他命令
officeclaws telegram show # current settings (token masked)
officeclaws telegram disable # turn Telegram off