Telegram 机器人设置

将您的 Claw Buff 智能体连接到 Telegram 的分步指南

将您的 Claw Buff AI 智能体连接到 Telegram，让用户通过私聊或群组与其交互。设置大约需要 5 分钟。

前置条件

一个 Telegram 账号
已部署的 Claw Buff 智能体（快速开始）

第一步：通过 BotFather 创建机器人

打开 BotFather

打开 Telegram，搜索 @BotFather（认准蓝色认证标记）。这是 Telegram 官方的机器人管理工具。

创建机器人

发送 /newbot 给 BotFather，按提示操作：

机器人名称 — 显示名（如 "我的 AI 助手"）
机器人用户名 — 必须以 bot 结尾（如 my_claw_bot）

保存 Bot Token

BotFather 会回复一个 Bot Token，格式如下：

123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

复制此 Token——下一步需要用到。

请妥善保管您的 Bot Token。拥有此 Token 的任何人都可以控制您的机器人。切勿在公共聊天中分享或提交到 Git。

第二步：连接到 Claw Buff

打开 Claw Buff 控制台 → 渠道页面
找到 Telegram 卡片，点击连接
粘贴第一步获取的 Bot Token
点击保存并激活

您的智能体将在几秒内连接到 Telegram。状态会变为已连接。

第三步：授权访问

默认情况下，您的机器人使用配对模式 — 新用户必须经过审批才能聊天。当有人首次给您的机器人发消息时，会看到：

OpenClaw: access not configured.
Your Telegram user id: 1234567890
Pairing code: ABCD1234
Ask the bot owner to approve with:
openclaw pairing approve telegram ABCD1234

通过待审批请求审批

前往 Claw Buff 控制台 → 频道页面。当有人请求访问时，会自动出现待审批的配对请求区域，显示待处理的配对码。点击请求旁边的审批按钮即可。

配对码会在 1 小时后过期。过期后，用户只需重新给机器人发消息即可获取新的配对码。

管理已授权用户

您也可以直接管理访问权限。点击 Telegram 频道卡片上的管理按钮，可以：

查看所有已授权用户
添加用户：输入 Telegram 用户 ID 即可主动授权
移除用户：撤销其访问权限

第四步：开始聊天

打开 Telegram，通过用户名搜索您的机器人，发送一条消息即可。您的 AI 智能体会立即回复！

群组聊天设置

在 Telegram 群组中使用机器人：

将机器人添加到群组
默认情况下，机器人仅在被 @提及 时响应

在群组中，机器人只会在被提及时响应（如 @my_claw_bot 今天天气怎样？）。这可以防止机器人对繁忙群组中的每条消息都进行回复。

功能特性

功能	支持情况
私聊	支持
群组聊天	支持（需要 @提及）
流式响应	支持（实时输入效果）
富文本格式	支持（HTML/Markdown）
论坛话题	支持
文件附件	支持

常见问题

1. 机器人不响应？

检查 Token — 确保粘贴了完整的 Token，没有多余的空格
检查控制台 — 渠道页面会显示连接状态和错误日志
网络问题 — 智能体需要通过 443 端口访问 api.telegram.org

2. 机器人响应很慢？

流式响应默认启用。机器人会在 AI 生成回复时实时编辑消息。如果出现延迟，请在控制台 → 智能体 → 模型中检查模型配置。

3. "Forbidden: bot was blocked by the user"？

用户在 Telegram 上屏蔽了您的机器人。他们需要取消屏蔽并重新发送 /start。