Inicialização do agente

O bootstrap é o ritual da primeira execução que prepara um novo espaço de trabalho do agente e orienta o agente na escolha de uma identidade. Ele é executado uma única vez, logo após a integração, no primeiro turno real do agente.

O que acontece

Na primeira execução em um espaço de trabalho totalmente novo (o padrão é ~/.openclaw/workspace), o OpenClaw:

• Cria inicialmente AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md e BOOTSTRAP.md.
• Faz o agente seguir BOOTSTRAP.md: uma conversa em formato livre (não um formulário fixo de perguntas e respostas) para definir um nome, uma personalidade e um estilo.
• Registra o que aprende em IDENTITY.md, USER.md e SOUL.md.
• Exclui BOOTSTRAP.md assim que o espaço de trabalho parece configurado, para que o ritual seja executado apenas uma vez.

Um espaço de trabalho é considerado configurado quando SOUL.md, IDENTITY.md ou USER.md difere de seu modelo inicial, ou quando existe uma pasta memory/.

Execuções com modelos integrados e locais

Para execuções com modelos integrados ou locais, o OpenClaw mantém BOOTSTRAP.md fora do contexto privilegiado do sistema. Na primeira execução interativa principal, ele ainda transmite o conteúdo do arquivo por meio do prompt do usuário, para que modelos que não chamam a ferramenta read de forma confiável ainda consigam concluir o ritual. Se a execução atual não puder acessar o espaço de trabalho com segurança, o agente receberá uma breve observação sobre bootstrap limitado em vez de uma saudação genérica.

Como ignorar o bootstrap

Para ignorar essa etapa em um espaço de trabalho previamente preparado, execute:

openclaw onboard --skip-bootstrap

Onde ele é executado

O bootstrap sempre é executado no host do Gateway. Se o aplicativo para macOS se conectar a um Gateway remoto, o espaço de trabalho e seus arquivos de bootstrap ficarão nessa máquina remota, não no Mac.

Documentação relacionada

• Integração do aplicativo para macOS: Integração
• Estrutura do espaço de trabalho: Espaço de trabalho do agente
• Conteúdo do modelo: Modelo de BOOTSTRAP.md