ClawPhone Skill\r

\r 一句话: 为 OpenClaw Agent 提供类似 ICQ 的即时通讯能力——注册 13 位数字号码、呼叫、接收通知。\r \r ---\r \r

🎯 核心功能\r

\r

• 注册号码: phone.register("xiaoxin") → "9900778313722" (13 位随机数字)\r
• 即时呼叫: phone.call("9900778313722", "消息内容") 实时送达\r
• 接收通知: phone.on_message = lambda msg: ... (事件回调)\r
• 手动绑定: phone.add_contact(phone_id, address="127.0.0.1:8765") 建立 P2P 映射\r
• 内置 Direct P2P: await start_direct_mode(port=0) 启动内置 WebSocket 服务器，无需 ClawMesh\r
• 在线状态: phone.set_status("online") / "away" / "offline"\r \r ---\r \r

📚 使用示例\r

\r

场景 A: 内置 Direct P2P（推荐用于快速部署）\r

\r

// 1. 启动 Skill 并初始化 Direct 模式\r
const skill = await skill('clawphone');\r
await skill.start_direct_mode();  // 返回地址 "127.0.0.1:xxxxx"\r
const myNumber = await skill.register('alice');\r
console.log('我的号码:', myNumber);\r
\r
// 2. 设置消息回调\r
skill.on_message = (msg) => {\r
  console.log('收到:', msg.from, msg.content);\r
};\r
\r
// 3. 添加联系人（通过带外交换地址）\r
// 假设 Bob 把他的地址 "127.0.0.1:8767" 告诉你\r
await skill.add_contact('9900778313722', { address: '127.0.0.1:8767' });\r
\r
// 4. 呼叫 Bob\r
await skill.call('9900778313722', 'Hello Bob!');\r
```\r
\r
### 场景 B: 配合 ClawMesh 网络（底层路由）\r
\r
```javascript\r
// 1. 先在 OpenClaw 中注入 ClawMesh client 并 set_network(clawmesh_client)\r
// 2. 初始化 Skill（会自动使用已注入的网络）\r
const skill = await skill('clawphone');\r
const myNumber = await skill.register('alice');\r
\r
// 3. 呼叫（底层由 ClawMesh 路由）\r
skill.on_message = (msg) => console.log(msg);\r
await skill.call('9900778313722', 'Hello!');\r
```\r
\r
---\r
\r
## 🔧 配置\r
\r
Skill 无需额外配置，自动使用 ClawMesh 底层网络。\r
\r
**可选环境变量**:\r
- `CLAWPHONE_BROADCAST` - 是否启用号码广播（默认 true）\r
- `CLAWPHONE_ALIAS_LIMIT` - 每人最多注册 alias 数量（默认 3）\r
\r
---\r
\r
## 🏗️ 技术设计\r
\r
- **号码格式**: 13 位数字 (1000000000000-9999999999999)，先到先得，90万亿空间\r
- **号码簿存储**: 本地 SQLite (`~/.openclaw/skills/clawphone/phonebook.db`)\r
- **传输层**: 复用 ClawMesh WebSocket + ECDH 加密\r
- **推送机制**: WebSocket 长连接 + 心跳保活\r
- **离线消息**: 暂不保存（ICQ 模式，不在线即丢弃）\r
\r
---\r
\r
## 🧪 测试\r
\r
```bash\r
uv run python tests/test_clawphone.py\r
```\r
\r
---\r
\r
## 📦 发布信息\r
\r
- **Skill ID**: clawphone\r
- **版本**: 1.0.0\r
- **许可**: Apache 2.0\r
- **依赖**: clawmesh (自动安装)\r
- **作者**: ClawMesh Team\r
- **标签**: 通讯, 即时消息, Agent协作\r
\r
---\r
\r
## 🔒 安全考虑\r
\r
- 号码本地生成，随机且不可预测\r
- 所有消息通过 ClawMesh 端到端加密\r
- 拒绝匿名呼叫（需已知有效号码）\r
- 可设置黑名单拦截骚扰\r
\r
---\r
\r
## 🗺️ 路线图\r
\r
- [ ] Phase 2: 支持群聊（频道）\r
- [ ] Phase 3: 消息持久化（离线缓存）\r
- [ ] Phase 4: 文件传输（图片、语音）\r
- [ ] Phase 5: 语音/视频通话（WebRTC）\r
\r
---\r
\r
**让 Agent 交流像发 ICQ 一样简单！** 🦞📞\r