system.run.
Vous avez uniquement besoin de la CLI et du Gateway ? Commencez par Bien démarrer.
Téléchargement
Téléchargez les versions de l’app macOS depuis les versions GitHub d’OpenClaw. Lorsqu’une version contient des ressources pour l’app macOS, recherchez :OpenClaw-<version>.dmg(recommandé)OpenClaw-<version>.zip
Premier lancement
- Installez et lancez OpenClaw.app.
- Choisissez Ce Mac pour un Gateway local, ou connectez-vous à un Gateway distant.
- Patientez pendant que l’app installe l’environnement d’exécution CLI correspondant. En mode local, elle installe et démarre également le Gateway.
- Établissez l’inférence au moyen d’une vérification avec un modèle actif. Une fois celle-ci réussie, OpenClaw prend en charge le reste de la configuration.
- Suivez la liste de vérification des autorisations macOS et envoyez le message de test d’intégration.
Mises à jour
La carte de mise à jour du tableau de bord indique ce que l’app mettra à jour :- Mettre à jour l’app Mac et le Gateway signifie que l’app signée gère le Gateway launchd local. Sparkle met d’abord à jour l’app ; après son redémarrage, l’app met automatiquement à jour et redémarre son Gateway avec la version correspondante, puis vérifie la connexion.
- Mettre à jour le Gateway signifie que l’app est connectée à un Gateway distant, à un Gateway local géré manuellement ou à une autre installation qu’elle ne gère pas. Le bouton exécute le processus de mise à jour normal de ce Gateway au lieu de modifier l’app Mac.
extended-stable.
Après une mise à jour réussie, l’app recherche la session directe de premier niveau
utilisée le plus récemment par une personne et transmet à cet agent un événement de mise à jour ponctuel. Les activités Heartbeat
et Cron n’influent pas sur ce choix. L’agent peut alors vous souhaiter un bon retour
depuis la conversation que vous utilisiez probablement. En mode distant, l’app
met uniquement à jour l’environnement d’exécution du Node Mac local et omet la notification lorsque le
Gateway distant est plus ancien que l’app.
Sparkle suit le paramètre update.channel du Gateway. beta et dev activent
les versions bêta de l’app ; stable, extended-stable, ainsi que les valeurs absentes ou inconnues
restent sur les versions stables de l’app.
Ouvrir les liens du tableau de bord
Dans le tableau de bord intégré à l’app macOS, un clic sur un lien web externe l’ouvre dans une barre latérale de navigateur redimensionnable occupant la moitié de la largeur de la fenêtre, tout en laissant visible la navigation du tableau de bord. Faites glisser le séparateur pour choisir une autre largeur ; l’app la mémorise. Chaque lien s’ouvre dans son propre onglet, la barre d’onglets apparaît lorsque plusieurs pages sont ouvertes, et un nouveau clic sur le même lien réutilise son onglet existant. Faites glisser les onglets pour les réorganiser, fermez-les à l’aide du bouton de fermeture de l’onglet ou d’un clic avec le bouton du milieu, et faites un clic droit sur un onglet pour accéder à Open in Default Browser, Copy Link, Reload, Close Tab et Close Other Tabs. Les commandes précédent/suivant de la barre de titre de la fenêtre et les balayages sur le pavé tactile permettent de parcourir l’historique du tableau de bord ; les propres commandes précédent/suivant de la barre latérale permettent de parcourir l’historique de l’onglet actif. La barre latérale comporte également des commandes permettant de recharger la page, de l’ouvrir dans le navigateur par défaut et de la fermer. Les commandes de la barre de titre suivent la barre latérale de l’app : lorsqu’elle est déployée, les boutons précédent/suivant se trouvent sur son bord droit, à côté du bouton permettant de l’afficher ou de la masquer ; lorsqu’elle est réduite, ils laissent place à un bouton de recherche (qui ouvre la palette de commandes) et à un bouton de nouvelle session. Faites un clic droit sur un lien externe pour choisir Open in Sidebar, Open in Default Browser ou Copy Link. Les clics avec une touche de modification et les liens de nouvelle fenêtre activés par l’utilisateur depuis le tableau de bord continuent de s’ouvrir dans le navigateur par défaut ; les liens de nouvelle fenêtre dans la barre latérale s’ouvrent dans de nouveaux onglets de la barre latérale. Les pages de la Control UI hébergées dans un navigateur conservent le comportement normal du navigateur pour les liens et le menu contextuel.Importer les connexions du navigateur
À la première ouverture de la barre latérale du navigateur lorsque l’app utilise un Gateway local, le tableau de bord affiche une bannière pouvant être ignorée si un profil de la famille Chrome contenant des cookies existe sur le Mac. La bannière propose de copier ces cookies dans un profil géré isolé que les agents utilisent pour naviguer. Choisissez un profil à l’aide de sa commande Import (Touch ID peut être requis) ; la progression et le nombre de cookies importés s’affichent directement, et seuls les cookies sont copiés — les mots de passe ne quittent jamais le navigateur source. Ignorer la bannière enregistre ce choix ; Settings → General → Browser login → Import… permet de la proposer de nouveau à tout moment. Consultez Navigateur pour le processus d’importation sous-jacent et la conditionbrowser.allowSystemProfileImport.
Choisir un mode de Gateway
Les deux modes nécessitent l’installation de la CLI
openclaw, car l’app réutilise son environnement d’exécution
d’hôte Node. Sur un Mac neuf, l’app installe automatiquement la CLI correspondante ; le mode
local lance ensuite l’assistant du Gateway, tandis que le mode distant se connecte au
Gateway sélectionné sans démarrer un second Gateway local.
Consultez Gateway sur macOS pour une récupération manuelle.
Ce que l’app prend en charge
- État de la barre des menus, notifications, santé et WebChat.
- Invites d’autorisation macOS pour l’écran, le microphone, la parole, l’automatisation et l’accessibilité.
- Un Node Mac qui combine Canvas natif, la capture de la caméra et de l’écran, les notifications, la localisation et le contrôle de l’ordinateur avec les commandes système, de navigateur, de Plugin, de Skills et MCP de l’hôte Node de la CLI.
- Invites d’approbation d’exécution pour les commandes hébergées sur le Mac.
- Exécution dans le contexte de l’app pour les commandes shell approuvées, en préservant l’attribution des autorisations macOS de l’app tandis que l’environnement d’exécution de la CLI gère la politique partagée du Node.
- Tunnels SSH en mode distant ou connexions directes au Gateway.