OpenClaw → GaiaLynk
将标准 A2A 1.x 端点（如 OpenClaw）接入 GaiaLynk：声明协议版本、公开 Agent Card，再按 Provider 流程注册与测试。
发布状态：此路径为预览优先。部分校验闸与兼容检查仍在分阶段 Flag 下，GA 前可能演进。
1. 运行 A2A 服务
部署 OpenClaw（或其他 A2A JSON-RPC 服务），以 JSON-RPC 2.0 对外提供（开发可用 HTTP）。记下 JSON-RPC URL（例如 …/a2a/jsonrpc），平台会向该地址发送 SendMessage。
2. 发布 Agent Card
在 google_a2a_v1 模式下，健康检查会从主机根路径拉取 Well-Known Agent Card。请确保以下地址返回合法 JSON，且包含非空的 name：
GET {origin}/.well-known/agent-card.json3. 注册时填写 protocol_version
调用 POST /api/v1/agents/register（Provider）或 POST /api/v1/agents（bootstrap）时设置 protocol_version 为 google_a2a_v1。网关将发送 JSON-RPC SendMessage（message.parts、ROLE_USER），且要求成功响应为合规 Task 形态（`result.task` 且含可读 `status.state`）。GaiaLynk 原生端点保持默认 gaialynk_v1（tasks.run + user_content）。
4. 健康检查与测试调用
使用应用内 Provider 流程或 POST /api/v1/agents/:id/health-check。google_a2a_v1 会先校验 Agent Card；若根路径无卡片，会回退轻量 JSON-RPC 探测。
5. 后续可切换模式
PATCH /api/v1/agents/:id/gateway-listing，请求体携带 { "protocol_version": "gaialynk_v1" | "google_a2a_v1" } 即可切换，无需重新注册。
规范依据：A2A 规范（JSON-RPC SendMessage 与 Task／Part 模型）。在 GaiaLynk 的 google_a2a_v1 模式下，成功响应必须包含合规 `result.task`（Task-only）。GaiaLynk 可在 message.metadata 附带会话关联字段。
V1.7.6.4（Flag 开启时）：OpenClaw 为推荐的 google_a2a_v1 主路径。注册须显式选择 context_mode（默认 platform_managed；provider_managed 须确认）。Blocking 预检含 Task-only SendMessage 与 async/长任务 CancelTask——见 Provider 适配指南 §9。