Installer et déployer OpenClaw sur Mac mini M4 avec ProxyMac — Guide complet 2026

OpenClaw est un agent d'automatisation basé sur Claude qui orchestre des tâches sur navigateur, terminal et système de fichiers — idéal pour les workflows de développement complexes nécessitant un vrai environnement macOS. Sur un mini loué headless accessible uniquement en SSH, exécutez d'abord la checklist SSH avant launchd (2026-05-13) — espace disque, PATH et tests plist réduisent les régressions launchd avant de coller des installateurs. Déployé sur un nœud Mac mini M4 ProxyMac, OpenClaw combine la puissance de l'IA de dernière génération avec une infrastructure Apple Silicon stable et accessible 24/7. Ce guide couvre l'intégralité du processus : prérequis, installation, daemon de persistance et optimisations de production.

Étape 1 : Préparer les prérequis

Connectez-vous à votre nœud Mac mini via SSH et vérifiez l'environnement :

ssh proxymac-user@<votre-noeud>.proxymac.com # Vérification de la version macOS et architecture sw_vers && uname -m # doit afficher arm64 # Installer Homebrew si absent /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Ajouter Homebrew au PATH pour Apple Silicon echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile source ~/.zprofile # Installer Node.js 20 LTS (requis par OpenClaw) brew install node@20 echo 'export PATH="/opt/homebrew/opt/node@20/bin:$PATH"' >> ~/.zprofile source ~/.zprofile # Vérifier les versions node --version # doit afficher v20.x.x npm --version # doit afficher 10.x.x git --version # doit être disponible

Comparatif des versions Node.js pour OpenClaw

Version Node.js	Compatibilité OpenClaw	Support ARM64 natif	Recommandation
v20 LTS	Complète	Oui	Recommandée (ce guide)
v22 Current	Partielle (expérimental)	Oui	Déconseillée en production
v18 LTS	Minimale	Oui	Fonctionnelle mais non maintenue
v16 ou moins	Aucune	Partiel	Incompatible

Étape 2 : Installer OpenClaw

Clonez le dépôt OpenClaw et installez les dépendances :

# Créer un répertoire de travail propre mkdir -p ~/agents && cd ~/agents # Cloner OpenClaw git clone https://github.com/openclaw-ai/openclaw.git cd openclaw # Installer les dépendances (build natif ARM64 automatique) npm install # Vérifier l'installation npm run check 2>&1 | head -20

Configuration du fichier .env

Créez le fichier de configuration :

cp .env.example .env nano .env

Variables essentielles à configurer :

# Clé API Anthropic (obligatoire) ANTHROPIC_API_KEY=sk-ant-api03-... # Port du serveur web OpenClaw OPENCLAW_PORT=3000 # Répertoire de travail des agents AGENTS_WORKSPACE=/Users/proxymac/agents/workspace # Niveau de log (info | debug | warn | error) LOG_LEVEL=info # Timeout max par tâche (en ms) TASK_TIMEOUT_MS=300000 # Activer la persistance de l'historique ENABLE_HISTORY=true HISTORY_DIR=/Users/proxymac/agents/history

Étape 3 : Configurer le daemon LaunchAgent

Pour qu'OpenClaw démarre automatiquement et survive aux redémarrages, configurez un LaunchAgent macOS :

mkdir -p ~/Library/LaunchAgents cat > ~/Library/LaunchAgents/com.openclaw.agent.plist << 'EOF' <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>com.openclaw.agent</string> <key>ProgramArguments</key> <array> <string>/opt/homebrew/opt/node@20/bin/node</string> <string>/Users/proxymac/agents/openclaw/src/index.js</string> </array> <key>WorkingDirectory</key> <string>/Users/proxymac/agents/openclaw</string> <key>EnvironmentVariables</key> <dict> <key>PATH</key> <string>/opt/homebrew/opt/node@20/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string> <key>HOME</key> <string>/Users/proxymac</string> </dict> <key>StandardOutPath</key> <string>/Users/proxymac/agents/logs/openclaw.stdout.log</string> <key>StandardErrorPath</key> <string>/Users/proxymac/agents/logs/openclaw.stderr.log</string> <key>RunAtLoad</key> <true/> <key>KeepAlive</key> <true/> </dict> </plist> EOF # Créer les répertoires de logs mkdir -p ~/agents/logs ~/agents/workspace ~/agents/history # Charger le LaunchAgent launchctl load ~/Library/LaunchAgents/com.openclaw.agent.plist # Vérifier le statut launchctl list | grep openclaw

Étape 4 : Configuration production

Pour un déploiement de production stable sur ProxyMac, configurez ces éléments supplémentaires :

Rotation des logs

cat > ~/agents/openclaw/scripts/rotate-logs.sh << 'SCRIPT' #!/bin/bash LOG_DIR="$HOME/agents/logs" MAX_SIZE_MB=100 for log in "$LOG_DIR"/*.log; do size=$(du -m "$log" 2>/dev/null | cut -f1) if [ "${size:-0}" -gt "$MAX_SIZE_MB" ]; then mv "$log" "${log}.$(date +%Y%m%d-%H%M%S).bak" gzip "${log}.$(date +%Y%m%d-%H%M%S).bak" & fi done SCRIPT chmod +x ~/agents/openclaw/scripts/rotate-logs.sh # Planifier la rotation toutes les 6 heures via cron (crontab -l 2>/dev/null; echo "0 */6 * * * ~/agents/openclaw/scripts/rotate-logs.sh") | crontab -

Monitoring avec script de santé

cat > ~/agents/openclaw/scripts/health-check.sh << 'SCRIPT' #!/bin/bash PORT=${OPENCLAW_PORT:-3000} response=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:$PORT/health) if [ "$response" != "200" ]; then echo "$(date): OpenClaw health check FAILED (HTTP $response)" >> ~/agents/logs/health.log launchctl kickstart -k gui/$(id -u)/com.openclaw.agent else echo "$(date): OpenClaw OK" >> ~/agents/logs/health.log fi SCRIPT chmod +x ~/agents/openclaw/scripts/health-check.sh # Vérification toutes les 5 minutes (crontab -l 2>/dev/null; echo "*/5 * * * * ~/agents/openclaw/scripts/health-check.sh") | crontab -

Dépannage courant

Problème	Diagnostic	Solution
OpenClaw ne démarre pas	tail -f ~/agents/logs/openclaw.stderr.log	Vérifier ANTHROPIC_API_KEY et les chemins dans .env
Port déjà utilisé	lsof -i :3000	Changer OPENCLAW_PORT dans .env ou tuer le processus
Erreur de permission sur macOS 15	Console.app → "openclaw"	Autoriser dans Réglages → Confidentialité & Sécurité → Automatisation
Crash après timeout	grep "TASK_TIMEOUT" ~/agents/logs/openclaw.stdout.log	Augmenter TASK_TIMEOUT_MS à 600000 (10 min)
LaunchAgent ne redémarre pas	launchctl list | grep openclaw	Recharger : launchctl unload && launchctl load
npm install échoue sur ARM64	Erreur node-gyp	Installer Xcode CLI : xcode-select --install

Pourquoi le Mac mini M4 est la plateforme idéale pour OpenClaw

OpenClaw est un agent IA à forte intensité de calcul — il orchestre simultanément des appels API Claude, des opérations fichiers, du JavaScript browser et des exécutions terminal. Sur un Mac mini M4 standard avec 16 Go de mémoire unifiée, tous ces workloads partagent le même bus mémoire haute vitesse sans contention NUMA.

Nos benchmarks de déploiement montrent qu'un Mac mini M4 peut gérer 4 instances OpenClaw concurrentes (chacune traitant des tâches complexes de 5–10 minutes) tout en maintenant une utilisation CPU globale inférieure à 60% et une consommation mémoire sous 12 Go. Le SSD interne NVMe du M4 avec ~7 GB/s en lecture élimine les goulots d'étranglement d'accès aux fichiers workspace des agents.

Avec ProxyMac, vous n'avez pas besoin d'investir dans votre propre matériel Apple Silicon ni de gérer les mises à jour macOS et la maintenance hardware. Déployez votre infrastructure OpenClaw en moins de 10 minutes — consultez les tarifs ProxyMac pour démarrer.