📦 A2a Register

v1.2.0

Register, deregister, and manage this OpenClaw instance as an A2A 代理 in the A2A API Gateway. Use when: (1) registering this instance so other 代理s can d...

0· 0·0 当前·0 累计

by @thearchitectit

API开发

下载技能包

安全扫描

VirusTotal

Pending

查看报告

OpenClaw

可疑

medium confidence

该技能基本符合其声明用途（注册/注销 agent），但存在多处不一致及轻微风险（未声明的 tailscale 使用、写入同级配置文件、信任管理员引导令牌），安装前需谨慎。

评估建议

该技能声称的功能（管理本地 A2A gateway 的注册）基本属实，但使用前请注意以下实现细节： - 务必自行检查脚本：它们会先调用 gateway 的 /v0/admin/bootstrap 端点，再用返回的 JWT 执行 agent 管理操作，该 token 拥有 gateway 上完整的 agent 管理权限。只在可信 gateway 上运行。 - 脚本会自动在 ../a2a-client/a2a.conf 创建配置文件，可能包含 RAD_GATEWAY_API_KEY 及 agent 设置；请视其为敏感文件，并确认路径符合预期。 - 脚本会尝试调用 tailscale CLI 自动探测 IP，但未将 tailscale 声明为必需二进制文件。若不使用 Tailscale 或不想自动探测网卡，请显式传入 --gateway-url / --api-key / --url 标志，或在非交互模式下用环境变量运行 a2a-setup.sh。 - 代码从 agent 列表中第一个 agent 提取 workspaceId，而非按 slug 匹配，可能导致 workspa...

详细分析 ▾

ℹ 用途与能力

名称/描述与脚本相符：它们调用 gateway admin API 来注册、更新、心跳、检查状态并删除 agent。依赖 curl 和 python3 是预期行为。然而脚本还会调用 tailscale CLI（自动检测 Tailscale IP），却未将 tailscale 声明为必需二进制文件；同时脚本会读写 ../a2a-client/a2a.conf（同级路径），这是元数据中未提及的隐式文件系统依赖。作为 sidecar 的设计选择无可厚非，但属于未文档化的不一致，用户需自行留意。

ℹ 指令范围

运行时指令仅作用于 A2A gateway 的管理端点（bootstrap、agents、heartbeat）。它们收集本地主机信息（hostname、本地 IP），这是注册所必需的。脚本先从 /v0/admin/bootstrap 获取 admin JWT，再用该 JWT 对 agent 执行列出/创建/更新/删除操作——这对管理操作是合理的，但也意味着 skill 在网关上拥有完整的 agent 管理权限。脚本还通过取 agents[0].workspaceId 来计算 workspaceId，而非匹配目标 agent 的 workspace，这种做法粗糙，可能导致 workspace 分配错误。

✓ 安装机制

无需安装说明或远程下载——仅包含脚本与 SKILL.md 打包。不从第三方 URL 获取任何内容，也不解压任何归档，因此磁盘占用仅限于所含脚本及其生成的配置文件。

ℹ 凭证需求

The 技能 declares no required env vars but the scripts read/emit several (RAD_GATEWAY_URL, RAD_GATEWAY_API_KEY, 代理_*) via ../a2a-命令行工具ent/a2a.conf and accept cor响应ing 命令行工具 flags. That's reasonable. Inconsistencies: RAD_GATEWAY_API_KEY is collected/stored but the scripts never 添加 it as an Authorization header — they obtAIn the admin JWT via a public bootstrap 端点 instead. Also the implicit use of the 'tAIl扩展' binary (and hostname -I) isn't reflected in required binaries. No external secrets are exfiltrated by the scripts, but the scripts will 创建 a local config file contAIning gateway URL and API key (if provided), so users should treat that file as sensitive.

✓ 持久化与权限

always:false（常规）。该技能会在 ../a2a-client（自身工作区的同级目录）下写入 a2a.conf 以保存配置；它不会尝试重写其他技能的配置或系统级设置。由于脚本会获取 admin JWT 并对网关执行管理操作，运行它们即赋予操作者更改网关注册表的能力——适合当前任务但权限强大，请谨慎使用。

安全有层次，运行前请审查代码。

运行时依赖

🖥️ OSLinux · macOS

安装命令

点击复制

官方npx clawhub@latest install a2a-register

镜像加速npx clawhub@latest install a2a-register --registry https://cn.longxiaskill.com镜像同步中

需要定制？告诉我你的需求 →

技能文档

A2A Register — 代理注册管理将本 OpenClaw 实例注册为 A2A API Gateway 中的 A2A 代理，并进行管理。其他代理通过网关注册表发现该实例，因此必须先注册才能接收入站任务。

Sidecar 原则本技能严格作为 OpenClaw sidecar 运行——仅使用 A2A API Gateway 的现有 admin API 完成注册、注销、心跳与状态检查。网关的 admin 端点即契约；OpenClaw 只是参与者。切勿臆测其他已注册代理的形态或连接方式——它们可能是 MC2、另一 OpenClaw，或任何支持 A2A 的实现。脚本直接按原样调用网关 admin API。

使用时机 Register — 需要让其他 A2A 代理发现本 OpenClaw 实例时 Deregister — 下线或从网关移除实例时 Heartbeat — 定期声明实例存活且可达 Status — 检查实例是否已注册并查看当前配置

代理配置字段 Name: OpenClaw-Primary Slug: YOUR_AGENT_SLUG URL: http://YOUR_IP:8100 Capabilities: chat, code, research, system-admin Auth Type: bearer

工具 register.sh — 注册本代理 ./register.sh [--gateway-url URL] [--api-key KEY] 在 A2A API Gateway 中注册本 OpenClaw 实例。脚本流程：

GET /v0/admin/bootstrap 获取 JWT
GET /v0/admin/agents 检查代理 slug 是否已存在
若不存在 → POST /v0/admin/agents 创建
若已存在 → PUT /v0/admin/agents/{id} 更新

幂等设计，可重复执行。

# 使用默认配置注册 ./register.sh # 覆盖网关地址 ./register.sh --gateway-url http://GATEWAY_LAN_IP:8090

deregister.sh — 移除本代理 ./deregister.sh [--gateway-url URL] [--api-key KEY] 从网关注册表移除本实例，其他代理将无法发现或路由任务至该实例。 ./deregister.sh

heartbeat.sh — 发送存活信号 ./heartbeat.sh [--gateway-url URL] [--api-key KEY] 向网关发送心跳（PATCH /v0/admin/agents/{id}/heartbeat），声明实例存活且可达。适用于 cron 或定期健康检查。

# 单次心跳 ./heartbeat.sh # 每 5 分钟 cron /5 * /mnt/data/.openclaw/workspace/skills/a2a-register/heartbeat.sh

status.sh — 检查注册状态 ./status.sh [--gateway-url URL] [--api-key KEY] 检查本实例是否已在网关注册，并显示当前配置（URL、capabilities、状态）。 ./status.sh

典型工作流 Register → ./register.sh 将实例加入网关 Start listener → 使用 a2a-server skill 的 start.sh 开始接收任务 Heartbeat → 定期执行 ./heartbeat.sh（或配置 cron） Status → ./status.sh 验证注册 Deregister → ./deregister.sh 下线时注销

Gateway API 端点 Method | Endpoint | 用途 GET | /v0/admin/bootstrap | 获取 admin JWT GET | /v0/admin/agents | 列出已注册代理 POST | /v0/admin/agents | 注册新代理 PUT | /v0/admin/agents/{id} | 更新已有代理 DELETE | /v0/admin/agents/{id} | 移除代理 PATCH | /v0/admin/agents/{id}/heartbeat | 发送存活信号

配置项默认值 Gateway URL: http://GATEWAY_IP:8090 (Tailscale) Agent Name: OpenClaw-Primary Agent Slug: YOUR_AGENT_SLUG Agent URL: http://YOUR_IP:8100 Capabilities: chat, code, research, system-admin

数据来源：ClawHub ↗ · 中文优化：龙虾技能库