Skip to main content

​
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

​
2. Compiler et mettre en paquet l’application

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).
Les applications signées ad hoc peuvent déclencher des invites de sécurité. Si l’application plante immédiatement avec « Abort trap 6 », consultez la section Résolution des problèmes.

​
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 :
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+).
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 :
  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 :
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