01
保存前校验 Token
FastClaw 会在保存前调用 Telegram 的 getMe 校验 Token,填错了也不会留下一个失效的机器人。
02
私聊与群聊
可以一对一聊天,也可以把机器人拉进群。每个聊天都有独立的会话和历史。
03
文字与图片
用户可以发送文字和图片,Agent 会回复格式化文本、图片和文件链接。
04
无需公网地址
机器人主动连接 Telegram,在 NAT 后的笔记本上也能和服务器上一样正常运行。
能做什么
- 跑一个随时能在手机上找到的私人助理,定时提醒 直接发到聊天里。
- 为 Telegram 群组上线一个社群助手机器人——参见 FastClaw 面向社群。
- 同一个 Agent 同时在 Telegram 和 Discord 上回复,共享记忆和技能。
接入步骤
- 在 Telegram 中打开 @BotFather,运行
/newbot,复制返回的 HTTP API Token。 - 在 FastClaw 中进入该 Agent,打开 Channels → Telegram 并粘贴 Token,保存前会自动校验。
- 配对账号:复制控制台中的一次性配对码,用你自己的 Telegram 账号向机器人发送
/pair <code>。配对码 10 分钟内有效。 - 给机器人发条消息测试一下。
也可以用 CLI:
fastclaw channels connect --agent alpha --type telegram \
--account my_bot --token 123456789:ABCdef...
补充说明
Telegram 是 FastClaw 支持的九个 IM 渠道 之一。贴纸和语音消息会被忽略,文字和图片会转发给 Agent。

