必须完成Bot Token配置与通信通道绑定才能实现HermesAgent与Telegram集成：一、通过@BotFather创建Bot并获取唯一Token；二、选择Webhook（需HTTPS）或Polling模式；三、在config.yaml中填写token、enabled及可选webhook_url；四、为群组Bot开启管理员权限；五、私聊测试指令收发与响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将 HermesAgent 与 Telegram 集成，使其能通过 Telegram 接收指令或推送通知，则必须完成 Bot Token 的正确配置与通信通道绑定。以下是实现该集成的具体操作步骤：
一、在 Telegram 中创建 Bot 并获取 Bot Token
Telegram 提供了 Bot API 接口，所有外部服务接入都需先通过 @BotFather 创建专属 Bot，并获得唯一认证凭证——Bot Token。该 Token 是 HermesAgent 向 Telegram 发送请求时的身份密钥，不可泄露或复用。
1、打开 Telegram 应用，搜索并进入 @BotFather 账户。
2、发送 /newbot 指令，按提示输入 Bot 的显示名称（如 HermesAgent Monitor）。
3、继续输入 Bot 的用户名（必须以 _bot 结尾，例如 hermesagent_monitor_bot）。
4、成功创建后，@BotFather 将返回包含 Bot token 的消息，格式为：1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef，请完整复制保存。
二、启用 Bot 的 Webhook 或轮询模式
HermesAgent 需通过 Telegram Bot API 接收用户消息，可选择 Webhook（推荐用于公网部署）或轮询（Polling）方式。二者互斥，仅需配置其一。Webhook 要求 HermesAgent 所在服务具备 HTTPS 可访问地址；轮询则无需公网入口，适合内网或测试环境。
1、若采用 Webhook：准备一个支持 HTTPS 的 endpoint（如 https://your-domain.com/telegram/webhook），确保该路径可接收 POST 请求且响应 200 状态码。
2、向 Telegram 发起 Webhook 设置请求，使用如下 curl 命令（替换 YOUR_BOT_TOKEN 和 YOUR_WEBHOOK_URL）：
curl -F "url=https://your-domain.com/telegram/webhook" https://api.telegram.org/botYOUR_BOT_TOKEN/setWebhook
3、若采用轮询：在 HermesAgent 配置中显式启用 polling 模式，并确保未设置 webhook URL；HermesAgent 将定期调用 getUpdates 接口拉取消息。
三、在 HermesAgent 中填写 Bot Token 并启用 Telegram 模块
HermesAgent 的 Telegram 集成依赖于配置文件中 telegram 相关字段的准确填写。Token 必须以明文形式写入配置，且模块开关需设为启用状态，否则初始化阶段将跳过 Telegram 初始化流程。
1、定位 HermesAgent 主目录下的配置文件，通常为 config.yaml 或 settings.json（依版本而定）。
2、在 telegram: 区块下填入以下字段：
token: "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef"
enabled: true
3、若使用 Webhook，补充 webhook_url: "https://your-domain.com/telegram/webhook"；若使用 Polling，确保该字段不存在或为空值。
四、验证 Telegram 连通性与权限设置
Telegram Bot 默认无法接收群组消息或频道事件，仅能处理私聊和已添加至群组并被设为管理员的场景。HermesAgent 若需响应群组指令，必须手动赋予 Bot 群管理权限，并开启相应事件监听选项。
1、将 Bot 添加进目标 Telegram 群组，长按 Bot 名称，选择 管理群组 → 开启 成为管理员 权限。
2、进入群组设置 → 权限 → 关闭 禁止添加新成员（非必需，但部分旧版 Bot API 要求）。
3、在 HermesAgent 日志中查找类似 Telegram bot initialized, listening for updates 的提示行，确认初始化成功。
五、测试消息收发与基础指令响应
完成全部配置后，HermesAgent 应能解析来自 Telegram 的文本消息，并依据预设规则触发响应逻辑。首次测试建议使用私聊方式，避免权限或过滤机制干扰验证过程。
1、在 Telegram 中私聊刚创建的 Bot，发送任意文本（如 /status）。
2、观察 HermesAgent 控制台日志是否输出接收到的 update 对象，含 message.chat.id 与 message.text 字段。
3、检查 Telegram 是否收到 HermesAgent 返回的响应消息；若无响应，确认配置中 allowed_chat_ids 是否限制了目标 chat_id，或消息处理器是否注册成功。
