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.

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.

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

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. 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.