Mac mini OpenClaw : 8 Go, swap et mémoire unifiée (2026)

Un Mac mini de base avec 8 ou 16 Go de mémoire unifiée est un homelab populaire pour des gateways OpenClaw 24/7 — bots WhatsApp familiaux, alertes cron ou assistant toujours actif d'un fondateur solo. Les tutoriels Linux évoquent rarement la compression mémoire macOS, le swap sur APFS ou la mémoire unifiée Apple Silicon où le Gateway (Node.js) et les modèles locaux Ollama / MLX se partagent le même pool.

La plupart des fils « OpenClaw ne démarre pas » ne sont pas des limites CPU — ce sont des problèmes de budget RAM : la ligne de base du Gateway peut atteindre ~400–700+ Mo RSS au cold start après les versions récentes (voir discussion RSS gateway OpenClaw), avant plugins, sessions ou un modèle local 7B.

Ce guide s'adresse aux constructeurs de l'écosystème Apple — pas aux baies Xeon de datacenter. Vous apprendrez à mesurer, plafonner et planifier la mémoire sur Mac mini M1/M2/M3/M4, avec des liens vers notre guide de routage multi-agent OpenClaw (pourquoi les agents supplémentaires coûtent de la RAM), DeepSeek-R1 / quantification locale, and opérations SSH à distance. Tendances matérielles : infrastructure agents Computex 2026.

Introduction

Cet article couvre le budget mémoire unifiée, les paliers RAM, un runbook macOS en huit étapes, les signaux du Moniteur d'activité, le dépannage et six FAQ pour OpenClaw 24/7.

Mémoire unifiée : un pool, deux charges gourmandes

Apple documente la mémoire unifiée sur présentation Apple Silicon — CPU, GPU et Neural Engine accèdent aux mêmes octets sans VRAM dédiée.

┌─────────────────────────────────────────┐
│     Mémoire unifiée Apple Silicon        │
│  ┌─────────────┐    ┌─────────────────┐ │
│  │ OpenClaw    │    │ Ollama / MLX    │ │
│  │ Gateway     │◀──▶│ local LLM       │ │
│  │ (Node V8)   │    │ (model weights) │ │
│  └─────────────┘    └─────────────────┘ │
│           compression macOS + swap       │
└─────────────────────────────────────────┘

Paliers RAM : réaliste sur 8 Go vs 16 Go

• Si RAM 8 Go → Gateway 24/7, inférence vers API cloud ou un petit modèle Ollama — pas les deux en charge.
• Si RAM 16 Go → 7B Q4 + Gateway unique est le sweet spot homelab Apple Silicon.
• Si vous avez besoin de 3+ agents isolés → augmentez la RAM ou séparez Gateway et Ollama sur deux Mac mini (SSH vers le second).

Runbook pas à pas (macOS)

Étape 1 — Pression mémoire de référence

Ouvrez Moniteur d'activité → Mémoire. Notez Pression mémoire (vert/jaune/rouge) et Swap utilisé.

vm_stat | head -12
sysctl vm.swapusage
memory_pressure 2>/dev/null || true

Jaune/rouge signifie que macOS compresse ou swap déjà — corrigez avant d'ajouter OpenClaw.

Étape 2 — Mesurer le RSS du Gateway OpenClaw

ps aux | grep -i '[o]penclaw' | awk '{print $2,$4,$6/1024"MB",$11}'

Références communauté : ~350 Mo sur anciennes builds, 700 Mo+ sur certains cold starts 2026.4.x. Si le RSS monte chaque jour, redémarrage hebdomadaire jusqu'à réduire les plugins.

Étape 3 — Plafonner le heap Node.js (wrapper)

Un NODE_OPTIONS direct dans les plist LaunchAgent peut être supprimé à la regen. Utilisez le wrapper des docs d'installation Gateway OpenClaw:

cat > ~/bin/openclaw-memwrap.sh << 'EOF'
#!/bin/bash
export NODE_OPTIONS="--max-old-space-size=2048"
exec /opt/homebrew/bin/openclaw "$@"
EOF
chmod +x ~/bin/openclaw-memwrap.sh

OPENCLAW_WRAPPER="$HOME/bin/openclaw-memwrap.sh" openclaw gateway install --force
openclaw doctor

Sur 8 Go utilisez 1536–2048 Mo de heap ; sur 16 Go essayez 3072–4096 Mo. Suivez les OOM dans ~/Library/Logs/ ou Console.app.

Étape 4 — Config OpenClaw allégée

Modifiez ~/.openclaw/openclaw.json :

• Une entrée agents.list jusqu'à upgrade RAM
• Désactivez channels et cron inutilisés
• Reportez les plugins memory search / dreaming sur 8 Go (config mémoire)
• Gardez agent-to-agent désactivé sauf besoin (docs multi-agent)

openclaw gateway restart

Étape 5 — Dimensionner Ollama / modèles locaux à la mémoire unifiée

ollama pull llama3.2:3b-instruct-q4_K_M
ollama ps

Pointez la config modèle OpenClaw vers API ou endpoint local selon les docs OpenClaw. Ne chargez pas 13B+ sur 8 Go avec Gateway résident — macOS swappera et les webhooks Telegram ralentiront. Voir quantification locale DeepSeek-R1.

Étape 6 — Hygiène swap et SSD (favorable à la compression)

• Gardez ≥ 20 Go libres sur le volume de boot (swap sur APFS)
• Préférez Ethernet filaire pour mini headless — le debug Wi‑Fi en session GUI consomme de la RAM
• Évitez que les snapshots Time Machine remplissent le disque aux pics agents
• Sur les liens homelab, stabilisez l'egress pour que les retries ne multiplient pas les buffers Gateway (bande passante instable amplifie les pics mémoire)

while sleep 60; do date; sysctl vm.swapusage; done

Étape 7 — Limiter le travail concurrent (Node n'est pas un pool de threads)

launchctl setenv OLLAMA_NUM_PARALLEL 1

Étape 8 — Opérations headless 24/7

• Réglages Système → Énergie → empêcher veille sur adaptateur secteur
• Utilisez SSH pour l'admin, pas VNC permanent (guide SSH)
• openclaw gateway stop --disable before major macOS upgrades, re-enable after

Aide-mémoire Moniteur d'activité

Dépannage

JavaScript heap out of memory

Schéma : Le Gateway quitte avec FATAL ERROR: Reached heap limit. Correctif : Réduisez le cron concurrent ; wrapper --max-old-space-size ; passez à 16 Go ; déplacez Ollama sur une seconde machine.

Telegram/WhatsApp replies lag but CPU low

Schéma : vm.swapusage en hausse, pression mémoire jaune. Correctif : Arrêtez Ollama avec modèles cloud ; quant 3B ; moins de plugins Gateway ; reboot hebdo du mini.

Ollama loads then Gateway killed

Schéma : Compression mémoire macOS au max, jetsam des processus. Correctif : Sérialisez — Gateway API seule le jour, inférence locale la nuit ; jamais 7B + 3 agents sur 8 Go.

Gateway RSS grows without traffic

Schéma : Régression connue sur certaines versions — scan plugins au démarrage. Correctif : Épinglez une version OpenClaw stable ; surveillez suivi issue RSS; redémarrez le Gateway via cron.

FAQ

Conclusion

L'optimisation mémoire Mac mini OpenClaw est un budget de mémoire unifiée : plafonnez le Gateway Node, dimensionnez les LLM locaux, gardez une marge SSD swap visible et évitez la prolifération multi-agent sur 8 Go. 16 Go est le plancher pratique pour 7B Q4 + Gateway 24/7 ; 8 Go reste viable pour des agents pilotés par API avec une config serrée.

Mesurez avec vm_stat et le Moniteur d'activité, installez le Gateway avec un wrapper mémoire et alignez la profondeur logicielle avec nos guides routage OpenClaw and quantification guides.

Officiel : OpenClaw Gateway CLI · GitHub openclaw/openclaw.

Pour aller plus loin: Guide 2026 : puissance IA — Cursor vs Copilot vs Claude Code