2026 OpenClaw-Plugins: fail-closed-Standard und verpflichtendes Manifest auf physischem Fern-Mac-7×24-Gateway—openclaw doctor-Audit-Checkliste, ACP-Dispatch-Schalter und Runbook für kontrolliertes Rollback (grep-Snippets + FAQ)

Schmerzpunkte

1. Randbedingung: implizite Rechte und «es läuft, also live». Fähigkeiten wie fs, network oder subprocess, die im Manifest fehlen, werden im fail-open-Modus oft still erlaubt—Audits können dann nicht belegen, was erlaubt war.
2. Versteckte Kosten: doctor-grün ≠ Policy live. openclaw doctor prüft Laufzeit und Ports, während Hot Reload neue Manifest-Durchsetzungsflags nie übernommen hat—extern sehen Sie weiter Legacy-Verhalten.
3. Stabilität und Audit: Rollback ohne gepaarte Snapshots ist Fiktion. Aggressives fail-closed bricht legitime Automation über Nacht; ohne Konfig- und Plugin-Bündel-Snapshots editieren Sie JSON im Pager-Dienst und verletzen 7×24-SLOs.

Entscheidungsmatrizen: fail-closed × Manifest

Die erste Tabelle beantwortet «wie streng?»; die zweite ordnet Änderungssignale den Prüfschritten zu.

openclaw doctor-Audit-Checkliste

Behandeln Sie doctor als Nachweis, dass die Policy wirklich geladen wurde—haken Sie jeden Punkt auf dem Change-Ticket ab (Schlüssel auf openclaw.json oder Umgebungsvariablen gemäß Ihrer Distribution).

• Laufzeit und PATH: Entspricht dem launchd-Benutzer; which openclaw entspricht dem Binary-Pfad aus der Plist.
• Manifest-Auflösung: Gibt effektive Plugin-Roots aus; lehnt Verzeichnisse ohne Manifest ab, wenn Durchsetzung aktiv ist.
• fail-closed-Flags: Doctor gibt Booleans und Herkunftsdatei aus; WARN ist ein Release-Blocker.
• ACP-Dispatch: Schalterzustand plus Kardinalität der Allow-List; leere Allow-List bei aktivem Dispatch sollte warnen «keine Clients können eintreten».
• Externe Gesundheit: Paaren Sie localhost-curl mit /ready (falls vorhanden), damit nicht «Selbstcheck grün, Reverse-Proxy rot» entsteht.

ACP-Dispatch-Schalter

ACP-Dispatch bedeutet hier, ob Anfragen von Agent-Clients (IDEs, CLIs, externe Orchestrierung) den Plugin-Scheduler erreichen dürfen. Bei fail-closed die Reihenfolge: Plugin-Set zuerst per Manifest validieren, dann Dispatch nutzen, um die Haustür zu sichern—ein kompromittierter Client soll nicht direkt in einen Hochrisiko-Hook springen.

Illustratives JSON (Schlüssel vor Produktion an Ihr Release-Schema anpassen):

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

Richten Sie allowedClientIds an interne OAuth- oder mTLS-Subjects aus und protokollieren Sie das kartesische Produkt clientId × pluginId in JSONL für Forensik.

grep-Abnahme-Snippets

Aus Archiv oder Live-Workspace ausführen (Pfade anpassen):

# Explizite fail-closed / requireManifest-Flags
grep -RniE 'failClosed|fail_closed|requireManifest|require_manifest' \
  ~/.config/openclaw ./openclaw.json 2>/dev/null

# Jedes Plugin-Verzeichnis sollte ein Manifest tragen (fehlend = sollte nicht laden)
find "$OPENCLAW_PLUGIN_ROOT" -maxdepth 2 -type f \( -name 'manifest.json' -o -name 'plugin.yaml' \) | wc -l

# ACP-Dispatch-Allow-List in Produktion nicht leer lassen
grep -Rni 'dispatchEnabled|allowedClientIds|denyByDefault' ~/.config/openclaw ./openclaw.json 2>/dev/null

Liefert der erste grep nichts, fahren Sie vermutlich noch implizites fail-open—Produktion nicht allein aus Muskelgedächtnis freigeben.

Siebenstufiges Runbook für kontrolliertes Rollback

1. Einfrieren: Wartung posten; Cron-Jobs pausieren, die die Aufrufoberfläche vergrößern.
2. Snapshot: openclaw.json, Plugin-Bäume, launchd-Plists und doctor-Stdout archivieren (tar).
3. Verpflichtende Manifeste an: Neu laden, per grep verifizieren, Zähler «Load verweigert» beobachten.
4. fail-closed an: Einheitliche Fehlercodes für nicht deklarierte Fähigkeiten; JSONL-Baseline über fünf Minuten halten.
5. ACP-Dispatch verschärfen: Zuerst Shadow (nur Log), dann deny-by-default.
6. Rollback-Trigger: Bei SLO-Bruch gepaarte Snapshots wiederherstellen, launchctl kickstart, doctor erneut.
7. RCA: grep-Checkliste und Ticket aktualisieren; nächsten Canary terminieren.

Zitierfähige Kennzahlen

• Beobachtungsfenster: Mindestens ein gleitendes Fenster von fünf Minuten nach Policy-Änderungen abwarten, bevor Bleiben/Rollback entschieden wird—Start-Spitzen sind kein Incident.
• Snapshot-Retention: In Produktion drei wiederherstellbare Konfig-Revisionen mit je einer Plugin-Tarball-Prüfsumme vorhalten.
• Audit-Retention: Vollständigen doctor-Output plus grep-Captures ≥30 Tage mit dem Ticket speichern—typische interne Compliance-Stichproben.

FAQ

Englische Fassung: OpenClaw plugins fail-closed & manifest (English).

Fazit: Warum Mac mini zu diesem Workload passt

Plugin-Governance verschiebt Vertrauen von Stammtischwissen auf maschinell prüfbare Policy: Manifeste binden Fähigkeiten, fail-closed definiert das Versagensverhalten, ACP-Dispatch verkleinert die Ingress-Fläche, doctor plus grep liefern die Beweiskette, die Auditoren erwarten.

Unter macOS fügt sich das sauber zu launchd, Unified Logging, Gatekeeper und SIP. Apple-Silicon-Mac mini M4 idelt in der Größenordnung 4 W—ideal für Dauer-Gateways und Nebenproben; gegenüber generischen Mini-PCs im gleichen Preisband fallen lange Sessions oft ruhiger aus, wenn OpenClaw, Health-Exporter und ein leichter CI-Agent einen physischen Rechner teilen.

Wenn Sie dieses Runbook auf einem dedizierten gehosteten Knoten statt eigenem Colo-Metal fahren wollen, bleibt der Mac mini M4 2026 einer der preiswertesten Einstiege—physischen Fern-Mac anfragen und Manifest-Durchsetzung plus Rollback zur wiederholbaren Routine machen.