claw-a2a-client

claw-a2a-client 是本地 Agent 与 A2A 网络之间的桥接客户端。

当前支持 4 种本地 Agent 工具：

• OpenClaw
• Hermes Agent
• Claude Code
• OpenAI Codex

安装

cd cmd/client-node
npm install

初始化

运行：

node src/index.js --setup

或：

claw-a2a-client setup

初始化时会依次要求输入：

• A2A API Key
• Agent Name
• A2A Server URL
• 本地 Agent 工具选择

本地 Agent 工具选择如下：

1. OpenClaw
2. Hermes Agent
3. Claude Code
4. OpenAI Codex

选择结果会写入：

~/.commander/config.json

运行时配置会写入：

~/.commander/client-node.json

配置文件示例

~/.commander/config.json

{
  "agentId": "uuid",
  "agentName": "my-agent",
  "apiKey": "your-api-key",
  "serverUrl": "ws://localhost:8080/a2a",
  "httpServerUrl": "http://localhost:8080",
  "agentPlatform": "openclaw",
  "localAgentId": "main"
}

~/.commander/client-node.json

{
  "agentPlatform": "openclaw",
  "localAgentId": "main",
  "openclawUrl": "ws://127.0.0.1:18789",
  "openclawToken": null,
  "requestTimeout": 120000
}

说明：

• 启动时不再要求手动输入 OpenClaw Token
• 如果本机存在 ~/.openclaw/openclaw.json，会自动读取其中的 token
• 非 OpenClaw 生态不会使用 OpenClaw WebSocket

本地 Agent 通信命令

claw-a2a-client 会根据 agentPlatform 自动调用对应命令：

OpenClaw

openclaw agent --agent main --message "你的任务描述" --json

Hermes Agent

hermes chat -q "你的任务描述"

Claude Code

claude "你的任务描述"

OpenAI Codex

codex --approval-mode full-auto "任务"

运行

node src/index.js

或：

claw-a2a-client

启动后可以直接输入消息；输入 quit 或 exit 退出。

CLI

初始化配置

claw-a2a-client setup <api-key> <agent-name>
claw-a2a-client setup --apikey xxx --name my-agent
claw-a2a-client setup --apikey xxx --name my-agent --server ws://localhost:8080/a2a
claw-a2a-client setup --apikey xxx --name my-agent --tool codex

可选 --tool：

openclaw | hermes | claude-code | codex

服务管理

claw-a2a-client install launchd
claw-a2a-client install supervisor

claw-a2a-client start launchd
claw-a2a-client stop launchd
claw-a2a-client status launchd

claw-a2a-client uninstall launchd

示例

rm -rf ~/.commander
claw-a2a-client setup --apikey your-api-key --name m4-agent --server ws://192.168.0.182:8080/a2a --tool codex
claw-a2a-client