Saltar para o conteúdo principal

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

Approve macOS warning

2

Approve find local networks

3

Welcome and security notice

4

Local vs Remote

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

Permissions

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
6

CLI

Esta etapa é opcional
O app pode instalar a CLI global openclaw via npm/pnpm para que fluxos de trabalho no terminal e tarefas do launchd funcionem imediatamente.
7

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 para entender o que acontece no host do gateway durante a primeira execução do agente.