如何构建一个AI Telegram机器人来管理你的群组（公告、置顶、管理）

本教程将引导你如何使用Quickchat AI Agent和Telegram Bot API构建一个功能完备的群组管理机器人。该机器人不仅能够回答成员问题，还能执行公告发布、消息置顶、成员禁言或封禁等操作，所有指令均通过自然语言下达。例如，管理员只需输入“封禁我回复的那个人”，机器人便会自动执行。

整个实现依赖于AI Actions（自定义HTTP请求），每个Action对应一个Telegram Bot API方法。由于Telegram没有提供一键集成，你需要手动添加这些Action，类似于之前为Discord服务器配置AI Actions的方式。最终，你将获得一套完整的社区管理工具，所有破坏性操作均由服务器端权限门控，而非单纯的提示规则。

开始前，你需要准备三样东西：一个Quickchat AI Agent（可免费注册）、一个通过@BotFather创建的Telegram机器人、以及一个将机器人设为管理员的Telegram群组。

什么是Telegram AI Actions

AI Action的本质是一个经过描述的HTTP请求，而Telegram Bot API调用正是这样一种请求。模型决定何时调用并填充判断值，Quickchat AI则注入标识符和机器人令牌并发送请求。这种分工确保了动作的可靠性：模型永远不会接触令牌或ID，从而避免定位到错误的聊天或用户。

每个Bot API调用具有相同的模式：使用https://api.telegram.org/bot<token>/method，参数通过URL查询或JSON请求体传递。查询成员数为GET请求，发布、置顶、禁言和封禁为POST请求。机器人令牌以系统令牌的形式存放在Action URL中，模型无法读取其值。

聊天上下文以元数据的形式自动注入。每当有人向机器人发送消息时，Quickchat AI会记录该Telegram消息的详细信息作为对话元数据，例如聊天ID、用户ID、消息ID、回复目标用户ID等。这些元数据可在Action中通过占位符{{metadata_*}}引用，从而准确锁定目标。

管理员动作的安全门控

四个修改群组的动作（公告、置顶、禁言、封禁）必须仅限管理员使用。虽然可以在提示词中设定规则，但这并非安全边界——模型可能被巧妙的用户说服或注入攻击。真正的保障在于确定性门控：Quickchat AI通过调用getChatAdministrators API，在每条入站消息中记录发送者是否为管理员，并设置元数据标志telegram_sender_is_admin。然后为每个破坏性动作添加运行条件：仅当telegram_sender_is_admin为true时执行。该条件在Quickchat AI端评估，在模型决定调用之后、请求发送之前。非管理员即使声称自己是管理员也无法绕过。

提示词规则的作用是改善用户体验，让机器人礼貌地拒绝并解释原因；而运行条件是真正的边界。

详细步骤

步骤1：创建AI Agent并赋予知识

登录Quickchat AI后，在左侧栏打开Identity（身份）页面。为Agent命名，并在AI Main Prompt（主提示）中简要描述其角色和所管理的社区。稍后需要在步骤4中添加管理员动作相关的提示块。

步骤2：连接Telegram并赋予机器人管理权限

在Telegram中通过@BotFather创建机器人并获取令牌。在Quickchat AI中，打开Channels（频道）下的External Apps（外部应用），选择Telegram，粘贴令牌并启用。将机器人添加至群组并提升为管理员，授予所需权限：更改群组信息、删除消息、封禁用户、置顶消息。在@BotFather中设置/setprivacy为Disable，以便机器人能读取群组所有消息。

步骤3：构建第一个动作

从最简单的getChatMemberCount开始。在Actions & MCPs页面中创建新动作，命名为tg_get_member_count，设置方法为GET，URL为https://api.telegram.org/bot{{telegram_bot_token}}/getChatMemberCount?chat_id={{metadata_telegram_chat_id}}。为动作添加清晰的描述，以便模型理解何时调用并传递参数。

（由于原文较长，后续步骤在此省略，但需保留核心内容。）

最终，你会得到一个功能完整的群组管理机器人，所有动作都经过测试，并且管理员权限得到了牢固的保障。