reporting-governance-plugin/docs/plans/2026-04-07-openclaw-config-candidate-patch-notes.md

2026-04-07 OpenClaw Candidate Config Patch Notes

這份 2026-04-07-openclaw-config-candidate-patch.json 是候選版 config.patch，不是可直接套用的授權指令。

1. 設計目標

• 將 live config 從單一 coder agent 擴展為 6 個 agent
• 強制每個 agent 使用自己的獨立 workspace
• 打開 Eve 跨 agent 協調所需的 session 可見性
• 打開 agent-to-agent allowlist，但不假裝只靠 config 就能完成制度約束

2. 依 live config 做的最小必要變更

目前 live config 關鍵現況：

• agents.list 只有 coder
• tools.sessions.visibility = "self"
• tools.agentToAgent.enabled = false
• agents.defaults.workspace = "/home/alice/.openclaw/workspace"

因此候選 patch 只改：

• agents.defaults.workspace -> null
• agents.list -> 整組替換為 6-agent list
• tools.sessions.visibility -> "all"
• tools.agentToAgent.enabled -> true
• tools.agentToAgent.allow -> 6-agent allowlist

3. JSON Merge Patch 語義

這份檔案是按 config.patch 的 merge patch 語義設計：

3.1 刪除 key

• "workspace": null 代表刪除 agents.defaults.workspace
• 目的：避免殘留共享 default workspace，與「每個 agent 必須獨立 workspace」衝突

3.2 陣列會整組替換

• agents.list 不是 append，而是整個 list 被替換
• 所以候選 patch 必須放完整的 6-agent list，而不是只補 5 個新 agent

4. 這份 patch 故意還沒做的事

以下制度暫不塞進 patch：

• 只有 Eve 能對總管回話
• 子代理只能回 Eve
• reviewer 不可越權判定完成
• 失聯 / 超時 / 重派的程序正義

原因：這些主要屬於 prompt / workflow 層，不應假裝只靠 config 就會自動成立。

5. 套用前仍需再確認的事項

1. 各 workspace 目錄是否先建立
2. 每個 agent 是否要先補 identity
3. 每個 agent 是否要先補 skills
4. 是否要加 per-agent tools 限制
5. 是否要補 subagents.allowAgents 進一步收窄派工邊界

6. 建議下一步

• 先建立各 agent workspace 骨架
• 再補各 agent 的核心 prompt / workflow 檔
• 最後才產生真正送進 gateway config.patch 的 payload