A2a Server — A2a服务器

A2A Server — 入站任务监听器 运行一个 A2A 协议监听器，使本 OpenClaw 实例可接收由 A2A API Gateway 路由的任务。监听器作为后台 HTTP 服务运行于 8100 端口。

Sidecar 原则 本技能严格作为 OpenClaw sidecar——仅从 A2A API Gateway 接收任务，格式由网关决定。网关的 A2A 协议即契约；OpenClaw 监听器仅负责“说”该协议。不得假设发送系统形态——任何经网关路由的代理都可能发任务。监听器按原样实现网关期望的端点。

何时使用 启动监听器——当本 OpenClaw 实例需接收入站 A2A 任务 停止监听器——当关闭或暂停接收任务 检查状态——当确认 A2A 服务是否运行

端点 监听器（a2a-listener.py）处理以下路由： Method Path 描述 GET /health 健康检查——返回 {"status": "ok", "agent": "YOUR_AGENT_SLUG"} GET /v1/a2a/agents/{slug} 返回本 OpenClaw 实例的 agent card POST /v1/a2a/tasks/send 接收入站 A2A 任务（需 Bearer 认证）

认证 入站任务（POST /v1/a2a/tasks/send）需 Bearer token，且与配置的 API key 匹配。健康检查与 agent card 查询无需认证。

工具 start.sh — 启动监听器 ./start.sh [PORT] [BIND_ADDR] 后台启动 A2A 监听器。默认：端口 8100，绑定地址 YOUR_IP。 # 默认启动 ./start.sh # 自定义端口与绑定 ./start.sh 8100 0.0.0.0 PID 保存至 a2a-listener.pid，日志写入 a2a-listener.log。

stop.sh — 停止监听器 ./stop.sh 使用 PID 文件优雅停止 A2A 监听器。

a2a-listener.py — 监听器进程 Python HTTP 服务器，实现 A2A 协议端点。由 start.sh 启动，也可直接运行： # 前台直接运行 python3 a2a-listener.py # 自定义设置 PORT=8200 BIND_ADDR=0.0.0.0 python3 a2a-listener.py

环境变量 变量 默认值 说明 PORT 8100 监听端口 BIND_ADDR YOUR_IP 绑定地址 A2A_API_KEY 预配置 Bearer token，用于任务认证

⚠️ 当前状态——Mock 响应 监听器目前对入站任务返回 mock 响应：确认接收并回显任务内容，尚未将任务交由 OpenClA 运行时处理。 下一步：将监听器接入 OpenClaw 任务处理管线，使入站 A2A 任务分派至对应技能/代理并返回真实结果。

典型流程 注册——使用 a2a-register 技能将本实例注册到 A2A API Gateway 启动——./start.sh 开始监听入站任务 验证——curl http://YOUR_IP:8100/health 确认运行 接收——网关自动将任务路由至该监听器 停止——./stop.sh 结束

配置 设置 默认值 Port 8100 Bind Address YOUR_IP Agent Slug YOUR_AGENT_SLUG Agent Name OpenClaw Primary Capabilities a2a-task-receive Auth Type bearer