Aller au contenu
Guides

Installer OpenClaw sur un Mac

L’application de barre de menus, le chemin CLI, et quel mode de passerelle choisir

6 min de lecture

L’installation facile d’OpenClaw sur un Mac, c’est l’application de barre de menus : on la télécharge, on la lance, elle installe sa propre passerelle et guide le reste en une seule conversation. L’autre chemin est la CLI Node, la même installation que sous Linux, celle qu’il vous faut si vous ne comptez jamais ouvrir de fenêtre. Les deux n’ont pas les mêmes exigences et la documentation est précise à leur sujet. Voici d’où viennent les versions, ce que fait le premier lancement, le choix entre une passerelle locale et une passerelle distante, et comment l’application se met à jour.

Configuration requise

  • L’application exige macOS 15.0 (Sequoia) ou plus récent, et son assistant natif aussi ; le réveil vocal et le parler-pour-appuyer exigent macOS 26.
  • La CLI et la passerelle exigent un Node pris en charge : les versions officielles de Node 24 et Node 26 veulent macOS 13.5 ou plus récent, et faire tourner la CLI sur un Mac plus ancien ne rend pas l’application compatible avec lui.
  • Les versions viennent de la page des releases GitHub, en dmg, de préférence, ou en zip ; certaines releases ne livrent que la CLI ou des fichiers Windows, prenez donc la plus récente qui a un fichier macOS, ou compilez depuis les sources.

Premier lancement

Installez et lancez, puis choisissez : Ce Mac pour une passerelle locale, ou Se connecter à une passerelle existante avec son adresse et une connexion. Pour une nouvelle passerelle locale, l’application installe son environnement CLI externe et démarre la passerelle ; se connecter à une passerelle distante n’installe rien sur le Mac. Choisissez ensuite la connexion IA : la détection ne propose que celles qu’elle trouve, et en sélectionner une lance une vérification en direct du modèle. L’application ouvre alors le tableau de bord, où le reste de la configuration, import de mémoire, canaux et autorisations, se déroule en une conversation, et les autorisations macOS s’accordent à tout moment depuis la page de réglages de ce Mac. Quick Chat, un compositeur façon Spotlight, se trouve sur Option-Espace.

OpenClaw.app exige macOS 15.0 (Sequoia) ou plus récent.

Local ou distant

  • Local : ce Mac fait tourner la passerelle et la maintient en vie avec launchd. Seul ce mode exige l’installation séparée de la CLI, pour la configuration et la gestion de la passerelle que possède l’application.
  • Distant : un autre hôte fait tourner la passerelle et le Mac la pilote via SSH, le réseau local ou un tailnet. Le nœud Mac de l’application utilise son environnement privé embarqué dans les deux modes.
  • La fenêtre Connexion s’ouvre même quand la passerelle est injoignable, et propose Installer, Mettre à jour ou Réparer la passerelle quand celle que gère l’application manque, est obsolète ou cassée.

Si vous ne voulez que la CLI, Comment installer OpenClaw liste toutes les méthodes, le script d’installation en premier, et La configuration requise pour OpenClaw traite le côté machine de la question.

Mises à jour

La carte de mise à jour dit ce qu’elle va toucher. Mettre à jour l’app Mac + la passerelle signifie que l’application signée possède la passerelle launchd locale : Sparkle met d’abord l’application à jour, puis, après relance, l’application met à jour et redémarre sa passerelle à la version correspondante. Mettre à jour la passerelle signifie que l’application est connectée à une passerelle qu’elle ne possède pas, distante ou gérée à la main, et lance le flux de mise à jour normal de cette passerelle. Chaque bouton demande confirmation. Sparkle suit le canal de mise à jour de la passerelle : beta et dev acceptent les versions beta de l’application, extended-stable n’accepte que les releases correspondantes et reste silencieux sinon. Mettre à jour OpenClaw couvre le côté passerelle, retours en arrière compris.

Sur Diali

Diali, c’est la ligne Distant sans le Mac dans la boucle : la passerelle tourne sur une instance isolée dans l’UE, les mises à jour sont testées d’abord sur nos propres assistants, et votre Mac rejoint l’ensemble, si vous le voulez, comme nœud appairé pour l’écran, les fichiers et les commandes locales. OpenClaw hébergé sur Diali est l’assistant ; Les nœuds OpenClaw et les mains à distance explique ce qu’un Mac appairé peut faire.

  • L’application veut macOS 15 ; la CLI veut macOS 13.5 et un Node pris en charge.
  • Le premier lancement installe la passerelle pour vous, ou se connecte à celle que vous avez déjà.
  • La carte de mise à jour vous dit si elle possède la passerelle ou lui demande seulement de se mettre à jour.
Commencer

Arrêtez de lire, construisez le vôtre

Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.