English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

macOS companion app

Configuration de développement macOS

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 :

bash
pnpm install

2. Créer et packager l’application

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

bash
./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 :

bash
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 :

bash
xcodebuild -versionxcrun 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 :

    bash
    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 :

bash
openclaw gateway statusopenclaw 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

Was this useful?