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

# Integração inicial (App macOS)

# Integração inicial (App macOS)

Este documento descreve o fluxo **atual** de integração inicial na primeira execução. O objetivo é uma experiência suave no “dia 0”: escolher onde o Gateway roda, conectar a autenticação, executar o assistente e deixar o agente se inicializar sozinho.
Para uma visão geral dos caminhos de onboarding, consulte [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="Leia o aviso de segurança exibido e decida conforme apropriado">
      <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>

    Onde o **Gateway** roda?

    * **Este Mac (somente local):** a integração inicial pode executar fluxos OAuth e gravar credenciais localmente.
    * **Remoto (via SSH/Tailnet):** a integração inicial **não** executa OAuth localmente; as credenciais devem existir no host do gateway.
    * **Configurar depois:** pula a configuração e deixa o app não configurado.

    <Tip>
      **Dica de autenticação do Gateway:**

      * O assistente agora gera um **token** mesmo para loopback, então clientes WS locais devem se autenticar.
      * Se você desativar a autenticação, qualquer processo local pode se conectar; use isso apenas em máquinas totalmente confiáveis.
      * Use um **token** para acesso em várias máquinas ou para binds non-loopback.
    </Tip>
  </Step>

  <Step title="Permissions">
    <Frame caption="Escolha quais permissões você deseja conceder ao 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>

    A integração inicial solicita permissões TCC necessárias para:

    * Automação (AppleScript)
    * Notificações
    * Acessibilidade
    * Gravação de Tela
    * Microfone
    * Reconhecimento de Fala
    * Câmera
    * Localização
  </Step>

  <Step title="CLI">
    <Info>
      Esta etapa é opcional
    </Info>

    O app pode instalar a CLI global `openclaw` via npm/pnpm para que fluxos de trabalho no terminal e tarefas do launchd funcionem imediatamente.
  </Step>

  <Step title="Onboarding Chat (dedicated session)">
    Após a configuração, o app abre uma sessão de chat dedicada à integração inicial para que o agente possa se apresentar e orientar os próximos passos. Isso mantém a orientação da primeira execução separada da sua conversa normal. Veja [Bootstrapping](/start/bootstrapping) para entender o que acontece no host do gateway durante a primeira execução do agente.
  </Step>
</Steps>