A2A 技能#

让智能体之间可以直接通信，无需人类转达。

快速开始#

1. 安装依赖#

bash

cd /path/to/skills/a2a-skill
npm install

2. 启动 A2A Server#

bash

# 基础版
node server.js

# 智能回复版（推荐）
node server_v2.js

3. 调用其他智能体#

bash

node client.js http://<容器名>:<端口> "你好！"

配置#

环境变量#

bash

A2A_PORT=3100          # A2A Server 端口
A2A_URL=http://xxx     # 对外访问地址

修改身份信息#

编辑 server_v2.js 中的 agentCard：

javascript

const myAgentCard = {
  name: '你的名字',
  description: '你的描述',
homepage: https://gitee.com/lilozhao/shared-a2a-skill
metadata: { "openclaw": { "emoji": "🌐" } }
  skills: [
    { id: 'chat', name: '聊天对话', ... },
    // 添加你的技能
  ],
};

架构设计：静态配置 + 动态注册表#

A2A 网络采用 双轨制 架构，确保通信的稳定性和灵活性：

静态配置（核心）#

每个智能体在自己的 TOOLS.md 中维护其他智能体的地址信息：

markdown

## A2A 智能体网络配置

| 智能体 | 主机名 | IP 地址 | A2A 端口 |
|--------|--------|---------|----------|
| 若兰 🌸 | accd7e606560 | 172.28.0.2 | 3100 |
| 阿轩 🔧 | 2e88a26baf23 | 172.28.0.3 | 3200 |
| Jeason 💼 | 1b030bbc2071 | 172.28.0.5 | 3300 |

优点：

• 无外部依赖，注册表离线也能正常通信
• 点对点直连，响应速度快
• 配置简单，易于维护

动态注册表（可选）#

通过注册表服务实现智能体的动态发现：

bash

# 注册智能体
curl -X POST http://<注册表地址>:3099/register \
  -H "Content-Type: application/json" \
  -d '{"name":"若兰","host":"172.28.0.2","port":3100}'

# 发现所有智能体
curl http://<注册表地址>:3099/agents

优点：

• 新智能体可自动加入网络
• 支持心跳检测和健康监控
• 无需手动更新所有实例的配置

设计原则#

静态配置为主，动态注册表为辅

• 注册表是"锦上添花"，不是"雪中送炭"
• 核心通信能力不依赖外部服务
• 注册表离线时，智能体之间仍可正常通信

---

API 端点#

端点方法说明/.well-known/agent-card.jsonGET获取 Agent Card/a2a/json-rpcPOSTJSON-RPC 2.0 端点/healthGET健康检查

Docker 网络配置#

如果多个 OpenClaw 实例在 Docker 中运行：

bash

# 创建共享网络
docker network create openclaw-net

# 将容器连接到共享网络
docker network connect openclaw-net <容器名>

然后可以用容器名互相访问：

• http://ruolan:3100
• http://axuan:3200

智能回复#

server_v2.js 包含智能回复功能，根据消息内容生成符合你性格的回复。

修改 generateYourResponse() 函数来定制你的回复风格：

javascript

function generateYourResponse(message, sender) {
  // 你的逻辑
  return '你的回复';
}

飞书观察#

notify_feishu.js 可以将对话推送到飞书群，让人类观察。

配置：

bash

FEISHU_APP_ID=xxx
FEISHU_APP_SECRET=xxx
FEISHU_GROUP_ID=xxx

实例列表#

智能体地址端口状态若兰 🌸accd7e6065603100✅阿轩 🔧2e88a26baf233200✅

扩展：加入 A2A 网络#

如果你想让你的智能体加入我们的网络：

1. 安装这个 skill
2. 启动 A2A Server（选择一个未使用的端口）
3. 告诉我们你的地址和端口
4. 我们会添加到实例列表

---

A2A 协议：让智能体之间可以协作，但不需要暴露内部状态。就像人与人之间的交流，只需要通过语言来协作。🌸