Skip to main content
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/.
BOOTSTRAP.md abrange toda a conversa sobre identidade. Consulte seu conteúdo no modelo de BOOTSTRAP.md.

​
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:

​
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.
Quando o Gateway for executado em outra máquina, edite os arquivos do espaço de trabalho no host do Gateway (por exemplo, user@gateway-host:~/.openclaw/workspace).

​
Documentação relacionada