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

# Integração inicial (aplicativo macOS)

Este documento descreve o fluxo de configuração de primeira execução **atual**. O objetivo é uma experiência
suave no "dia 0": escolher onde o Gateway é executado, conectar a autenticação, executar o
assistente e deixar o agente inicializar a si mesmo.
Para uma visão geral dos caminhos de integração, consulte [Visão geral da integração](/pt-BR/start/onboarding-overview).

<Steps>
  <Step title="Aprovar aviso do macOS">
    <Frame>
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/01-macos-warning.jpeg?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=7ade99ff85eba6a2fe743ff1f7799087" alt="" width="1132" height="818" data-path="assets/macos-onboarding/01-macos-warning.jpeg" />
    </Frame>
  </Step>

  <Step title="Aprovar busca por redes locais">
    <Frame>
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/02-local-networks.jpeg?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=e9fcec535d0cdca207cff0cf2379e951" alt="" width="1132" height="818" data-path="assets/macos-onboarding/02-local-networks.jpeg" />
    </Frame>
  </Step>

  <Step title="Boas-vindas e aviso de segurança">
    <Frame caption="Leia o aviso de segurança exibido e decida de acordo">
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/03-security-notice.png?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=8866e4aaac170614a163d990091addac" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/03-security-notice.png" />
    </Frame>

    Modelo de confiança de segurança:

    * Por padrão, o OpenClaw é um agente pessoal: um limite de operador confiável.
    * Configurações compartilhadas/multiusuário exigem bloqueio rigoroso (separe os limites de confiança, mantenha o acesso a ferramentas no mínimo e siga [Segurança](/pt-BR/gateway/security)).
    * A integração local agora define novas configurações como `tools.profile: "coding"` por padrão, para que configurações locais novas mantenham ferramentas de sistema de arquivos/runtime sem forçar o perfil irrestrito `full`.
    * Se hooks/Webhooks ou outros feeds de conteúdo não confiáveis estiverem ativados, use uma camada de modelo moderna e forte e mantenha uma política de ferramentas/sandboxing rigorosa.
  </Step>

  <Step title="Local vs remoto">
    <Frame>
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/04-choose-gateway.png?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=7e923f389e6d774363064140691b4fbe" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/04-choose-gateway.png" />
    </Frame>

    Onde o **Gateway** é executado?

    * **Este Mac (somente local):** a integração pode configurar a autenticação e gravar credenciais
      localmente.
    * **Remoto (via SSH/Tailnet):** a integração **não** configura autenticação local;
      as credenciais devem existir no host do gateway. O campo de token do gateway remoto
      armazena o token usado pelo app macOS para se conectar a esse Gateway; valores
      `gateway.remote.token` não existentes em texto puro são preservados até você substituí-los.
    * **Configurar depois:** pule a configuração e deixe o app não configurado.

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

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

  <Step title="Permissões">
    <Frame caption="Escolha quais permissões você deseja conceder ao OpenClaw">
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/05-permissions.png?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=6c45fa49282cf491a1425a714ec68f18" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/05-permissions.png" />
    </Frame>

    A integração solicita as 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 ou bun.
    Ele prefere npm primeiro, depois pnpm, depois bun se esse for o único
    gerenciador de pacotes detectado. Para o runtime do Gateway, Node continua sendo o caminho recomendado.
  </Step>

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

## Relacionados

* [Visão geral da integração](/pt-BR/start/onboarding-overview)
* [Primeiros passos](/pt-BR/start/getting-started)