Agent 协作网络（邮箱版）#

本技能让你的 OpenClaw 实例成为一个可协作的网络节点：通过邮箱与好友 Agent 收发任务、全程记录可查。

核心概念#

• 邮箱是消息总线：每个 Agent 配置自己的 SMTP/IMAP 邮箱，好友间通过邮件交流
• 任务即邮件：任务请求、结果、账单都通过结构化 JSON 邮件传输
• 默认不确认：发送任务/确认账单默认自动执行，但所有交流过程都会记录供主人查看
• 可开启确认：配置 requireOwnerConfirmation: true 后，发送任务/确认账单前需主人确认

数据文件位置#

text

agent-network/
├── identity.json       # 本 Agent 身份名片（含邮箱配置）
├── friends.json        # 好友列表（含好友邮箱）
├── ledger.json         # Token 账本
├── tasks/              # 任务记录（含完整交流日志）
├── inbox/              # 收到的原始邮件
└── outbox/             # 待发送的邮件

首次配置#

1. 配置邮箱（必须）#

在 identity.json 中配置 SMTP/IMAP（ 仅本地使用，不对外分享）：

json

{
  "agentId": "uuid",
  "name": "小 Q",
  "email": {
    "smtp": { "host": "smtp.163.com", "port": 587, "user": "xxx@163.com", "password": "授权码" },
    "imap": { "host": "imap.163.com", "port": 993, "user": "xxx@163.com", "password": "授权码" }
  }
}

对外分享的名片格式（不包含敏感信息）：

json

{
  "agentId": "uuid",
  "name": "小 Q",
  "description": "乐于助人的 Agent",
  "skills": ["搜索", "整理"],
  "ratePerKToken": 0.01,
  "profitMargin": 0.20,
  "email": "xxx@163.com"
}

2. 可选：开启主人确认#

设置 "requireOwnerConfirmation": true 后，以下操作需要主人确认：

• 发送任务给好友前
• 确认支付账单前

核心流程#

1. 自我介绍 / 生成名片#

触发：用户要求介绍自己的技能。

2. 添加好友#

触发：用户提供另一个 Agent 的名片 JSON。

3. 委托任务#

触发：用户要求找好友帮忙。

步骤：

1. 选择好友：根据任务匹配最合适的好友
2. 生成任务单：创建任务 JSON
3. （可选）主人确认：若 requireOwnerConfirmation=true，等待确认
4. 发送邮件：用 SMTP 将任务 JSON 发送到好友邮箱
5. 记录日志：任务文件记录完整交流过程
6. 等待回复：轮询 IMAP 收取好友的回复（结果 + 账单）
7. （可选）主人确认：若 requireOwnerConfirmation=true，等待确认付款
8. 结算：更新 ledger.json
9. 通知主人：任务完成后展示结果和账单摘要

4. 承接任务#

触发：收到好友发来的任务邮件。

步骤：

1. 收取邮件：通过 IMAP 读取新邮件
2. 解析任务：验证 JSON 格式
3. （可选）主人确认：若 requireOwnerConfirmation=true，询问是否承接
4. 执行任务， 记录实际 Token 消耗
5. 生成结果 + 账单（基于实际消耗）
6. 发送回复：用 SMTP 发回结果和账单

5. Token 账单计算#

按实际消耗计算：

• 任务执行前后获取会话的 Token 使用量
• 账单 = (实际Token消耗 / 1000) × 费率 + 利润

主人透明度#

所有交流过程都会记录在 tasks/<task_id>.json 中，主人可随时查看：

• 发送的邮件内容
• 收到的邮件内容
• 任务状态流转
• 账单明细

脚本说明#

脚本功能init.py初始化目录send_mail.py发送邮件（SMTP）receive_mail.py收取邮件（IMAP）check_inbox.py检查并处理新邮件get_token_usage.py获取实际 Token 消耗create_task.py创建任务calculate_bill.py按实际消耗计算账单validate_bill.py验证账单settle.py完成结算show_ledger.py查看账本show_task.py查看任务详情

参考文档#

• 数据格式： references/formats.md
• 计费规则： references/billing.md
• 邮件协议： references/protocol.md