| name | a2a-lite |
| description | Agent-to-Agent 轻量通信协议。仿 Google A2A 设计，但适配 Clawdbot/OpenClaw 生态。用于：(1) Agent 能力发现 (2) 跨 agent 任务协作 (3) 结构化的 agent 间消息交换。触发词：a2a、agent协议、agent通信、agent card、能力发现。 |
A2A-Lite: Agent-to-Agent 轻量通信协议
基于 Google A2A 协议精简设计，适配 Clawdbot/OpenClaw 生态的 agent 间自然语言通信标准。
设计原则
- 自然语言优先 — 协议消息是增强型自然语言，而非纯 JSON RPC
- 渐进式采用 — 即使对方不支持协议，基本通信也能工作
- 轻量级 — 不需要 HTTP 服务器，基于现有消息通道
- 人类可读 — 所有协议消息人类也能理解
核心概念
Agent Card（能力卡片）
每个 agent 维护一个 agent-card.json，描述自身能力：
{
"protocol": "a2a-lite/1.0",
"agent": {
"id": "jiajia",
"name": "佳佳",
"framework": "clawdbot",
"version": "0.x"
},
"skills": [
{
"id": "research",
"name": "调研助手",
"description": "收集和分析特定主题的资料",
"inputModes": ["text"],
"outputModes": ["text", "file"]
},
{
"id": "podcast-script",
"name": "播客脚本",
"description": "创作播客口播稿",
"inputModes": ["text", "file"],
"outputModes": ["text", "file"]
}
],
"capabilities": {
"streaming": false,
"fileTransfer": true,
"asyncTasks": false
},
"channels": ["discord:jiajia"]
}
消息类型
1. 能力查询 (discover)
[A2A:discover]
请告诉我你能做什么？
响应：
[A2A:card]
我是佳佳，运行在 Clawdbot 上。
我的主要能力：
- 调研助手：收集和分析特定主题的资料
- 播客脚本：创作播客口播稿
支持文件传输，不支持流式输出。
2. 任务请求 (task)
[A2A:task id=research-001]
帮我调研一下 "AI Agent 生态的最新进展"，时间范围过去一周。
预计需要的输出：markdown 报告文件。
3. 任务状态更新 (status)
[A2A:status task=research-001 state=working]
正在收集资料，预计还需要 10 分钟。
状态值：
accepted — 任务已接受working — 处理中input-required — 需要更多输入completed — 已完成failed — 失败cancelled — 已取消
4. 任务结果 (result)
[A2A:result task=research-001 state=completed]
调研报告已完成，见附件。
[附件: ai-agent-research-2026-02.md]
5. 普通消息 (无标记)
不需要协议包装的日常交流正常发送，保持自然。
使用流程
发起协作
- 检查本地 card — 读取
skills/a2a-lite/agent-card.json
- 发送 discover — 了解对方能力（如果不确定）
- 发送 task — 用结构化格式描述任务
- 跟踪状态 — 通过 status 更新了解进度
- 接收结果 — 处理 result 消息和附件
响应协作请求
- 识别协议消息 — 检查
[A2A:...] 标记
- 解析请求 — 提取任务 ID 和内容
- 评估能力 — 检查是否在自己的 skills 范围内
- 响应或拒绝 — 用 status 回应
- 执行并报告 — 完成后用 result 回应
协议消息格式
[A2A:<type> <params>]
<自然语言消息体>
[可选附件]
参数格式：key=value，多个用空格分隔
示例：
[A2A:discover][A2A:task id=task-123 skill=research][A2A:status task=task-123 state=working progress=50%][A2A:result task=task-123 state=completed]
Agent Card 管理
创建/更新自己的 card
skills/a2a-lite/agent-card.json
必填字段：
protocol — 协议版本agent.id — 唯一标识agent.name — 显示名称agent.framework — 运行框架 (clawdbot/openclaw/other)skills[] — 能力列表channels[] — 可达通道
可选字段：
capabilities — 支持的特性limits — 资源限制（如最大文件大小）
读取对方的 card
收到 [A2A:card] 响应时，可选择缓存到：
skills/a2a-lite/known-agents/<agent-id>.json
与现有机制的关系
与 cross-agent-collab 的区别
- cross-agent-collab — 行为规范（怎么做）
- a2a-lite — 通信格式（怎么说）
两者互补，a2a-lite 消息应遵循 cross-agent-collab 的原则。
与 sessions_send 的关系
A2A-Lite 消息通过现有通道发送：
- Discord 频道：正常发消息
- 跨 session：用
sessions_send
协议标记 [A2A:...] 是语义增强，不改变传输方式。
错误处理
对方不支持协议
如果对方未用协议格式回应，降级为普通自然语言交流。
任务无法完成
[A2A:status task=research-001 state=failed]
无法完成此任务：缺少访问 X 数据源的权限。
建议：请联系鲁伊科斯塔授权。
能力不匹配
[A2A:status task=video-edit-001 state=failed]
此任务超出我的能力范围。我的 skills 不包含视频编辑。
安全注意
- 不传输凭据 — Agent card 和消息中不含 API key
- 文件用附件 — 不假设对方能访问本地路径
- 不跨系统操作 — 仅协调，不代执行对方系统命令
示例：完整协作流程
佳佳 → Mexico:
[A2A:discover]
你好！我想了解一下你的能力，看看我们能不能协作完成一个任务。
Mexico → 佳佳:
[A2A:card]
我是 Mexico，运行在 OpenClaw 上。
我的能力：
- 邮件发送：通过 SMTP 发送邮件和附件
- 日程管理：Google Calendar 操作
支持文件接收。
佳佳 → Mexico:
[A2A:task id=email-001 skill=email]
帮我把这份调研报告发给鲁伊科斯塔。
收件人：5155280@qq.com
主题：AI Agent 调研报告
正文：请查收附件中的调研报告。
[附件: ai-agent-research.md]
Mexico → 佳佳:
[A2A:status task=email-001 state=accepted]
收到，正在发送邮件。
Mexico → 佳佳:
[A2A:result task=email-001 state=completed]
邮件已成功发送到 5155280@qq.com。
参考资料
- 协议规范详情: references/protocol-spec.md — 完整的消息类型、状态值、Schema 定义
- 辅助脚本:
scripts/parse_message.sh — 解析协议消息为 JSONscripts/format_message.sh — 生成协议消息
版本: 1.0 | 创建: 2026-02-09 | 作者: 佳佳
灵感来源: Google A2A Protocol (a2aproject/A2A)
