Aller au contenu principal

Application compagnon macOS

Configuration de développement macOS

Ce guide couvre les étapes nécessaires pour construire et exécuter l'application macOS OpenClaw à partir des sources.

Prérequis​

Avant de construire l'application, assurez-vous d'avoir installé les éléments suivants :

  1. Xcode 26.2+ : Requis pour le développement Swift.
  2. Node.js 22+ & pnpm : Requis pour la passerelle, la CLI et les scripts d'empaquetage.

1. Installer les dépendances​

Installez les dépendances globales du projet :

pnpm install

2. Construire et empaqueter l'application​

Pour construire l'application macOS et l'empaqueter dans dist/OpenClaw.app, exécutez :

./scripts/package-mac-app.sh

Si vous ne possédez pas de certificat Apple Developer ID, le script utilisera automatiquement la signature ad-hoc (-). Pour les modes d'exécution de développement, les drapeaux de signature et le dépannage de l'ID d'équipe, consultez le README de l'application macOS : https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md

Note : Les applications signées ad-hoc peuvent déclencher des alertes 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 s'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. Allez dans l'onglet des paramètres Général.
  3. Cliquez sur "Installer la CLI".

Alternativement, installez-la manuellement :

npm install -g openclaw@<version>

Dépannage​

La construction échoue : Incompatibilité de chaîne d'outils ou SDK​

La construction de l'application macOS nécessite le dernier SDK macOS et la chaîne d'outils Swift 6.2. Dépendances système (requises) :

  • Dernière version de macOS disponible dans Mise à jour logicielle (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 construction.

L'application plante lors de l'octroi 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. Solution :

  1. Réinitialisez les permissions TCC :

    Copier

    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 "état vierge" de la part de macOS.

La passerelle reste sur "Démarrage…" indéfiniment​

Si le statut de la passerelle reste sur "Démarrage…", vérifiez si un processus zombie occupe le port :

openclaw gateway status
openclaw gateway stop

# Si vous n'utilisez pas de LaunchAgent (mode dev / exécutions manuelles), trouvez l'écouteur :
lsof -nP -iTCP:18789 -sTCP:LISTEN

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

Raspberry PiBarre de menu