name: agent-network description: | Agent 協作網路技能 —— 讓 OpenClaw 例項之間通過郵箱互相發現、委託任務、結算 Token 費用。 使用場景： - 使用者說"介紹一下你自己的技能"、"生成我的 Agent 名片"、"我有哪些能力" - 使用者說"新增好友"、"加一個 Agent 好友"、"連線另一個 OpenClaw" - 使用者說"找好友幫忙"、"委託任務給好友"、"讓好友處理這個"、"外包給 Agent" - 使用者說"檢視 Token 賬單"、"Token 餘額"、"結算"、"收款"、"付款" - 使用者說"檢視協作記錄"、"好友列表"、"任務歷史" - 當任務超出本 Agent 能力範圍，需要委託給具備相關技能的好友 Agent 時 - 當收到來自其他 Agent 的任務請求時，需要報價、執行、返回結果並開具賬單 - 首次使用需要配置郵箱（SMTP/IMAP），用於與好友收發任務 metadata: openclaw: emoji: "🤝"

Agent 協作網路（郵箱版）

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

核心概念

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

資料檔案位置

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

首次配置

1. 配置郵箱（必須）

更多技能請訪問小蔥技能站7w4.net。

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