# Configuration de développement macOS

Créez et exécutez l’application macOS OpenClaw à partir des sources.

# Prérequis

Avant de créer l’application, assurez-vous d’avoir installé les éléments suivants :

1. Xcode 26.2+ : requis pour le développement Swift.
2. Node.js 24 et pnpm : recommandé pour le Gateway, la CLI et les scripts de packaging. Node 22 LTS, actuellement 22.16+, reste pris en charge pour la compatibilité.

# 1. Installer les dépendances

Installez les dépendances de l’ensemble du projet :

pnpm install

# 2. Créer et packager l’application

Pour créer l’application macOS et la packager dans dist/OpenClaw.app, exécutez :

./scripts/package-mac-app.sh

Si vous ne disposez pas d’un certificat Apple Developer ID, le script utilisera automatiquement la signature ad hoc (-).

Pour les modes d’exécution de développement, les indicateurs de signature et le dépannage du Team ID, consultez le README de l’application macOS : https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md

Remarque : 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 Dépannage.

# 3. Installer la CLI

L’application macOS attend une installation globale de la CLI openclaw pour gérer les tâches en arrière-plan.

Pour l’installer (recommandé) :

1. Ouvrez l’application OpenClaw.
2. Accédez à l’onglet des paramètres Général.
3. Cliquez sur « Installer la CLI ».

Vous pouvez aussi l’installer manuellement :

npm install -g openclaw@<version>

pnpm add -g openclaw@<version> et bun add -g openclaw@<version> fonctionnent également. Pour l’environnement d’exécution du Gateway, Node reste la méthode recommandée.

# Dépannage

# Échec de création : incompatibilité de chaîne d’outils ou de SDK

La création de l’application macOS attend le SDK macOS le plus récent et la chaîne d’outils Swift 6.2.

Dépendances système (requises) :

• Dernière version de macOS disponible dans Mise à jour de logiciels (requise par les SDK Xcode 26.2)
• Xcode 26.2 (chaîne d’outils Swift 6.2)

Vérifications :

xcodebuild -version
xcrun swift --version

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

# L’application plante lors de l’accord d’une autorisation

Si l’application plante lorsque vous essayez d’autoriser l’accès à la Reconnaissance vocale ou au Microphone, cela peut être dû à un cache TCC corrompu ou à une incompatibilité de signature.

Correctif :

1. Réinitialisez les autorisations TCC :

   tccutil reset All ai.openclaw.mac.debug
   

2. Si cela échoue, modifiez temporairement le BUNDLE_ID dans scripts/package-mac-app.sh pour forcer un « nouveau départ » depuis macOS.

# Gateway bloqué indéfiniment sur « Starting... »

Si le statut du gateway reste sur « Starting... », vérifiez si un processus zombie occupe le port :

openclaw gateway status
openclaw gateway stop

# If you're not using a LaunchAgent (dev mode / manual runs), find the listener:
lsof -nP -iTCP:18789 -sTCP:LISTEN

Si une exécution manuelle occupe le port, arrêtez ce processus (Ctrl+C). En dernier recours, terminez le PID trouvé ci-dessus.

# Articles associés

• Application macOS
• Vue d’ensemble de l’installation