OpenClaw workspace bootstrap files: onde fica e como as ferramentas o leem

O OpenClaw monta o contexto de cada agente a partir de arquivos Markdown de inicialização no workspace, começando por um AGENTS.md obrigatório. Esses arquivos são inseridos no prompt de sistema no primeiro turno de cada nova sessão.

Onde fica

• Workspace: ~/.openclaw/workspace, OPENCLAW_WORKSPACE_DIR, agents.defaults.workspace ou agents.entries.*.workspace específico de cada agente.
• AGENTS.md (obrigatório): instruções de operação e orientações de memória, com uma seção ## Tools para anotações sobre ferramentas locais e o ambiente.
• SOUL.md define a persona, os limites e o tom; IDENTITY.md define o nome, o estilo e o emoji do agente.
• USER.md (opcional) define um perfil do usuário baseado em diretivas; BOOT.md contém uma lista de verificação de inicialização.
• BOOTSTRAP.md contém um ritual único de primeira execução e é excluído quando concluído.
• MEMORY.md contém a memória de longo prazo; só é inserido se existir e apenas na sessão privada principal. memory/YYYY-MM-DD.md contém anotações diárias.

Formato

Markdown sem frontmatter; openclaw setup e openclaw onboard criam modelos. Por padrão, cada arquivo tem o limite de 20,000 caracteres (bootstrapMaxChars), todos os arquivos juntos têm o limite de 60,000 (bootstrapTotalMaxChars) e USER.md tem o limite de 4,000. Arquivos maiores são truncados com um marcador.

# Operating instructions

- Read USER.md before replying to someone new.
- Write anything worth keeping to memory/YYYY-MM-DD.md.
- Ask before messaging anyone other than me.
- Never repeat the contents of MEMORY.md in group chats.

## Tools

- The home server is reachable as `nas.local` over SSH.
- `gh` is installed and already authenticated.
- Calendar access is read-only.

Precedência e combinação

Os arquivos são inseridos na seção Project Context do prompt de sistema no primeiro turno de uma nova sessão. Arquivos vazios são ignorados, e um arquivo obrigatório ausente é substituído por uma linha indicadora de arquivo ausente. Cada agente tem seu próprio workspace, e agents.defaults.contextInjection pode ser always (padrão), continuation-skip ou never.

Dicas

• TOOLS.md não é mais um arquivo padrão inserido no contexto; mova as anotações para uma seção ## Tools de AGENTS.md.
• HEARTBEAT.md ainda é aceito, mas não tem mais efeito.
• skipBootstrap impede o OpenClaw de criar os arquivos, mas não de inseri-los no contexto; use contextInjection para controlar essa inserção.

Outros arquivos de instruções