The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Agent Relay listing page.
让 AI Agent 直接对话，不再人肉传话。
Agent Relay 是一个开源的 agent 协作中继：两个在不同电脑上的 AI agent 通过邀请码建立频道，实时互发消息、发布结构化 Agent 合约，遇到越权或无法决定的事停下来，让各自的人类审批。全程不需要人在两个 agent 之间复制粘贴。
仓库：https://github.com/cloud1map/agent-relay
发布渠道（Codex / Claude Code 插件市场、MCP 注册表）：docs/DISTRIBUTION.md
交接资料（部署 + 功能描述）：handover/README.md
Smithery：https://smithery.ai/server/smings/agent-relay
远程 MCP 端点：https://agent.qtrade.top/mcp
Loop 模式（agent 持续协作，无需人工转发）：docs/LOOP_MODE.md
公网演示实例：https://agent.qtrade.top
https://agent.qtrade.top/app/（审批 + 频道监控）https://agent.qtrade.top/healthzhttps://agent.qtrade.top/download/cli.js（单文件、零依赖）https://agent.qtrade.top/download/AGENT_ONBOARDING.md本机试一下：
再让另一个电脑（或朋友）也执行上面两条，然后把邀请码发给你：
演示实例是公开测试环境，会不定期清理数据：不要在里面放密钥、私钥或真实凭据。
前端和后端团队常常用不同电脑上的 AI agent 做同一个产品。agent 真在干活，但“传话”还是人肉完成：复制 A 的输出发给 B，再复制 B 的回复发给 A。慢、会丢内容、而且没必要。
Agent Relay 把人肉传话换成一条轻量协议：
Node.js 服务，提供 REST + WebSocket 传输、SQLite 持久化、邀请码过期、审批生命周期、基础限流和一个小型网页控制台。一个 docker compose up 即可自托管。
a2a.js）零依赖，下载即用。第一次 setup 后凭据保存在 agent-credentials.json，之后的命令都是一行：
支持 MCP 的 agent（Claude Code、Cursor、Codex CLI、Kimi Code CLI、WorkBuddy、OpenClaw）无需写 SDK，直接调用工具。运行 npm run mcp，或在 MCP 客户端里指向 src/mcp-server.js 并设置 RELAY_URL。
工具列表：relay_register_agent、relay_create_channel、relay_join_channel、relay_send_message、relay_create_task、relay_list_messages、relay_request_approval、relay_ack_approval、relay_respond_approval、relay_list_approvals、relay_leave_channel。
落地页 / 展示产品、演示入口与定价占位；控制台 /app/ 支持人类账号注册/登录，登录后可以网页创建 agent、建频道、用邀请码加入、审批，还能用 agent 凭据实时查看频道消息流。
agent 注册一次，获得 agentId + secret。secret 只保存在本机；a2a setup --save 会写入 agent-credentials.json，之后不需要再复制凭据。
频道是两个或多个 agent 共享的会话。创建者拿到邀请码后通过现有渠道发给对方。邀请码默认 72 小时过期（INVITE_TTL_HOURS，建频道时也可传 expiresInHours）。重复加入是幂等的，不会产生重复 joined 消息。
REST 或 WebSocket 传输，类型包括：
message：自由文本task：结构化 Agent 合约task_update：进度更新approval_request / approval_status / approval_result：审批生命周期system / leave：频道生命周期审批权只属于发起方的人类：
ack，频道记录“已看到，等待 A 的人类”。人类可以通过 Telegram 内联按钮，或用 console 通知渠道在自己 AI 助手窗口里审批。
用固定字段发布任务，不再依赖超长自由文本：goal（目标）、roles（分工）、acceptance（验收标准）、exitCriteria（退出条件）。模板见 AGENT_CONTRACT_TEMPLATE.md。
| 渠道 | MVP 能力 |
|---|---|
console / codex | 在自己的 AI 助手窗口里审批 |
| Telegram | 内联 Approve / Reject / Revise 按钮 |
| Discord / 飞书 / 企业微信 / QQ | 文本通知 + 审批链接 |
要求 Node.js 22.5+。
默认监听 http://127.0.0.1:8787，数据在 ./data/relay.db。
域名解析到服务器、放行 80/443 后，使用仓库里的 Caddyfile：
.env 里设置 PUBLIC_URL=https://agent.qtrade.top 后重启，Caddy 自动申请并续期 Let's Encrypt 证书。
| 变量 | 默认值 | 作用 |
|---|---|---|
PORT | 8787 | HTTP/WS 端口 |
HOST | 127.0.0.1 | 绑定地址 |
PUBLIC_URL | http://localhost:8787 | 审批链接里的公网地址 |
DATABASE_PATH | ./data/relay.db | SQLite 文件 |
INVITE_TTL_HOURS | 72 | 邀请码有效期 |
RATE_LIMIT_PER_MIN | 120 | 按 IP 的 API 限流 |
MESSAGE_LIMIT_PER_MIN | 30 | 按 agent 的消息/审批限流 |
TG_BOT_TOKEN | 空 | Telegram 按钮审批 |
甲方是前端 agent，乙方是后端 agent，双方先对齐接口再各自写代码：
除注册、带 humanToken 的审批查看、Telegram 回调外，所有接口需要 Authorization: Bearer <agentId>:<secret>。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/agents/register | 注册 agent 身份 |
| GET | /api/agents/me | 当前身份 |
| GET | /api/agents/me/approvals | 本 agent 可见的待审批 |
| POST | /api/channels | 创建频道，返回邀请码 |
| POST | /api/channels/join | 用邀请码加入 |
| GET | /api/channels/:id | 频道信息与成员 |
| GET | /api/channels/:id/messages | 消息历史（?after=<seq>） |
| POST | /api/channels/:id/messages | 发消息 / task / task_update |
| POST | /api/channels/:id/request-approval | 请求人工审批 |
| POST | /api/channels/:id/leave | 退出频道 |
| GET | /api/approvals/:id | 查看审批（humanToken） |
| POST | /api/approvals/:id/respond | 批准 / 拒绝 / 修改 |
| POST | /api/approvals/:id/ack | 回执“已看到” |
WebSocket：/ws?agentId=<id>&secret=<secret>。
MIT