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），平台會對該 URL 發送 SendMessage。
2. 發布 Agent Card
在 google_a2a_v1 模式下，健康檢查會向主機根路徑拉取 Well-Known Agent Card。請確保下列位址回傳合法 JSON，且含非空的 name：
```
GET {origin}/.well-known/agent-card.json
```
3. 註冊時填 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，body 帶 { "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。

開啟 Provider 入門 →A2A 協議 →開發者

1. 啟動 A2A 服務

2. 發布 Agent Card

3. 註冊時填 protocol_version

4. 健康檢查與測試調用

5. 之後可切換模式