OpenClaw peut être installé sur Mac de plusieurs façons, selon vos préférences de travail et de gestion de votre configuration. Dans ce guide, vous trouverez des instructions pas à pas pour différentes méthodes d’installation, ainsi que des conseils pour lancer OpenClaw dans les meilleures conditions.
Aperçu rapide : trois façons d’installer OpenClaw sur Mac
Voici une comparaison côte à côte des trois méthodes. Elles se distinguent par le niveau de configuration manuelle requis.
| Installateur en une ligne | Homebrew | Kimi Claw (en ligne) | |
|---|---|---|---|
| Présentation | Script d’installation officiel qui télécharge et configure OpenClaw automatiquement | Configuration manuelle avec Homebrew pour installer les dépendances (comme Node.js), puis exécution d’OpenClaw via la CLI | Outil en ligne permettant d’exécuter OpenClaw dans le cloud sans configuration manuelle |
| Étapes manuelles requises | Étapes manuelles minimales | Plusieurs étapes manuelles requises | Aucune configuration manuelle requise |
| Code ou terminal requis | Oui | Oui | Non |
| Disponibilité 24 h/24 et 7 j/7 | Fonctionne uniquement lorsque votre Mac est actif | Fonctionne uniquement lorsque votre Mac est actif | Fonctionne 24 h/24 et 7 j/7 dans le cloud |
| Idéal pour | Les nouveaux utilisateurs qui veulent la configuration locale la plus rapide | Les développeurs qui préfèrent gérer leurs paquets avec Homebrew | Les utilisateurs qui veulent exécuter OpenClaw sans configuration locale |
Kimi Claw vous permet d’exécuter OpenClaw dans le cloud sans configurer Node.js, Homebrew ni clés API. Vous pouvez commencer à utiliser un agent opérationnel dans votre navigateur en quelques minutes.
Si vous préférez une configuration locale, passez à la section suivante. Si vous souhaitez une option plus simple, allez directement à la section Exécuter OpenClaw sur Mac avec Kimi Claw, ou cliquez sur le bouton ci-dessous pour démarrer immédiatement.
Avant de commencer : préparation essentielle et sécurité
Avant d’installer OpenClaw localement sur Mac, quelques étapes de préparation et de sécurité sont nécessaires. Si vous prévoyez d’utiliser Kimi Claw, vous pouvez ignorer cette section et passer directement aux instructions de configuration ci-dessous.
Dépendances : l’installateur en une ligne installe automatiquement Node.js si nécessaire. Si vous choisissez Homebrew, vous devez installer Node.js manuellement (Node 24 recommandé ; Node 22 LTS 22.16+ fonctionne également).
Pare-feu et paramètres réseau : le pare-feu macOS est généralement désactivé par défaut. Vous pouvez l’activer dans Réglages Système > Réseau > Pare-feu. OpenClaw lie la passerelle à 127.0.0.1 (localhost), afin que les autres appareils de votre réseau ne puissent pas s’y connecter directement. Si vous avez besoin d’un accès mobile ou distant, vous pouvez utiliser des outils comme Tailscale ou un tunnel SSH. Ne redirigez pas le port
18789via votre routeur.
Installer OpenClaw sur Mac avec le script en une ligne
C’est le moyen le plus rapide d’exécuter OpenClaw localement sur Mac. OpenClaw s’exécute depuis Terminal et propose une interface dans le navigateur pour gérer votre agent, plutôt qu’une application graphique traditionnelle. Une seule commande installe la CLI, vérifie votre version de Node.js et lance l’assistant de démarrage.
Étape 1. Exécuter le script d’installation dans Terminal
Ouvrez Terminal avec Spotlight (⌘ + Space), puis collez la commande suivante :
Le script détecte votre système, installe la CLI OpenClaw et vérifie votre version de Node.js. Si Node.js est absent ou obsolète, il installe automatiquement Node 24 (Node 22 LTS 22.16+ est également pris en charge).
Étape 2. Définir votre clé API et configurer la passerelle
L’assistant de démarrage se lance automatiquement une fois l’installation terminée. Sélectionnez Moonshot AI (Kimi K2.5) comme fournisseur LLM et collez votre clé Kimi API lorsque vous y êtes invité. Acceptez les paramètres par défaut pour le port de la passerelle et l’authentification. Si vous voulez qu’OpenClaw démarre automatiquement au démarrage de votre Mac, choisissez l’option d’installation du démon pendant l’assistant.
Étape 3. Vérifier la passerelle et ouvrir le tableau de bord
Exécutez la commande suivante pour vérifier que la passerelle est en cours d’exécution :
Ouvrez ensuite le tableau de bord :
Cette commande ouvre la Control UI dans votre navigateur à l’adresse http://127.0.0.1:18789. Saisissez votre token de passerelle pour vous connecter. Une fois connecté, vous pouvez commencer à interagir avec votre agent OpenClaw.
Installer OpenClaw sur Mac avec Homebrew
Si vous préférez gérer vos paquets avec Homebrew, vous pouvez installer OpenClaw sur Mac via une configuration plus manuelle. Cette méthode vous donne davantage de contrôle sur les dépendances et s’intègre à votre workflow Homebrew existant.
Étape 1. Installer Homebrew
Ouvrez Terminal avec Spotlight (⌘ + Space). Si Homebrew n’est pas installé, exécutez la commande suivante. Homebrew est un gestionnaire de paquets pour macOS qui permet d’installer et de gérer des outils de développement depuis Terminal, un peu comme une boutique d’applications installe des apps.
Pendant l’installation, il peut vous être demandé de saisir le mot de passe de connexion de votre Mac. Notez que, pour des raisons de sécurité, Terminal n’affiche aucun caractère pendant la saisie. Vous pouvez aussi voir des invites de confirmation et des messages indiquant les fichiers en cours d’installation.
Une fois l’installation terminée, un message de réussite et les étapes suivantes s’affichent dans Terminal.
Étape 2. Installer Node.js
Une fois Homebrew installé, installez Node.js :
Après l’installation, vérifiez que la version est v24 (recommandée) ou v22.16+.
Étape 3. Installer la CLI OpenClaw et lancer l’assistant de démarrage
Installez la CLI globalement avec npm, puis lancez l’assistant de démarrage :
Si une erreur d’autorisation EACCES apparaît pendant npm install -g, votre répertoire global npm nécessite des droits élevés. Exécutez sudo npm install -g openclaw@latest, ou modifiez le répertoire par défaut de npm afin d’éviter d’utiliser sudo à l’avenir.
L’option --install-daemon enregistre OpenClaw comme LaunchAgent, afin que la passerelle démarre automatiquement lorsque vous vous connectez. Pendant l’assistant de démarrage, sélectionnez Moonshot AI (Kimi K2.5) comme fournisseur et saisissez votre clé Kimi API.
Étape 4. Vérifier la passerelle et ouvrir le tableau de bord
Vérifiez que la passerelle est en cours d’exécution, puis ouvrez le tableau de bord :
La Control UI s’ouvre dans votre navigateur. Saisissez votre token de passerelle : vous êtes prêt.
Exécuter OpenClaw sur Mac avec Kimi Claw
Kimi Claw est un outil en ligne qui vous permet d’exécuter OpenClaw dans le cloud sans configuration locale. Vous n’avez rien à installer sur votre Mac, et vous n’avez pas besoin d’utiliser Terminal ni de gérer les dépendances. Tout fonctionne dans votre navigateur. Vous pouvez créer un agent OpenClaw en quelques minutes. Kimi Claw prend en charge la passerelle, l’espace de travail, le stockage et l’accès au modèle, afin que votre agent reste en ligne 24 h/24 et 7 j/7, même lorsque votre MacBook est fermé.
Comment utiliser Kimi Claw ?
Étape 1. Ouvrir Kimi Claw
Accédez à la page Kimi Claw et cliquez sur Create pour commencer le déploiement de votre environnement OpenClaw.
Étape 2. Déployer OpenClaw automatiquement
Confirmez le déploiement dans la fenêtre contextuelle. Kimi Claw configure alors l’environnement OpenClaw, y compris la passerelle, l’espace de travail et les outils. Le processus se termine généralement en quelques minutes.
Étape 3. Commencer à utiliser OpenClaw
Une fois le déploiement terminé, votre espace de travail s’ouvre dans le tableau de bord. Discutez avec votre agent, configurez des compétences, planifiez des tâches et gérez vos fichiers, le tout depuis le navigateur.
Ce qui distingue Kimi Claw d’une exécution locale d’OpenClaw
Kimi Claw offre une façon plus simple d’exécuter OpenClaw sans configuration locale. Au lieu d’installer des dépendances et de gérer un environnement local, vous pouvez lancer votre agent directement dans le navigateur pendant que Kimi Claw prend en charge la configuration sous-jacente et l’infrastructure.
Aucune configuration locale requise : exécutez OpenClaw sans installer Node.js ni utiliser Terminal. Tout fonctionne directement dans votre navigateur, ce qui vous permet de démarrer plus vite et d’éviter les problèmes de configuration d’environnement.
Accès instantané à plus de 5 000 compétences : au lieu d’installer des outils manuellement, Kimi Claw peut utiliser automatiquement les compétences nécessaires à votre tâche depuis une vaste bibliothèque d’outils disponibles, ce qui réduit le temps de configuration et les problèmes de compatibilité.
Automatisation et planification toujours actives : contrairement aux agents locaux qui s’arrêtent lorsque votre Mac se met en veille, Kimi Claw fonctionne 24 h/24 et 7 j/7 dans le cloud, ce qui le rend adapté aux tâches planifiées et aux workflows de longue durée.
40 Go de stockage cloud et mémoire persistante : contrairement aux configurations locales, où les fichiers sont généralement liés à un seul appareil, Kimi Claw inclut 40 Go de stockage, ce qui rend vos rapports et recherches accessibles depuis n’importe quel navigateur. Il mémorise également vos préférences et votre contexte de travail d’une session à l’autre, afin que vous puissiez reprendre là où vous vous étiez arrêté.
Modèle Kimi K2.5 intégré et recherche de niveau professionnel : Kimi Claw inclut un accès intégré à Kimi K2.5 et des fonctionnalités de recherche avancées ; vous n’avez donc pas à gérer de clés API ni à configurer des services externes. Il peut intégrer automatiquement des informations à jour dans des domaines comme la finance, la technologie et l’actualité, pour rendre la recherche et l’exécution des tâches plus fluides.
Maintenir OpenClaw en fonctionnement 24 h/24 et 7 j/7 sur Mac
La plupart des utilisateurs considèrent l’AI comme une application de bureau classique : ils l’utilisent à leur poste, puis la ferment une fois terminé. Pour une automatisation à forte valeur ajoutée — surveiller les marchés mondiaux pendant la nuit ou recevoir un rapport de recherche dans votre boîte de réception à 8 h, par exemple — votre agent doit rester actif en continu. Comme macOS suspend naturellement les processus locaux lorsque le système se met en veille, il faut adopter une stratégie adaptée. Cette section présente deux façons de conserver une connexion persistante :
Option A : matériel Mac dédié
Une option consiste à laisser un Mac (par exemple un Mac mini) fonctionner en continu. Vous pouvez désactiver la veille avec sudo pmset -a sleep 0 et activer « Réactiver lors des accès réseau » dans Réglages Système. Pour l’accès à distance, vous pouvez utiliser des outils comme Tailscale ou un tunnel SSH.
Cette configuration maintient OpenClaw en fonctionnement sur votre propre matériel, mais elle suppose de garder la machine allumée et de gérer vous-même la maintenance, les mises à jour et les redémarrages.
Option B : Kimi Claw s’en charge automatiquement
Si vous exécutez votre agent avec Kimi Claw, la disponibilité 24 h/24 et 7 j/7 est intégrée. Votre agent fonctionne indépendamment de votre appareil local : il continue donc à travailler même lorsque votre Mac est fermé ou hors ligne. Inutile de modifier les réglages de veille ou de laisser une machine allumée.
Corriger les erreurs courantes d’installation d’OpenClaw sur Mac
Même avec une configuration simple, des problèmes peuvent survenir pendant l’installation. Voici les plus fréquents, avec leurs solutions.
Erreur « commande OpenClaw introuvable »
Cause : le répertoire bin global de npm ne figure pas dans le PATH de votre shell.
Solution : exécutez
source ~/.zshrcpour recharger la configuration de votre shell. Si vous utilisez Bash au lieu de Zsh, remplacez~/.zshrcpar~/.bash_profile. Si l’erreur persiste, recherchez votre préfixe npm et ajoutez-le au PATH :
OpenClaw ne démarre pas après redémarrage
Cause : le LaunchAgent n’a pas été installé pendant l’assistant de démarrage.
Solution : exécutez la commande d’assistant de démarrage avec l’option de démon :
Cela enregistre un LaunchAgent qui démarre automatiquement la passerelle OpenClaw lorsque vous vous connectez. Pour vérifier qu’il est actif :
Le port 18789 est déjà utilisé
Cause : un autre processus occupe le port de la passerelle.
Solution : recherchez et arrêtez le processus en conflit :
Erreur liée aux Xcode Command Line Tools lors de l’installation d’une compétence
Cause : certains paquets npm nécessitent une compilation native, et les Xcode Command Line Tools sont absents ou obsolètes.
Solution : installez ou mettez à jour les outils :
Une fois l’installation terminée, réessayez d’installer la compétence.
Version de Node.js trop ancienne
Cause : la version de Node.js installée sur votre Mac est antérieure à 22.16. OpenClaw nécessite Node 24 (recommandé) ou Node 22 LTS 22.16+.
Solution : si vous avez utilisé Homebrew :
Si vous avez utilisé l’installateur en une ligne, relancez-le. Le script détectera la version obsolète et la mettra à jour.
Conclusion
OpenClaw peut s’exécuter localement sur votre Mac avec l’installateur en une ligne ou Homebrew, ou dans votre navigateur avec Kimi Claw, sans configuration locale. Chaque méthode permet d’obtenir un agent opérationnel, mais demande un niveau d’intervention manuelle différent. Si vous souhaitez une configuration plus rapide avec une disponibilité 24 h/24 et 7 j/7 intégrée, vous pouvez commencer avec Kimi Claw et disposer d’un agent fonctionnel en quelques minutes.
FAQ
openclaw onboard --install-daemon pour enregistrer un LaunchAgent qui démarre la passerelle à l’ouverture de session. Si le démon est déjà installé mais ne démarre pas, vérifiez son état avec launchctl list | grep openclaw et consultez les journaux système. Les utilisateurs de Kimi Claw n’ont pas besoin de cette configuration, car le service s’exécute sur des serveurs cloud et reste en ligne de façon autonome.source ~/.zshrc pour recharger la configuration. Si la commande reste introuvable, exécutez npm config get prefix pour localiser le répertoire bin et ajoutez-le à votre PATH dans ~/.zshrc. Redémarrez Terminal après la modification.sudo pmset -a sleep 0) et un accès distant via Tailscale, ou utiliser Kimi Claw. Kimi Claw est une plateforme entièrement gérée qui maintient votre agent OpenClaw en ligne en continu, sans matériel à entretenir.curl -fsSL https://openclaw.ai/install.sh | bash. Le script installe OpenClaw, vérifie votre version de Node.js et vous guide dans la configuration. Vous pouvez aussi utiliser Homebrew : exécutez brew install node, puis npm install -g openclaw@latest. Pour une option entièrement gérée qui ne nécessite aucun terminal, Kimi Claw exécute OpenClaw dans votre navigateur, sans configuration locale.curl -fsSL https://openclaw.ai/install.sh | bash) ou installez via Homebrew avec npm install -g openclaw@latest. Pour une option dans le navigateur, sans téléchargement, Kimi Claw exécute OpenClaw pour vous sur des serveurs cloud.