~/.openclaw/agents/<agentId>/
├── agent/                    # 身份層 - 員工牌
│   ├── auth-profiles.json    # 認證配置（API Key）
│   └── models.json           # 模型配置（用哪個LLM）
├── sessions/                 # 狀態(tài)層 - 工作日志
│   ├── <session-id>.jsonl   # 獨立聊天記錄
│   └── sessions.json        # 會話索引
└── workspace/               # 工作層 - 辦公桌面
    ├── SOUL.md             # 靈魂/人格定義
    ├── AGENTS.md           # 行為規(guī)范
    ├── USER.md             # 用戶信息
    ├── TOOLS.md            # 工具使用指南
    ├── IDENTITY.md         # 身份定義
    └── memory/            # 記憶存儲
        └── YYYY-MM-DD.md  # 每日日志

Main (大蔡/統(tǒng)籌)
├── 職責(zé)：任務(wù)拆解、進度監(jiān)控、結(jié)果聚合
├── 模型：經(jīng)濟型（如qwen3-max-2026）
└── 工具：sessions_send、sessions_receive、planning

Coder (蔡農(nóng)/編碼)
├── 職責(zé)：代碼編寫、系統(tǒng)調(diào)試、單元測試
├── 模型：代碼專用（如qwen3-coder-2026）
└── 工具：exec、write、edit、git

Reviewer (審核員)
├── 職責(zé)：代碼審查、安全檢查、性能分析
├── 模型：頂級模型（如GPT-4.5/Sonnet 4.6）
└── 工具：read、exec、test

Architect (架構(gòu)師)
├── 職責(zé)：技術(shù)選型、架構(gòu)設(shè)計、方案評審
├── 模型：頂級模型
└── 工具：browser、read、write

DevOps (運維工程師)
├── 職責(zé)：部署配置、CI/CD編排、監(jiān)控告警
├── 模型：經(jīng)濟型
└── 工具：exec、git、cloud-tools

你是一位經(jīng)驗豐富的軟件工程師，擁有10年Java開發(fā)經(jīng)驗，
擅長微服務(wù)架構(gòu)設(shè)計，對Spring Boot有深入研究，
在項目中你總是注重代碼質(zhì)量，遵循SOLID原則...
（500字+）

# SOUL.md - Coder Agent

角色：后端開發(fā)工程師
專長：Java、微服務(wù)、Spring Boot
原則：
- 代碼可測試性 > 簡潔性
- 遵循SOLID原則
- API文檔先行
- 3行以上邏輯必須寫注釋

典型工作流：
1. 理解需求 → 2. 編寫測試 → 3. 實現(xiàn)代碼 → 4. 自測驗證

{
  "tools": {
    "agentToAgent": {
      "enabled": true,
      "allow": ["main", "coder", "reviewer", "architect"]
    }
  }
}

用戶請求
    ↓
Router（分類器）
    ├→ Agent A（專業(yè)領(lǐng)域1）
    ├→ Agent B（專業(yè)領(lǐng)域2）
    └→ Agent C（專業(yè)領(lǐng)域3）

{
  "bindings": [
    {
      "agentId": "coder",
      "match": {
        "channel": "discord",
        "peer": { "kind": "channel", "id": "coding-team" }
      }
    },
    {
      "agentId": "architect",
      "match": {
        "channel": "discord",
        "peer": { "kind": "channel", "id": "architecture-team" }
      }
    }
  ]
}

任務(wù)像流水線一樣在Agent之間傳遞：
調(diào)研Agent → 寫作Agent → 校審Agent → 排版Agent
   ↓            ↓            ↓            ↓
 (資料收集)  (初稿撰寫)  (質(zhì)量把關(guān))  (最終輸出)

# Main Agent的工作流
research_result = sessions_send({
    "agent": "researcher",
    "task": "調(diào)研OpenClaw最新功能"
})

draft = sessions_send({
    "agent": "writer",
    "task": f"基于調(diào)研結(jié)果撰寫文檔：{research_result}"
})

final_doc = sessions_send({
    "agent": "reviewer",
    "task": f"審核并優(yōu)化文檔：{draft}"
})

Main Agent 同時觸發(fā)多個獨立任務(wù)：
    ├→ Coder（后端開發(fā)）
    ├→ Frontend-Dev（前端開發(fā)）
    └→ QA（測試用例編寫）
    ↓
Main Agent 收集所有結(jié)果 → 整合聯(lián)調(diào)

# 并行執(zhí)行三個任務(wù)
results = await Promise.all([
    sessions_spawn({
        "label": "后端開發(fā)",
        "task": "實現(xiàn)用戶認證API",
        "runTimeoutSeconds": 300
    }),
    sessions_spawn({
        "label": "前端開發(fā)",
        "task": "設(shè)計登錄頁面UI",
        "runTimeoutSeconds": 300
    }),
    sessions_spawn({
        "label": "測試編寫",
        "task": "編寫認證模塊測試用例",
        "runTimeoutSeconds": 180
    })
])

{
  "tool": "team_create",
  "params": {
    "teamName": "feature-auth-refactor",
    "coordinationMode": "normal"
  }
}

sessions_send({
    "agent": "coder",        # 目標Agent ID
    "task": "實現(xiàn)用戶登錄API",  # 任務(wù)描述
    "timeoutSeconds": 300          # 超時時間（秒），timeoutSeconds>0時等待完成
})

# 一次性子代理（完成后自動歸檔）
sessions_spawn({
    "label": "代碼審查",
    "task": "審查當(dāng)前分支代碼",
    "cleanup": "delete",  # announce完立即歸檔（默認就是delete）
    "runTimeoutSeconds": 300
})

# 持久子代理（需手動管理）
sessions_spawn({
    "label": "長期助手",
    "task": "在這個線程中長期協(xié)助用戶",
    "cleanup": "keep",  # 交給統(tǒng)一的auto-archive
    "thread": true,       # 啟用線程綁定（Discord專用）
    "runTimeoutSeconds": 600
})

{
  "tools": {
    "agentToAgent": {
      "enabled": true,
      "allow": ["main", "coder", "reviewer"],
      "maxPingPongTurns": 0  # 防止Agent無限互懟
    }
  }
}

Agent A: "你好，我準備好了"
Agent B: "你好，我也準備好了"
Agent A: "那我們開始吧"
Agent B: "好的，我聽你的"
...（無限循環(huán)）

{
  "session": {
    "agentToAgent": {
      "maxPingPongTurns": 0  # 禁止自動互懟
    }
  }
}

讓Main Agent直接做深度研究、寫大量代碼
→ 所有中間結(jié)果留在主會話上下文
→ 每條消息都帶著這些垃圾

Main創(chuàng)建臨時代理執(zhí)行重活
→ 子代理完成工作后，只返回關(guān)鍵摘要（10%）
→ 主會話保持輕量

# 在AGENTS.md中添加
"對于復(fù)雜任務(wù)（研究、編程、數(shù)據(jù)分析），創(chuàng)建臨時子代理完成。
子代理完成后，只返回最終結(jié)果給主會話。"

MEMORY.md (長期記憶)
├── 核心原則、關(guān)鍵決策
├── 項目架構(gòu)、技術(shù)選型
└── 最佳實踐、踩坑記錄

memory/YYYY-MM-DD.md (每日日志)
├── 當(dāng)天執(zhí)行的任務(wù)
├── 遇到的臨時問題
└── 快速筆記

每周執(zhí)行一次"記憶壓縮"：
"請總結(jié)memory/過去7天的文件，保留10條最重要的信息，
刪除重復(fù)和過時內(nèi)容，將文件壓縮到5KB以內(nèi)"

{
  "cron": "*/30 * * * *",  // 每30分鐘
  "agent": "main",
  "model": "sonnet-4.6"     // 用頂級模型做簡單檢查
}

{
  "cron": "*/30 * * * *",
  "agent": "heartbeat-coordinator",
  "model": "haiku-3.5"      // 用廉價模型做初步檢查
}

{
  "agents": {
    "defaults": {
      "contextPruning": {
        "mode": "cache-ttl",
        "ttl": "5m",
        "keepLastAssistants": 3,
        "softTrim": { "maxChars": 4000 },
        "hardClear": { "enabled": true }
      }
    }
  }
}

{
  "compaction": {
    "reserveTokensFloor": 20000,
    "memoryFlush": {
      "enabled": true,
      "softThresholdTokens": 4000,
      "prompt": "Write durable notes to memory/YYYY-MM-DD.md"
    }
  }
}

flush觸發(fā)點 = contextWindow - reserveTokensFloor - softThresholdTokens

200000 - 20000 - 4000 = 176000 tokens

{
  "models": {
    "providers": {
      "local-qwen": {
        "models": [{
          "id": "mlx-community/Qwen3.5-397B-A17B-4bit",
          "contextWindow": 50000  // 強制設(shè)置較小的窗口
        }]
      }
    }
  },
  "agents": {
    "defaults": {
      "compaction": {
        "mode": "default",
        "reserveTokensFloor": 10000,  // 本地模型需要更多保留空間
        "memoryFlush": { "enabled": true }
      },
      "contextPruning": {
        "mode": "cache-ttl",
        "ttl": "10m",  // 更頻繁的剪枝
        "keepLastAssistants": 2,
        "minPrunableToolChars": 20000  // 工具輸出超過2萬字符才剪枝
      }
    }
  }
}

{
  "memorySearch": {
    "provider": "openai",
    "model": "text-embedding-3-small",
    "temporalDecay": {
      "enabled": true,
      "halfLifeDays": 30  // 30天半衰期
    }
  }
}

decayedScore = score × e^(-λ × ageInDays)
其中 λ = ln(2) / halfLifeDays

{
  "agents": {
    "list": [
      {
        "id": "main",
        "sandbox": { "mode": "off" }  // 完全信任，無隔離
      },
      {
        "id": "public-agent",
        "sandbox": {
          "mode": "all",       // 始終沙箱隔離
          "scope": "agent"      // 每Agent一個容器
        }
      },
      {
        "id": "semi-trusted",
        "sandbox": {
          "mode": "non-main",  // 非主會話才隔離
          "scope": "session"    // 每會話一個容器
        }
      }
    ]
  }
}

{
  "agents": {
    "list": [
      {
        "id": "family-bot",
        "tools": {
          "allow": ["read"],
          "deny": ["exec", "write", "edit", "browser", "process"]
        }
      },
      {
        "id": "coding-bot",
        "tools": {
          "allow": ["read", "write", "edit", "exec", "git"],
          "deny": ["browser"]  // 禁止訪問互聯(lián)網(wǎng)
        }
      }
    ]
  }
}

{
  "tools": {
    "execApproval": {
      "enabled": true,
      "commands": ["rm -rf", "docker exec", "kubectl delete"],
      "approvalMode": "human"  // 需要人工批準
    }
  }
}

{
  "tools": {
    "ssrf": {
      "policy": "trusted-network"  // 新默認：僅信任網(wǎng)絡(luò)（防止SSRF攻擊）
    },
    "execApproval": {
      "enabled": true,
      "commands": ["rm -rf", "docker exec", "kubectl delete"],
      "approvalMode": "human"
    }
  }
}

# 步驟1：任務(wù)拆解
plan = break_down_task("開發(fā)用戶認證模塊")

# 步驟2：架構(gòu)設(shè)計（串行）
architecture = sessions_send({
    "agent": "architect",
    "task": f"設(shè)計用戶認證方案：{plan}",
    "timeoutSeconds": 180
})

# 步驟3：并行開發(fā)（后端+前端+測試）
results = await Promise.all([
    sessions_spawn({
        "label": "后端API",
        "task": f"實現(xiàn)認證API：{architecture}",
        "runTimeoutSeconds": 600
    }),
    sessions_spawn({
        "label": "前端頁面",
        "task": f"實現(xiàn)登錄UI：{architecture}",
        "runTimeoutSeconds": 600
    }),
    sessions_spawn({
        "label": "測試用例",
        "task": "編寫認證模塊測試",
        "runTimeoutSeconds": 300
    })
])

# 步驟4：代碼審查（串行）
review = sessions_send({
    "agent": "reviewer",
    "task": f"審查代碼：{results}",
    "timeoutSeconds": 300
})

# 步驟5：整合輸出
final_report = synthesize_results(architecture, results, review)

{
  "cron": "*/15 * * * *",  // 每15分鐘檢查一次
  "agent": "pr-bot",
  "task": "檢查開放的PR，自動進行代碼審查"
}

# 動態(tài)創(chuàng)建代碼審查助手（一次性）
reviewer = sessions_spawn({
    "label": "代碼審查助手",
    "task": "審查當(dāng)前分支的代碼變更",
    "cleanup": "delete",  # 完成后立即歸檔
    "runTimeoutSeconds": 300
})

# 動態(tài)創(chuàng)建性能分析助手（持久會話，需手動管理）
profiler = sessions_spawn({
    "label": "性能分析助手",
    "task": "分析API響應(yīng)時間瓶頸",
    "thread": true,  # 啟用線程綁定（Discord專用，持久化子代理）
    "runTimeoutSeconds": 600
})

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "all",
        "scope": "shared",
        "workspaceRoot": "/tmp/work-sandboxes"
      }
    }
  }
}

{
  "agents": {
    "list": [
      {
        "id": "orchestrator",
        "subagents": {
          "allowAgents": ["researcher", "coder"],  // 允許orchestrator創(chuàng)建researcher和coder的子代理
          // 或者用 ["*"] 允許任何Agent
        }
      }
    ]
  }
}

{
  "bindings": [
    {
      "agentId": "chef",
      "match": {
        "channel": "whatsapp",
        "peer": { "kind": "group", "id": "123@g.us" },
        "content": {          // 新增：內(nèi)容匹配
          "pattern": "^@chef\\b",
          "stripMatch": true  // 移除匹配的前綴
        }
      }
    }
  ]
}

#!/bin/bash
# create_agents.sh - 創(chuàng)建多Agent工作區(qū)

# 創(chuàng)建5個Agent的獨立工作區(qū)
mkdir -p ~/.openclaw/workspaces/{main,coder,reviewer,architect,devops}

# 設(shè)置權(quán)限
chmod 755 ~/.openclaw/workspaces/*

# 復(fù)制基礎(chǔ)模板
for workspace in ~/.openclaw/workspaces/*; do
    cp templates/SOUL.md "$workspace/"
    cp templates/AGENTS.md "$workspace/"
    cp templates/IDENTITY.md "$workspace/"
    mkdir -p "$workspace/memory"
done

echo "? Agent工作區(qū)創(chuàng)建完成"

// openclaw.json - 多Agent配置模板
{
  "agents": {
    "defaults": {
      "llm": {
        "provider": "dashscope",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      },
      "session": {
        "agentToAgent": {
          "maxPingPongTurns": 0,
          "enabled": true
        }
      },
      "contextPruning": {
        "mode": "cache-ttl",
        "ttl": "5m",
        "keepLastAssistants": 3,
        "softTrim": { "maxChars": 4000 },
        "hardClear": { "enabled": true }
      },
      "compaction": {
        "mode": "default",
        "reserveTokensFloor": 20000,
        "memoryFlush": {
          "enabled": true,
          "softThresholdTokens": 4000,
          "prompt": "Write durable notes to memory/YYYY-MM-DD.md"
        }
      }
    },
    "list": [
      {
        "id": "main",
        "name": "統(tǒng)籌助手",
        "workspace": "~/.openclaw/workspaces/main",
        "llm": { "model": "qwen3-max-2026" },
        "sandbox": { "mode": "off" }
      },
      {
        "id": "coder",
        "name": "編碼專家",
        "workspace": "~/.openclaw/workspaces/coder",
        "llm": { "model": "qwen3-coder-2026" },
        "sandbox": { "mode": "all", "scope": "agent" }
      },
      {
        "id": "reviewer",
        "name": "代碼審核",
        "workspace": "~/.openclaw/workspaces/reviewer",
        "llm": { "model": "gpt-4.5" },
        "sandbox": { "mode": "all", "scope": "session" }
      }
    ]
  },
  "tools": {
    "agentToAgent": {
      "enabled": true,
      "allow": ["main", "coder", "reviewer"]
    }
  },
  "bindings": [
    {
      "agentId": "main",
      "match": { "channel": "discord", "peer": { "kind": "channel", "id": "general" } }
    },
    {
      "agentId": "coder",
      "match": { "channel": "discord", "peer": { "kind": "channel", "id": "coding" } }
    }
  ]
}

個人用戶：分身術(shù)（單Bot多路由）
團隊協(xié)作：獨立團（多Bot獨立身份）
復(fù)雜項目：Agent Teams（?? RFC階段，需確認版本支持）
臨時任務(wù)：sessions_spawn（動態(tài)子代理）