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.

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.

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

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