First steps
Integração (app para macOS)
Este documento descreve o fluxo de configuração de primeira execução atual. O objetivo é uma experiência fluida de "dia 0": escolher onde o Gateway é executado, conectar a autenticação, executar o assistente e permitir que o agente inicialize a si mesmo. Para uma visão geral dos caminhos de onboarding, consulte Visão geral do onboarding.
Aprovar aviso do macOS
Aprovar busca por redes locais
Boas-vindas e aviso de segurança
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 (separe os limites de confiança, mantenha o acesso a ferramentas mínimo e siga Segurança).
- O onboarding local agora define novas configurações como
tools.profile: "coding"por padrão, para que novas configurações locais mantenham ferramentas de sistema de arquivos/runtime sem forçar o perfilfullirrestrito. - Se hooks/webhooks ou outros feeds de conteúdo não confiável estiverem habilitados, use uma camada de modelo moderna e forte e mantenha uma política de ferramentas/sandboxing rigorosa.
Local vs Remoto
Onde o Gateway é executado?
- Este Mac (somente local): o onboarding pode configurar a autenticação e gravar credenciais localmente.
- Remoto (via SSH/Tailnet): o onboarding não configura autenticação local; as credenciais devem existir no host do gateway.
- Configurar depois: pule a configuração e deixe o app sem configuração.
Permissões
O onboarding 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
CLI
Chat de Onboarding (sessão dedicada)
Após a configuração, o app abre uma sessão de chat de onboarding 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 para saber o que acontece no host do gateway durante a primeira execução do agente.