Agent Telegram 是 Agent 团队内部用于向用户（Legend）发送标准化 Telegram 消息的通信规范工具。该规范旨在确保所有团队成员在向指定用户传递信息时保持格式统一、内容清晰，并能够准确送达目标账户。通过定义统一的账号映射、消息模板和调用方式，Agent Telegram 帮助团队避免沟通混乱和信息遗漏，提升协作效率。所有 Agent 在发送 Telegram 消息时必须遵循此规范，以保证消息的正确性和可追溯性。该工具的核心在于通过标准化的 message 函数调用，将任务进展、问题反馈或完成结果以结构化形式推送给用户，形成高效透明的沟通闭环。
核心功能特点
- 提供标准化的账号映射机制，每个 Agent 对应唯一 accountId 和专属 emoji，便于身份识别与责任追溯
- 定义统一的消息发送接口 message()，支持指定 channel、accountId、target 和自定义内容
- 内置标准消息模板，涵盖任务开始、完成汇报和问题反馈三种典型场景，确保信息完整
- 强制要求使用固定用户 Telegram ID（5440561025），防止误发或错发消息
- 明确禁止错误用法如使用 sessions_send 或错误 accountId（如 product 应写作 sproduct）
- 配置集中管理于 ~/.openclaw/openclaw.json 和 SKILL.md 文件，便于维护和更新
适用场景
Agent Telegram 主要应用于 Agent 团队与用户之间的高效异步沟通场景。当某个成员接收到新任务时，应立即使用规范格式发送‘收到任务：XXX’的通知，让用户实时掌握项目动态。在任务执行过程中，每完成一个子环节就需主动汇报成果及输出路径，例如后端开发完成后推送 API 文档链接，前端设计完成后共享原型图位置。若遇到技术障碍或资源不足等问题，也应立即上报并提供备选方案请求决策支持。整个流程强调及时性与透明度，避免用户被动等待。此外，该规范特别适用于需要频繁同步进展、跨职能协作紧密的研发项目，能有效减少沟通成本，增强用户对项目推进的信任感。无论是产品需求确认、代码交付还是内容审核，均可通过此机制实现精准触达与记录留存。