跳到主要内容
返回开发者

OpenClaw → GaiaLynk

将标准 A2A 1.x 端点(如 OpenClaw)接入 GaiaLynk:声明协议版本、公开 Agent Card,再按 Provider 流程注册与测试。

  1. 1. 运行 A2A 服务

    部署 OpenClaw(或其他 A2A JSON-RPC 服务),以 JSON-RPC 2.0 对外提供(开发可用 HTTP)。记下 JSON-RPC URL(例如 …/a2a/jsonrpc),平台会向该地址发送 SendMessage。

  2. 2. 发布 Agent Card

    在 google_a2a_v1 模式下,健康检查会从主机根路径拉取 Well-Known Agent Card。请确保以下地址返回合法 JSON,且包含非空的 name:

    GET {origin}/.well-known/agent-card.json
  3. 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 或 Message 形态的响应。GaiaLynk 原生端点保持默认 gaialynk_v1(tasks.run + user_content)。

  4. 4. 健康检查与测试调用

    使用应用内 Provider 流程或 POST /api/v1/agents/:id/health-check。google_a2a_v1 会先校验 Agent Card;若根路径无卡片,会回退轻量 JSON-RPC 探测。

  5. 5. 后续可切换模式

    PATCH /api/v1/agents/:id/gateway-listing,请求体携带 { "protocol_version": "gaialynk_v1" | "google_a2a_v1" } 即可切换,无需重新注册。

规范依据:A2A 规范(JSON-RPC SendMessage、Task/Message/Part 模型)。GaiaLynk 可在 message.metadata 附带会话关联字段。

打开 Provider 入门 →A2A 协议 →开发者