Passer au contenu principal

​
Prise en main (application macOS)

Ce document décrit le flux de prise en main actuel au premier lancement. L’objectif est une expérience fluide dès le « jour 0 » : choisir où s’exécute le Gateway (passerelle), connecter l’authentification, lancer l’assistant et laisser l’agent s’amorcer automatiquement. Pour un aperçu général des parcours de configuration, consultez Onboarding Overview.
1

Approve macOS warning

2

Approve find local networks

3

Welcome and security notice

4

Local vs Remote

Où s’exécute le Gateway (passerelle) ?
  • Ce Mac (local uniquement) : la prise en main peut exécuter des flux OAuth et écrire les identifiants localement.
  • Distant (via SSH/Tailnet) : la prise en main n’exécute pas OAuth en local ; les identifiants doivent exister sur l’hôte de la passerelle.
  • Configurer plus tard : ignorer la configuration et laisser l’application non configurée.
Astuce d’authentification du Gateway (passerelle) :
  • L’assistant génère désormais un jeton même pour le loopback, afin que les clients WS locaux doivent s’authentifier.
  • Si vous désactivez l’authentification, tout processus local peut se connecter ; utilisez cette option uniquement sur des machines entièrement fiables.
  • Utilisez un jeton pour l’accès multi‑machines ou les liaisons non‑loopback.
5

Permissions

La prise en main demande les autorisations TCC nécessaires pour :
  • Automatisation (AppleScript)
  • Notifications
  • Accessibilité
  • Enregistrement de l’écran
  • Microphone
  • Reconnaissance vocale
  • Caméra
  • Localisation
6

CLI

Cette étape est facultative
L’application peut installer la CLI globale openclaw via npm/pnpm afin que les flux de travail du terminal et les tâches launchd fonctionnent immédiatement.
7

Onboarding Chat (dedicated session)

Après la configuration, l’application ouvre une session de chat de prise en main dédiée afin que l’agent puisse se présenter et guider les prochaines étapes. Cela permet de conserver l’accompagnement du premier lancement séparé de votre conversation habituelle. Voir Bootstrapping pour ce qui se passe sur l’hôte de la passerelle lors de la première exécution de l’agent.