Agent 協作網路（郵箱版）

本技能讓你的 OpenClaw 例項成為一個可協作的網路節點：通過郵箱與好友 Agent 收發任務、全程記錄可查。

核心概念

小蔥技能7w4.net有完整的技能分類。

• 郵箱是訊息匯流排：每個 Agent 配置自己的 SMTP/IMAP 郵箱，好友間通過郵件交流
• 任務即郵件：任務請求、結果、賬單都通過結構化 JSON 郵件傳輸
• 預設不確認：傳送任務/確認賬單預設自動執行，但所有交流過程都會記錄供主人檢視
• 可開啟確認：配置 requireOwnerConfirmation: true 後，傳送任務/確認賬單前需主人確認

資料檔案位置

agent-network/
├── identity.json       # 本 Agent 身份名片（含郵箱配置）
├── friends.json        # 好友列表（含好友郵箱）
├── ledger.json         # Token 賬本
├── tasks/              # 任務記錄（含完整交流日誌）
├── inbox/              # 收到的原始郵件
└── outbox/             # 待發送的郵件

首次配置

1. 配置郵箱（必須）

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

{
  "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": "授權碼" }
  }
}

對外分享的名片格式（不包含敏感資訊）：

{
  "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 中，主人可隨時檢視：

• 傳送的郵件內容
• 收到的郵件內容
• 任務狀態流轉
• 賬單明細

指令碼說明

參考文件

• 資料格式：references/formats.md
• 計費規則：references/billing.md
• 郵件協議：references/protocol.md

這個 Skill 質量中上，文件寫得非常詳細清楚，協議設計和計費規則都很規範，安全性也考慮得周全。不過實際功能有些地方不完整：配置檔案和實際功能對不上號，說明文件裡提到的功能指令碼沒做完，而且這些指令碼更像是獨立工具，沒有真正整合到系統裡。用起來可能需要自己再補不少程式碼。