2026年 OpenClaw 插件 fail-closed 與 manifest 強制聲明在遠端實體 Mac 7×24 閘道落地

2. 痛點拆解

1. 限制：隱性權限與「能跑就先上」。 manifest 未列出的 fs、network、subprocess 等在 fail-open 模式下常被靜默允許，稽核無法證明「當下到底放行過什麼」。
2. 隱性成本：doctor 綠燈 ≠ 政策已上線。 openclaw doctor 可能涵蓋執行時與埠位，但熱重載從未讀到新的 manifest 強制旗標——對外仍是舊行為。
3. 穩定與稽核：沒有成對快照的回滾只是口號。 過激的 fail-closed 會在半夜打斷合法自動化；若沒有「設定 + 外掛 bundle」成對快照，最後只能在 on-call 下徒手改 JSON，直接衝擊 7×24 SLO。

3. fail-closed × manifest 決策矩陣

第一張表回答「要硬到什麼程度」；第二張把變更訊號對到驗收動作。

4. openclaw doctor 稽核清單

把 doctor 當成「政策真的載入」的證明——逐項勾在變更單上（鍵名對應發行版文件中的 openclaw.json 或環境變數）。

• 執行時與 PATH：與 launchd 使用者一致；which openclaw 與 plist 二進位路徑一致。
• Manifest 解析：印出有效的外掛根；強制開啟時拒絕無 manifest 的目錄。
• Fail-closed 旗標：doctor 印出布林值與來源檔；WARN 視為上線阻擋項。
• ACP dispatch：開關狀態與 allow-list 筆數；dispatch 開著但 allow list 為空應警告「沒有任何用戶端可進入」。
• 外部健康：本機 curl 與 /ready（若有）成對檢查，避免「自檢綠燈、反代紅燈」。

5. ACP dispatch 開關

此處 ACP dispatch 指：來自 agent 用戶端（IDE、CLI、外部編排器）的請求，是否允許進入外掛排程器。搭配 fail-closed 時，建議順序為 先用 manifest 驗證外掛集合，再以 dispatch 守大門，避免被入侵的用戶端直接跳進高風險 hook。

示意 JSON（上線前請替換為貴司發行 schema 的正式鍵名）：

{
  "plugins": {
    "requireManifest": true,
    "failClosed": true,
    "manifestSchemaVersion": "2026-05"
  },
  "acp": {
    "dispatchEnabled": true,
    "allowedClientIds": ["ci-runner-prod", "vscode-workspace-ops"],
    "denyByDefault": true
  }
}

將 allowedClientIds 與內部 OAuth 或 mTLS 主體對齊，並在 JSONL 記錄 clientId × pluginId 的笛卡兒積以供鑑識。

6. 驗收用 grep 片段

於封存目錄或現場工作區執行（路徑請自行調整）：

# 明確的 fail-closed／requireManifest 旗標
grep -RniE 'failClosed|fail_closed|requireManifest|require_manifest' \
  ~/.config/openclaw ./openclaw.json 2>/dev/null

# 每個外掛目錄皆應帶 manifest（缺檔＝不應載入）
find "$OPENCLAW_PLUGIN_ROOT" -maxdepth 2 -type f \( -name 'manifest.json' -o -name 'plugin.yaml' \) | wc -l

# 正式區 ACP dispatch allow list 不得為空
grep -Rni 'dispatchEnabled|allowedClientIds|denyByDefault' ~/.config/openclaw ./openclaw.json 2>/dev/null

若第一條 grep 全無命中，多半仍停留在隱式 fail-open——請勿僅憑肌肉記憶簽核正式區。

7. 七步受控回滾 Runbook

1. 凍結：公告維護；暫停會擴大呼叫面的 cron。
2. 快照：將 openclaw.json、外掛樹、launchd plist 與 doctor 標準輸出打成 tar。
3. 強制 manifest 開：重載、grep 驗收、觀察「拒絕載入」計數。
4. fail-closed 開：對未宣告能力統一錯誤碼；保留五分鐘 JSONL 基線。
5. 收緊 ACP dispatch：先 shadow（僅記錄），再 deny-by-default。
6. 回滾觸發：若 SLO 破裂，還原成對快照、launchctl kickstart、重跑 doctor。
7. RCA：更新 grep 清單與工單；排程下次金絲雀。

8. 可引用數字與留存

• 觀測視窗：政策變更後至少觀察五分鐘滑動視窗再決定留用或回滾——啟動尖峰不算事故。
• 快照留存：正式區保留三份可還原設定修訂，每份附外掛 tarball 校驗和。
• 稽核留存：完整 doctor 輸出與 grep 擷取應與工單綁定至少 30 天，以滿足常見內規抽檢。

9. FAQ

簡體版對照：OpenClaw 插件 fail-closed 与 manifest（简体中文）。