{"skill":{"slug":"telegram-bot-chat","displayName":"telegram-bot-chat","summary":"实现多个Telegram Bot在群聊中通过正确sessionKey和message参数进行高效协同通信，提高多agent协作效率。","description":"# Telegram Bot间群聊通信技能\n**创建时间**: 2026-02-20 11:03 UTC+8\n**技能版本**: 1.0.0\n**适用场景**: Telegram群聊中多agent协同通信\n\nname: telegram-bot-chat\nversion: 1.0.0\ndescription: Telegram群聊中实现多agent之间互相通信的技术，促进协同工作效率提升\nhomepage: https://telegram.org\nmetadata: {\"category\":\"communication\",\"platform\":\"telegram\",\"use_case\":\"multi_agent_coordination\"}\n\n# Telegram Bot群聊通信\n\n实现多agent在Telegram群聊中的高效协同通信，促进协同工作效率的提升\n\n## Skill Files\n\n| File | URL |\n|------|-----|\n| **SKILL.md** (this file) | Current file |\n| **SKILL.md** | Skill documentation |\n\n**Install locally:**\n```bash\n# 安装到工作空间skills目录\ncp -r telegram-bot-chat /root/.openclaw/workspace/skills/\n```\n\n**然后主agent需要手动执行多bot部署：**\n```bash\n# 主agent执行：复制skill到每个bot的工作空间\nWORKSPACE_SKILLS=\"/root/.openclaw/workspace/skills\"\n\n# 复制workspace中所有skills到每个bot的workspace目录\nfor skill_dir in $WORKSPACE_SKILLS/*/; do\n    if [ -d \"$skill_dir\" ]; then\n        skill_name=$(basename \"$skill_dir\")\n        echo \"复制技能 $skill_name 到每个bot的工作空间\"\n        \n        # 复制到workspace-2, workspace-3, workspace-4等\n        for workspace_dir in /root/.openclaw/workspace*; do\n            if [ \"$workspace_dir\" != \"$WORKSPACE_SKILLS\" ]; then\n                mkdir -p \"$workspace_dir/skills\"\n                cp -r \"$skill_dir\" \"$workspace_dir/skills/\"\n                echo \"已部署技能 $skill_name 到 $workspace_dir\"\n            fi\n        done\n    fi\ndone\n```\n\n**Or just read from this file!**\n\n---\n\n⚠️ **IMPORTANT:** \n- 确保所有bot都有完整的telegram配置\n- 正确使用sessions_send和message工具参数\n- 测试bot间通信是否正常工作\n\n🔒 **关键要点:**\n- 必须在正确的sessionKey格式中使用telegram和group类型\n- message工具必须指定accountId使用自己的bot配置\n- sessionKey必须包含bot名称、channel类型和群ID\n\n**适用性检查:** 所有agent都可使用此技能进行多agent协同通信\n\n## 核心问题\n\nTelegram Bot API不会把bot发的消息投递给其他bot，所以：\n- ❌ 在群里@其他bot，他们收不到消息\n- ❌ bot直接艾特bot没有效果\n\n## 解决方案：sessions_send + 正确配置\n\n### 发送消息到其他bot\n\n当需要与其他bot对话时，使用：\n\n```javascript\nsessions_send(\n    sessionKey=\"agent:bot2:telegram:group:群ID\",  // 正确的sessionKey\n    message=\"群聊对话。来自:main。内容：想要bot2回复的内容...\"\n)\n```\n\n### 接收消息并回复\n\n当收到其他bot通过sessions_send发来的消息时：\n\n1. **解析消息内容**：识别这是群聊场景和消息来源\n2. **使用message工具回复**：\n```javascript\nmessage(\n    action=\"send\",\n    channel=\"telegram\",\n    accountId=\"自己的bot accountId\",        // 使用自己的bot accountId\n    target=\"群ID\", // 群ID\n    message=\"你的回复内容\"\n)\n```\n\n### sessionKey格式详解\n\n```\nagent:[bot名称]:telegram:group:群ID\n```\n\n示例：\n- bot2在群聊：`agent:bot2:telegram:group:群ID`\n- bot3在群聊：`agent:bot3:telegram:group:群ID`\n- bot4在群聊：`agent:bot4:telegram:group:群ID`\n\n### 完整工作流程\n\n```\nbotA → sessions_send → botB收到 → botB回复 → OpenClaw announce → 群聊显示\n```\n\n## 关键技术要点\n\n### 1. sessionKey必须包含\n- bot名称（bot2, bot3, bot4等）\n- channel类型（telegram）\n- group类型和群ID\n\n### 2. message工具必须指定\n- `accountId`：使用自己的bot accountId\n- `channel`：固定为\"telegram\"\n- `target`：群ID\n\n### 3. 配置要求\n每个bot必须在`channels.telegram.accounts`中有完整配置：\n- botToken\n- 群聊权限\n- 正确的accountId\n\n## 实际使用示例\n\n### 场景1：bot2叫bot3\n```javascript\n// 错误的做法\n// @bot3 在群里（bot3收不到）\n\n// 正确的做法\nsessions_send(\n    sessionKey=\"agent:bot3:telegram:group:群ID\",\n    message=\"bot2在群里说：bot3，过来帮忙！\"\n)\n```\n\n### 场景2：bot3收到并回复\n```javascript\n// bot3收到sessions_send后\nmessage(\n    action=\"send\",\n    channel=\"telegram\",\n    accountId=\"自己的bot accountId\",         // 使用自己的bot accountId\n    target=\"群ID\",\n    message=\"来了，什么事？\"\n)\n```\n\n## 常见错误\n\n### ❌ 错误1：sessionKey格式不对\n```javascript\n// 错误的sessionKey\nagent:bot2:main  // 没有channel和群信息\n\n// 正确的sessionKey\nagent:bot2:telegram:group:群ID\n```\n\n### ❌ 错误2：忘记指定accountId\n```javascript\n// 错误：没有accountId\nmessage(action=\"send\", channel=\"telegram\", target=\"群ID\")\n\n// 正确：包含accountId\nmessage(action=\"send\", channel=\"telegram\", accountId=\"自己的bot accountId\", target=\"群ID\")\n```\n\n### ❌ 错误3：没有telegram配置\n- bot需要在channels.telegram.accounts中有完整配置\n- 需要有对应的botToken和权限\n\n## 部署指南\n\n**第1步：安装到主agent工作空间**\n```bash\n# 安装到工作空间skills目录\ncp -r telegram-bot-chat /root/.openclaw/workspace/skills/\n```\n\n**第2步：主agent手动执行多bot部署**\n```bash\n# 复制skill到每个bot的工作空间（主agent执行）\nWORKSPACE_SKILLS=\"/root/.openclaw/workspace/skills\"\n\n# 复制workspace中所有skills到每个bot的workspace目录\nfor skill_dir in $WORKSPACE_SKILLS/*/; do\n    if [ -d \"$skill_dir\" ]; then\n        skill_name=$(basename \"$skill_dir\")\n        echo \"复制技能 $skill_name 到每个bot的工作空间\"\n        \n        # 复制到workspace-2, workspace-3, workspace-4等\n        for workspace_dir in /root/.openclaw/workspace*; do\n            if [ \"$workspace_dir\" != \"$WORKSPACE_SKILLS\" ]; then\n                mkdir -p \"$workspace_dir/skills\"\n                cp -r \"$skill_dir\" \"$workspace_dir/skills/\"\n                echo \"已部署技能 $skill_name 到 $workspace_dir\"\n            fi\n        done\n    fi\ndone\n```\n\n**第3步：验证部署**\n1. 确保每个bot的channels.telegram.accounts配置完整\n2. 测试bot之间的通信是否正常\n\n**多bot部署说明：**\n- skill安装时只部署到主agent工作空间\n- 主agent需要手动执行复制脚本\n- 复制脚本会自动检测所有非main bot目录\n- 复制完成后所有bot都可使用此技能进行协同通信\n\n## 总结\n\n通过这个技能，多个agent可以在Telegram群聊中实现高效协同通信，促进协同工作效率的提升。关键是要使用正确的sessionKey格式和message工具参数。\n\n**检查更新:** 随时重新阅读此文件查看新功能！\n","topics":["Telegram"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":1027,"installsAllTime":39,"installsCurrent":2,"stars":2,"versions":1},"createdAt":1771589914873,"updatedAt":1778991870011},"latestVersion":{"version":"1.0.0","createdAt":1771589914873,"changelog":"Initial release: Multi-agent collaboration in Telegram group chats.\n\n- Enables efficient communication between multiple agents (bots) in Telegram group chats.\n- Provides detailed deployment and configuration instructions for correct multi-bot setup.\n- Explains sessionKey and message tool usage for inter-bot messaging.\n- Offers practical examples and common troubleshooting tips.\n- Designed for scenarios where enhanced group cooperation between Telegram bots is required.","license":null},"metadata":null,"owner":{"handle":"1227cwx","userId":"s170s7qhh4jrdxfpddp7gp45x9885e71","displayName":"青鱼","image":"https://avatars.githubusercontent.com/u/215025116?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779942949548}}