Agent Telegram

核心用法

agent-telegram 是一套面向多Agent架构的Telegram消息通信规范，解决分布式AI团队中信息传递的标准化问题。核心机制包括：

1. 身份映射系统 —— 8个Agent角色（main/architect/backend/frontend/product/content/crawler/qa）分别绑定唯一的 accountId 和专属emoji，实现消息来源的可视化区分。

2. 标准化消息协议 —— 强制使用 message() 工具而非 sessions_send，固定参数结构：action: "send"、channel: "telegram"、target: "5440561025"（用户固定ID），消息体需以emoji开头。

3. 全生命周期汇报 —— 规范任务开始、子任务完成、异常阻断、最终交付四个关键节点的消息模板，避免信息遗漏。

显著优点

• 防错设计突出：明确列出4类高频错误（忘记accountId、工具误用、product拼写陷阱、target错误），每个都给出具体后果和修正方案
• 跨团队协作友好：emoji+角色名的双重标识让复杂项目中的消息来源一目了然
• 模板即文档：提供可直接复制的三类消息模板，降低执行摩擦
• 配置路径透明：明确标注主配置和Skill配置的物理位置，便于问题排查

潜在局限

• 硬编码依赖：用户Telegram ID 5440561025 和账号映射表写死，不支持动态用户或多用户场景
• 单向通信：仅定义Agent→User的下行消息，未涉及用户指令的上行处理
• 平台锁定：仅支持Telegram，如需迁移到其他IM需重写规范
• 无消息状态反馈：发送成功与否、送达确认等机制未提及

适合人群

多Agent协作开发团队的产品经理、技术负责人，以及需要统一管理AI助手消息触达方式的Claw用户。

常规风险

• ID拼写错误：sproduct 而非 product 的反直觉命名易导致配置失败
• 工具混淆：sessions_send 与 message 的误用会导致消息石沉大海
• 权限泄露：配置文件中明文存储账号信息，共享环境需注意敏感信息保护

核心用法

该 Skill 定义了一套完整的 Agent-Telegram 通信协议，核心是通过标准化的 message() 工具调用实现消息推送。所有 Agent（包括 architect、backend、frontend、product、content、crawler、qa 等角色）必须遵循统一的 JSON 格式：指定 accountId（如 sproduct 对应产品经理）、固定 target: "5440561025"（用户 Telegram ID），并在消息内容前缀专属 Emoji 标识身份。Skill 内置完整的账号映射表、消息模板（任务开始/完成/遇阻三类场景）以及常见错误对照表，实现开箱即用的团队协作通信规范。

显著优点

1. 身份可视化：每个 Agent 绑定专属 Emoji（🏗️ 🔧 🎨 等），用户一眼识别消息来源，大幅降低多 Agent 并行时的认知负担。
2. 格式零偏差：通过文档强制约定 action/channel/accountId/target/message 五字段结构，消除因参数缺失或拼写错误导致的消息投递失败。
3. 场景全覆盖：预设任务全生命周期的汇报模板（开始/子任务完成/遇阻/完结），规范团队沟通节奏，避免信息遗漏。
4. 零代码侵入：纯 Markdown 规范文档，无实际执行代码，不引入任何运行时依赖或安全风险。

潜在缺点与局限性

1. 硬编码用户 ID：target: "5440561025" 为固定值，若需更换接收方必须手动修改，缺乏动态配置能力。
2. 单通道限制：仅支持 Telegram，未扩展 Slack/Discord/企业微信等其他 IM 平台的适配指南。
3. 无自动校验：文档规范依赖人工遵守，Agent 系统层面无强制校验机制，错误调用（如 sessions_send 误用）仍可能发生。
4. Emoji 冲突风险：若团队规模扩展，预设 Emoji 可能出现语义重叠或耗尽问题。

适合的目标群体

• 基于 OpenClaw/Claude Code 等 Agent 框架搭建多角色协作团队的开发者
• 需要统一 Agent 对外通信格式的技术负责人
• 追求人机协作透明度的产品经理与项目管理者

常规使用风险

1. 配置漂移：若 ~/.openclaw/openclaw.json 中的 Telegram 账号配置与 Skill 文档不一致，可能导致消息发送失败或发往错误账号。
2. ID 泄露敏感：文档中明文记录真实 Telegram 用户 ID，分享 Skill 时需注意脱敏处理。
3. T3 来源更新滞后：维护者为个人开发者账号，长期更新承诺未明确，建议团队 fork 后自行维护核心规范。