> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Prise en main (application macOS)

# 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](/start/onboarding-overview).

<Steps>
  <Step title="Approve macOS warning">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/01-macos-warning.jpeg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=52ce8b835daf7a29b63c3ee7f4a0308a" alt="" width="1132" height="818" data-path="assets/macos-onboarding/01-macos-warning.jpeg" />
    </Frame>
  </Step>

  <Step title="Approve find local networks">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/02-local-networks.jpeg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=898d91d6350aef17eb26d54f2aae7398" alt="" width="1132" height="818" data-path="assets/macos-onboarding/02-local-networks.jpeg" />
    </Frame>
  </Step>

  <Step title="Welcome and security notice">
    <Frame caption="Lisez l’avis de sécurité affiché et décidez en conséquence">
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/03-security-notice.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=f5c2f45dfb79fb3102f3b00349685c5e" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/03-security-notice.png" />
    </Frame>
  </Step>

  <Step title="Local vs Remote">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/04-choose-gateway.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=280e34bced7bf879d9b6f74a77abcda0" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/04-choose-gateway.png" />
    </Frame>

    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.

    <Tip>
      **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.
    </Tip>
  </Step>

  <Step title="Permissions">
    <Frame caption="Choisissez les autorisations que vous souhaitez accorder à OpenClaw">
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/05-permissions.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=fe49a0e85fad11452f3ee292d78e2415" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/05-permissions.png" />
    </Frame>

    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
  </Step>

  <Step title="CLI">
    <Info>
      Cette étape est facultative
    </Info>

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

  <Step title="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](/start/bootstrapping) pour
    ce qui se passe sur l’hôte de la passerelle lors de la première exécution de l’agent.
  </Step>
</Steps>