Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Aprovar aviso do macOS

2

Aprovar busca por redes locais

3

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 perfil full irrestrito.
  • 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.
4

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.
Dica de autenticação do Gateway:
  • O assistente agora gera um token mesmo para loopback, portanto clientes WS locais precisam se autenticar.
  • Se você desabilitar 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.
5

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
6

CLI

Esta etapa é opcional
O app pode instalar a CLI global openclaw via npm, pnpm ou bun. Ele prefere npm primeiro, depois pnpm e, em seguida, bun se esse for o único gerenciador de pacotes detectado. Para o runtime do Gateway, Node continua sendo o caminho recomendado.
7

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.

​
Relacionados