OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

macOS companion app

Configuration de l’environnement de développement sous macOS

Configuration de l’environnement de développement macOS

Compilez et exécutez l’application OpenClaw pour macOS à partir du code source.

Prérequis

  • Xcode 26.2+ (chaîne d’outils Swift 6.2), sur la dernière version de macOS disponible dans Software Update.
  • Node.js 24.15+ et pnpm pour le Gateway, la CLI et les scripts de mise en paquet. Node 22.22.3+ fonctionne également.

1. Installer les dépendances

bash
pnpm install

2. Compiler et mettre en paquet l’application

bash
./scripts/package-mac-app.sh

Génère dist/OpenClaw.app. En l’absence de certificat Apple Developer ID, le script utilise à défaut une signature ad hoc.

Pour les modes d’exécution de développement, les options de signature et la résolution des problèmes liés à l’identifiant d’équipe, consultez apps/macos/README.md. Boucle de développement rapide depuis la racine du dépôt : scripts/restart-mac.sh (ajoutez --no-sign pour la signature ad hoc ; les autorisations TCC ne sont pas conservées avec --no-sign).

3. Installer la CLI et le Gateway

L’application mise en paquet intègre le programme d’installation canonique scripts/install-cli.sh. Sur un nouveau profil, choisissez This Mac pendant la configuration initiale ; l’application installe la CLI et l’environnement d’exécution correspondants dans l’espace utilisateur avant de démarrer l’assistant du Gateway.

Pour une récupération manuelle de l’environnement de développement, installez vous-même la CLI correspondante :

bash
npm install -g openclaw@<version>

pnpm add -g openclaw@<version> et bun add -g openclaw@<version> fonctionnent également. Node reste l’environnement d’exécution recommandé pour le Gateway lui-même.

Résolution des problèmes

Échec de la compilation : incompatibilité de la chaîne d’outils ou du SDK

La compilation de l’application macOS nécessite la dernière version du SDK macOS et la chaîne d’outils Swift 6.2 (Xcode 26.2+).

bash
xcodebuild -versionxcrun swift --version

Si les versions ne correspondent pas, mettez à jour macOS/Xcode et relancez la compilation.

L’application plante lors de l’octroi d’une autorisation

Si l’application plante lorsque vous tentez d’autoriser l’accès à Speech Recognition ou au Microphone, il peut s’agir d’un cache TCC corrompu ou d’une incompatibilité de signature.

  1. Réinitialisez les autorisations TCC pour l’identifiant du paquet de débogage :

    bash
    tccutil reset All ai.openclaw.mac.debug

  2. Si cela échoue, modifiez temporairement BUNDLE_ID dans scripts/package-mac-app.sh afin de repartir sur une configuration macOS vierge.

Le Gateway reste indéfiniment sur « Starting... »

Vérifiez si un processus zombie occupe le port :

bash
openclaw gateway statusopenclaw gateway stop # Si vous n’utilisez pas de LaunchAgent (mode développement / exécutions manuelles), recherchez le processus à l’écoute :lsof -nP -iTCP:18789 -sTCP:LISTEN

Si une exécution manuelle occupe le port, arrêtez-la (Ctrl+C) ou, en dernier recours, tuez le PID trouvé ci-dessus.

Pages connexes

Was this useful?
On this page

On this page