2026 — OpenClaw Active Memory et sous-agents sur Mac physique distant : migration MEMORY.md, chaleur d'écriture et audits JSONL alignés sur la sandbox passerelle — runbook 7j/7 pour longues sessions (extraits de configuration + FAQ)

2. Points de friction

1. Contrainte : chemins relatifs × plusieurs cwd. Les sous-agents lancés depuis un sous-dossier du dépôt écrivent MEMORY.md profond dans l'arbre tandis que le parent lit encore l'ancien emplacement — scission de chemins, pas une amnésie inexplicable.
2. Coût caché : chaleur d'écriture = amplification. Réécritures complètes à chaque tour avec fsync, combinées au JSONL d'audit, peuvent saturer l'iowait sur des hôtes 7j/7 avant même le trafic métier.
3. Stabilité et audit : deux rédacteurs, deux arbres. Quand la sandbox bloque les chemins hôte, les sous-agents déposent les audits dans des répertoires privés et les jointures jq côté hôte échouent — en général requestId et politique des chemins inscriptibles n'ont jamais été unifiés.

3. Matrices de décision

Utilisez-les avant la mise en production pour trancher où vit la mémoire et à quelle cadence vous videz sur disque.

4. Extraits de configuration (alignés sandbox)

JSON illustratif — les noms de champs doivent correspondre à votre version OpenClaw figée. Non négociables : chemins absolus, listes blanches et propagation du requestId.

{
  "memory": {
    "path": "/Users/ocagent/workspace/MEMORY.md",
    "encoding": "utf-8",
    "flush": { "maxEvents": 32, "intervalMs": 5000, "halfLifeRounds": 12 }
  },
  "subagents": {
    "defaultCwd": "/Users/ocagent/workspace",
    "inheritEnv": ["OPENCLAW_REQUEST_ID", "MEMORY_PATH"]
  },
  "gateway": {
    "auditJsonl": "/Users/ocagent/logs/gateway-audit.jsonl",
    "sandbox": {
      "writable": [
        "/Users/ocagent/workspace/.sandbox/scratch",
        "/Users/ocagent/logs/sandbox-audit.jsonl"
      ]
    }
  }
}

Dans le plist launchd, exportez MEMORY_PATH et OPENCLAW_REQUEST_ID (ou faites définir ces variables par enveloppe passerelle à chaque requête) afin qu'une session SSH au premier plan ne diverge pas du démon sans présence humaine.

5. Runbook en sept étapes (Mac physique distant)

1. Geler les chemins faisant foi. Documentez fichier MEMORY, JSONL d'audit et répertoire scratch sandbox en chemins absolus sur la page de garde du runbook — aucune divergence wiki / commentaires.
2. Migrer MEMORY.md. Copie en maintenance ou lecture seule, vérifiez avec diff, horodatez les métadonnées migratedAt dans le bloc d'en-tête.
3. Normaliser le cwd des sous-agents. Forcez defaultCwd vers le workspace principal ou passez un drapeau mémoire explicite équivalent.
4. Activer le schéma JSONL. Accordez-vous sur ts, level, requestId, actor, memoryOp, durationMs pour la passerelle et les enfants.
5. Acceptation sandbox. Sondes : écritures hors liste blanche échouent et émettent des lignes deny ; les succès restent sous writable.
6. Régler la chaleur d'écriture. En passant du vidage complet par tour aux lots fenêtrés, rejouez un script de conversation 24 h et observez iostat plus la croissance JSONL.
7. Rejouage des jointures. Jointure externe des JSONL hôte et sandbox sur requestId avec jq ; toute paire manquante bloque la promotion en production.

6. Seuils réutilisables

• Fenêtre de vidage par lots (démarrage) : environ 3–8 s ou 16–32 événements, selon la première limite atteinte ; allongez avec la demi-vie pour les sessions très longues.
• Rotation JSONL d'audit : découpez vers 128–256 Mo pour que la synchro stockage objet ne traîne pas des queues multi-gigaoctets.
• SLA de jointure : en préprod, 0 % de paires requestId manquantes sur une heure ; alerte production si le taux dépasse durablement 0,1 % hors classes de dérive d'horloge que vous documentez.

7. FAQ

8. Synthèse : pourquoi le Mac mini convient à la mémoire active et à l'I/O d'audit sur longues sessions

Active Memory avec audit JSONL, c'est en pratique de petites écritures fréquentes plus des processus longue durée : la qualité du disque, l'équité du planificateur et le comportement énergétique déterminent si votre stratégie de chaleur d'écriture tient. Le Mac mini Apple Silicon (par exemple M4) combine bande passante mémoire unifiée et une consommation au repos d'environ ~4 W, ce qui convient à des passerelles 7j/7 silencieuses gardant mémoire et journaux sur stockage local rapide.

macOS fournit aussi launchd, Unified Logging et des instantanés APFS pour raccourcir le triage lorsqu'apparaît une ligne deny de sandbox ou une régression de vidage — en complément du durcissement Gatekeeper et SIP face à l'exposition malware typique des boîtiers Windows toujours allumés.

Si vous déplacez des longues sessions d'un portable vers un Mac physique distant pour que sous-agents, sandbox passerelle et rotation JSONL partagent une base prévisible, le Mac mini M4 reste l'un des ancres les plus rentables aujourd'hui — figez les chemins une fois et laissez le même profil matériel porter votre runbook de la préprod à la production.