Comment installer OpenClaw sur un Mac mini

Ce qu’est OpenClaw

OpenClaw est un assistant IA open source qui tourne sur votre propre ordinateur. Vous lui parlez depuis les apps de messagerie que vous utilisez déjà. Son README cite Discord, iMessage, Slack, Teams, Telegram et WhatsApp, ainsi que plus de 20 autres (github.com/openclaw/openclaw, octobre 2026).

La pièce centrale est le Gateway. C’est un processus de longue durée qui maintient vos connexions de messagerie et fait tourner l’agent. Si le Gateway s’arrête, l’assistant ne répond plus. C’est pourquoi la machine qui l’héberge compte plus que l’installation.

Prérequis

• Node 24.16 ou plus récent, ou Node 26.1 ou plus récent. Sur macOS, l’installeur ajoute Node 26 si Node est absent (docs.openclaw.ai/install, octobre 2026).
• Un fournisseur de modèle. OpenClaw prend une clé API du fournisseur que vous choisissez pendant l’onboarding.
• N’importe quel Mac Apple silicon. La documentation ne fixe pas de minimum de mémoire. Avec un modèle dans le cloud, 16 Go suffisent largement. Un modèle local, c’est autre chose. Voyez notre guide des LLM locaux.

L’installer

Lancez l’installeur officiel dans le Terminal.

curl -fsSL https://openclaw.ai/install.sh | bash

À la fin, il vous guide dans l’onboarding. Pour installer d’abord et configurer plus tard, la documentation donne une option qui saute l’onboarding. Lancez ensuite l’onboarding vous-même avec l’option de service.

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
openclaw onboard --install-daemon

Nous avons lancé l’installeur sur une machine macOS 26 neuve hébergée par GitHub, le 2 octobre 2026. Node était déjà présent, donc cela a pris environ 25 secondes. Voici ce qu’a affiché la vérification de version.

$ openclaw --version
OpenClaw 2026.9.7 (c074824)

Vérifiez ensuite l’installation et le service avec les commandes documentées.

openclaw doctor
openclaw gateway status

Sur notre machine de test, doctor a signalé trois points avant l’onboarding. Le mode du Gateway n’était pas défini. L’authentification du Gateway n’avait pas de jeton. Et aucun propriétaire des commandes n’était défini. Relancez doctor après l’onboarding et corrigez ce qui reste. Prenez le propriétaire au sérieux. Doctor le décrit comme le compte autorisé à modifier la config, redémarrer le Gateway et approuver les commandes.

Le faire tourner 24/7

L’option de service installe un LaunchAgent. La documentation indique son label, ai.openclaw.gateway, et son fichier, ai.openclaw.gateway.plist, dans le dossier LaunchAgents de la Library de votre dossier personnel. launchd le démarre à l’ouverture de session et le relance s’il plante. Les logs vont dans un seul fichier.

openclaw gateway status --deep
openclaw gateway restart
openclaw health
tail -f ~/Library/Logs/openclaw/gateway.log

Vous pouvez aussi installer le service seul, sans onboarding. Nous l’avons fait sur une deuxième machine de test. Nous avons mis le mode du Gateway sur local, laissé doctor générer un jeton, puis lancé la commande d’installation.

openclaw config set gateway.mode local
openclaw doctor --fix --generate-gateway-token
openclaw gateway install

Environ 15 secondes plus tard, la commande de statut montrait le service actif.

$ openclaw gateway status
Service file: ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Gateway: bind=loopback (127.0.0.1), port=18789 (service args)
Dashboard: http://127.0.0.1:18789/
Gateway version: 2026.9.7
Runtime: running (pid 16165, state active)
Connectivity probe: ok
Listening: 127.0.0.1:18789

Un LaunchAgent ne tourne que si un utilisateur a ouvert sa session. Après un redémarrage, rien ne démarre tant que personne ne se connecte. Sur un Mac sans surveillance, activez l’ouverture de session automatique pour le compte qui fait tourner OpenClaw. Empêchez ensuite la machine de se mettre en veille. La veille fige le Gateway et coupe toutes les connexions de messagerie.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Les raisons, et les règles pour l’écran rabattu d’un portable, sont dans ce qui se passe quand un Mac se met en veille. La liste complète, coupures de courant comprises, est dans le guide du Mac toujours allumé.

Notes de sécurité

• Dans une installation normale, le Gateway n’écoute que sur loopback. Laissez-le ainsi. Pour atteindre le tableau de bord depuis votre portable, la documentation utilise un tunnel SSH.
• Les expéditeurs inconnus en message direct reçoivent un code d’appairage, pas une réponse. Vous les approuvez avec la commande d’appairage ci-dessous.
• Par défaut, les outils tournent sur l’hôte, sauf si vous configurez un sandbox. L’agent peut toucher à tout ce que cet utilisateur macOS peut toucher.
• Les secrets sont stockés sur disque dans le dossier d’état d’OpenClaw, avec la config dans openclaw.json à l’intérieur. Traitez ce dossier comme un fichier de mots de passe.
• Lancez l’audit intégré après chaque changement de config. Sur notre installation de test neuve, il a signalé 0 point critique, 1 avertissement et 1 information.

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
openclaw pairing approve <channel> <code>
openclaw security audit

La protection la plus simple est physique. Faites tourner OpenClaw sur un Mac qui ne contient rien d’autre à vous. Pas d’identifiant Apple personnel, pas de gestionnaire de mots de passe, pas de navigateur rempli de sessions ouvertes. Si l’agent fait quelque chose d’étrange, les dégâts s’arrêtent à cette machine.

Le faire tourner sur un Mac MacRun

Notre offre Agent est un Mac mini dédié qui ne se met jamais en veille. Sa session revient toute seule après un redémarrage, donc les LaunchAgents redémarrent aussi. Claude Code et Codex sont installés. OpenClaw n’est pas préinstallé. Vous l’installez vous-même avec les commandes ci-dessus, car vous avez tous les droits administrateur. OpenClaw a besoin d’une clé API du fournisseur de modèle choisi pendant l’onboarding.

Qui ne devrait pas passer par nous pour cela. MacRun sert au travail de développement, selon notre politique d’utilisation acceptable. Un OpenClaw qui écrit du code, surveille la CI ou trie des issues a sa place. Un OpenClaw qui gère vos e-mails personnels et l’agenda familial ne l’a pas. Par ailleurs, OpenClaw tourne sous Linux. Si vous n’avez besoin de rien de macOS, un petit serveur Linux coûte moins cher que n’importe quel Mac.

Prêt à l’essayer sur une machine qui reste allumée ? Comparez les offres sur la page du Mac pour agents.