Dépannage et récupération OpenClaw sur Mac mini M4 (2026)

Après le guide d’installation et les workflows de production, ce guide traite des plantages du daemon et du LaunchAgent. SSH instable : voir stabilité SSH.

Tri des symptômes (60 s)

1. openclaw status
2. df -h ~
3. node --version ≥22
4. Test HTTPS vers le fournisseur IA

Journaux

Pour l’aide : fin des logs daemon, launchctl list | grep -i openclaw, mises à jour macOS récentes.

LaunchAgent

bootout → corriger plist → bootstrap. L’enregistrement d’écran : une fois en VNC.

Ports & API

lsof -nP -iTCP:3000. Proxy d’entreprise : variables dans le plist LaunchAgent.

Si des tâches meurent silencieusement sous launchd (mémoire, « too many open files »), consultez d’abord OpenClaw : ulimit, mémoire et garde-fous CPU avant TLS ou le proxy amont.

Symptôme	Cause	Test
Tout échoue	Pare-feu	curl -v
429	Concurrence	Réduire les tâches

Répertoire d’état

Pas iCloud ; ~/.openclaw, chmod 700.

Matrice

État	Action
Daemon arrêté	Recharger l’agent
Config corrompue	Restaurer JSON

FAQ

tmux ?

Pour longues sessions ; le daemon reste sous LaunchAgent.

Réinstall ?

Rapide si petit état + sauvegarde.

Multi-utilisateur ?

Éviter root sur le state.

Mac mini M4

Nœud dédié, IO prévisible. Tarifs, installation.