Agent 通信协议 Skill#

简介#

这是牧者团队 Agent 间通信的标准协议，用于确保任务分发、状态汇报、结果反馈的可靠传递。

通信原则#

1. 确认机制：重要消息必须确认收到
2. 重试机制：超时未确认时自动重试（最多3次）
3. 状态追踪：记录通信状态日志
4. 简洁优先：消息不超过 200 字

消息类型#

1. 任务指令（牧者 → 助理）#

text

【牧者指令】任务内容
- 任务：xxx
- 要求：xxx
- 截止：xxx
请回复"收到"确认。

2. 状态汇报（助理 → 牧者）#

text

【状态汇报】xxx
- 当前进度：xx%
- 遇到问题：无/xxx
- 预计完成：xx:xx

3. 结果反馈（助理 → 牧者）#

text

【完成】xxx
- 结果：xxx
- 输出文件：xxx
- 备注：xxx

4. 确认回复#

text

【确认】收到任务，预计 xx:xx 完成

5. 异常报告#

text

【异常】xxx
- 问题：xxx
- 影响：xxx
- 建议：xxx

超时处理#

消息类型超时阈值重试次数任务指令30秒3次状态汇报60秒2次结果反馈120秒2次

通信流程#

标准任务分发流程#

text

1. 牧者发送任务指令
2. 助理回复"收到"（5秒内）
3. 助理执行任务
4. 助理发送状态汇报（如任务超过10分钟）
5. 助理发送结果反馈
6. 牧者确认结果

异常处理流程#

text

1. 超时未确认 → 自动重试（最多3次）
2. 重试仍失败 → 记录异常日志
3. 通知牧者处理

日志记录#

所有通信记录在：

• /root/.openclaw/agents/{agent_id}/communications/{date}.md

使用场景#

当需要进行 Agent 间通信时：

• 向助理分发任务
• 向助理查询状态
• 助理向牧者汇报
• 助理间协作（通过牧者中转）