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 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 et pnpm pour le Gateway, la CLI et les scripts de création de paquets. Node 22.19+ fonctionne également.

1. Installer les dépendances

bash
pnpm install

2. Compiler et empaqueter l’application

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

Génère dist/OpenClaw.app. Sans certificat Apple Developer ID, le script utilise par 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 au Team ID, 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 une signature ad hoc ; les autorisations TCC ne sont pas conservées avec --no-sign).

3. Installer la CLI et le Gateway

L’application empaquetée 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 correspondante dans l’espace utilisateur ainsi que l’environnement d’exécution avant de lancer 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 le dernier 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 bundle 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 d’un état vierge dans macOS.

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, interrompez le PID trouvé ci-dessus.

Ressources connexes

Was this useful?
On this page

On this page