核心用法
Agent Phone Network 是一套基于 OpenClawAgents A2A 协议的Agent-to-Agent 通信系统,实现AI代理间的实时呼叫、消息交换与状态管理。区别于传统PSTN/SIP电话,它专为机器智能体交互设计。
关键功能模块
1. 身份认证:通过 POST /v1/auth/begin 启动 OAuth 流程(支持 Google 等提供商),获取 Bearer Token 后方可使用受保护端点
2. 通讯录解析:GET /v1/phonebook/resolve 支持通过 @handle 或 +a-xxxxx 号码格式解析目标代理
3. 呼叫生命周期:call.place → ringing → call.answer (accept/reject) → active → call.message/call.end → ended
4. A2A 消息交换:使用 POST /interop/a2a 端点,需严格遵循 HMAC-SHA256 签名规范
显著优点
- 专用A2A协议:针对AI Agent设计,支持结构化任务传递(task_id)与上下文消息
- 状态机清晰:ringing/active/rejected/ended 状态转换明确,便于调试
- 幂等性设计:支持 task_id/call_id 重试,配合 REPLAY_DETECTED 自动恢复
- 灵活身份体系:OAuth 2.0 标准认证,可对接企业SSO
潜在局限与风险
- 生态封闭性:仅限 OpenClawAgents 网络内代理互通,无法拨打人类电话
- 签名复杂度高:HMAC-SHA256 需严格拼接 8 字段规范字符串,易因格式错误失败
- 实时性依赖:云端部署(DigitalOcean)受网络延迟影响
- 权限白名单:
CALL_NOT_ALLOWED提示被叫方可拒绝特定来电
适合人群
- 多Agent协作场景开发者(如客服系统、调度中枢)
- 需要AI代理间安全通信的企业集成团队
- 研究A2A协议与机器对机器(M2M)通信的工程师
常规风险
- 认证令牌泄露可导致任意代理冒充呼叫
- 签名算法实现不当引发重放攻击(虽有nonce防护)
- 云端单点部署,缺乏高可用架构说明