2026 — Plugins OpenClaw : fail-closed et manifeste obligatoire sur une passerelle Mac physique distant 7×24 — openclaw doctor, interrupteurs ACP dispatch et runbook de retour arrière contrôlé (extraits grep + FAQ)

Points de friction

1. Contrainte : pouvoirs implicites et « ça tourne, on livre ». Des capacités telles que fs, network ou subprocess absentes du manifeste sont souvent autorisées silencieusement en mode fail-open : les audits ne peuvent pas prouver ce qui était permis.
2. Coût caché : doctor au vert ≠ politique effective. openclaw doctor couvre parfois runtime et ports alors que le rechargement à chaud n’a jamais pris les nouveaux drapeaux d’application du manifeste — de l’extérieur, le comportement reste hérité.
3. Stabilité et audit : retour arrière sans instantanés appariés = fiction. Un fail-closed agressif casse une automation légitime dans la nuit ; sans instantanés config + bundle plugin, on édite du JSON à la main sous astreinte, ce qui viole les SLO 7×24.

Matrices fail-closed × manifeste

Le premier tableau répond à « quelle dureté ? ». Le second relie signaux de changement et vérifications.

Checklist d’audit openclaw doctor

Considérez doctor comme la preuve que la politique est réellement chargée — cochez chaque point sur le ticket (mappez les clés vers openclaw.json ou variables d’environnement selon votre distribution).

• Runtime et PATH : Alignés sur l’utilisateur launchd ; which openclaw correspond au binaire du plist.
• Résolution manifeste : Affiche les racines plugin effectives ; refuse les répertoires sans manifeste lorsque l’application est active.
• Drapeaux fail-closed : Doctor imprime le booléen et le fichier d’origine ; tout WARN est bloquant pour une mise en production.
• ACP dispatch : État de l’interrupteur et cardinalité de la liste autorisée ; liste vide avec dispatch actif doit avertir qu’aucun client ne peut entrer.
• Santé externe : Coupler curl localhost avec /ready (si présent) pour éviter « auto-check vert, reverse proxy rouge ».

Interrupteurs ACP dispatch

ACP dispatch désigne ici si les requêtes des clients agents (IDE, CLI, orchestrateurs externes) peuvent entrer dans l’ordonnanceur de plugins. Avec fail-closed, enchaînez valider l’ensemble plugin via manifeste puis utiliser dispatch pour garder la porte d’entrée afin qu’un client compromis ne saute pas directement vers un hook à risque.

JSON illustratif (remplacez les clés par le schéma de votre release avant production) :

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

Alignez allowedClientIds sur OAuth interne ou sujets mTLS, et journalisez le produit cartésien clientId × pluginId en JSONL pour la forensique.

Extraits grep d’acceptation

À lancer depuis votre archive ou espace de travail actif (adaptez les chemins) :

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

# Chaque répertoire plugin doit porter un manifeste (absent = ne doit pas charger)
find "$OPENCLAW_PLUGIN_ROOT" -maxdepth 2 -type f \( -name 'manifest.json' -o -name 'plugin.yaml' \) | wc -l

# Liste autorisée ACP dispatch : non vide en production
grep -Rni 'dispatchEnabled|allowedClientIds|denyByDefault' ~/.config/openclaw ./openclaw.json 2>/dev/null

Si le premier grep ne renvoie rien, vous êtes probablement encore en fail-open implicite — ne validez pas la production sur la seule mémoire musculaire.

Runbook de retour arrière contrôlé en sept étapes

1. Gel : Annoncer la maintenance ; suspendre les tâches cron qui élargissent la surface d’appel.
2. Instantané : Archiver en tarball openclaw.json, arborescences plugin, plists launchd et la sortie stdout de doctor.
3. Manifestes obligatoires ON : Recharger, vérifier par grep, surveiller les compteurs « refus de chargement ».
4. Fail-closed ON : Codes d’erreur uniformes pour capacités non déclarées ; conserver une baseline JSONL sur cinq minutes.
5. Resserrer ACP dispatch : Shadow (journalisation seule) d’abord, puis deny-by-default.
6. Déclencheur rollback : Si le SLO casse, restaurer les instantanés appariés, launchctl kickstart, relancer doctor.
7. RCA : Mettre à jour la checklist grep et le ticket ; planifier le prochain canary.

Chiffres et paramètres réutilisables

• Fenêtre d’observation : Observer au moins une fenêtre glissante de cinq minutes après une modification de politique avant de décider maintien ou rollback — les pics au démarrage ne sont pas des incidents.
• Rétention d’instantanés : Conserver trois révisions de configuration restaurables en production, chacune avec l’empreinte du tarball plugin.
• Rétention audit : Joindre la sortie doctor complète et les captures grep au ticket pendant au moins 30 jours pour les contrôles conformité internes courants.

FAQ

Édition anglaise : OpenClaw plugins fail-closed & manifest (English).

Synthèse : pourquoi le Mac mini convient à cette charge

La gouvernance des plugins déplace la confiance du savoir tacite vers une politique vérifiable par la machine : le manifeste borne les capacités, le fail-closed fixe la posture à l’échec, le dispatch ACP réduit la surface d’entrée, et doctor plus grep fournissent la chaîne de preuve attendue par l’audit.

Sur macOS, cela s’aligne avec launchd, Unified Logging, Gatekeeper et SIP. Un Mac mini M4 Apple Silicon consomme de l’ordre de 4 W au repos — idéal pour passerelles et sondes 7×24 ; face à des mini-PC au même prix, les longues sessions avec OpenClaw, exporteurs de santé et un runner CI léger sur une même machine physique distante restent en général plus stables.

Si vous voulez exécuter ce runbook sur un nœud hébergé dédié plutôt que du matériel en rack maison, le Mac mini M4 reste en 2026 l’un des meilleurs points d’entrée rapport qualité-prix — obtenir un Mac physique distant et transformer application stricte des manifestes et rollback en procédure répétable.