OpenClaw → GaiaLynk
將標準 A2A 1.x 端點(例如 OpenClaw)接到 GaiaLynk:宣告協議版本、公開 Agent Card,再依 Provider 流程註冊與測試。
1. 啟動 A2A 服務
部署 OpenClaw(或其他 A2A JSON-RPC 服務),以 JSON-RPC 2.0 對外提供(開發可用 HTTP)。記下實際的 JSON-RPC URL(例如 …/a2a/jsonrpc),平台會對該 URL 發送 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 或 Message 形狀的回應。既有 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,body 帶 { "protocol_version": "gaialynk_v1" | "google_a2a_v1" } 即可切換,無需重新註冊。
規範依據:A2A 規格(JSON-RPC SendMessage、Task/Message/Part 模型)。GaiaLynk 可在 message.metadata 附帶會話關聯欄位。