---
title: "OpenClaw workspace bootstrap files: caminhos e formato · DotsAgent"
description: "Onde ~/.openclaw/workspace/AGENTS.md fica, seu formato e frontmatter, como cópias globais e aninhadas são combinadas e quais ferramentas o leem. Verificado em 2026-10-01."
url: https://dotsagent.io/pt/instructions/files/openclaw-workspace
---

~/.openclaw/workspace/AGENTS.md

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

`~/.openclaw/workspace/AGENTS.md`

```
# 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.

Gere um AGENTS.md e arquivos de regras correspondentes para cinco ferramentas a partir de um único formulário. [Abrir o gerador de AGENTS.md →](https://dotsagent.io/pt/instructions)

## Outros arquivos de instruções

[AGENTS.md](https://dotsagent.io/pt/instructions/files/agents-md)

[CLAUDE.md](https://dotsagent.io/pt/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/pt/instructions/files/gemini-md)

[.cursor/rules/*.mdc](https://dotsagent.io/pt/instructions/files/cursor-rules)

[.github/copilot-instructions.md](https://dotsagent.io/pt/instructions/files/github-copilot-instructions)

[.devin/rules/*.md](https://dotsagent.io/pt/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/pt/instructions/files/cline-rules)

## Fontes

1. [docs.openclaw.ai](https://docs.openclaw.ai/concepts/agent)/concepts/agent
2. [docs.openclaw.ai](https://docs.openclaw.ai/concepts/agent-workspace)/concepts/agent-workspace
3. [docs.openclaw.ai](https://docs.openclaw.ai/start/bootstrapping)/start/bootstrapping
4. [docs.openclaw.ai](https://docs.openclaw.ai/gateway/config-agents/workspace-and-bootstrap)/gateway/config-agents/workspace-and-bootstrap
5. [docs.openclaw.ai](https://docs.openclaw.ai/reference/templates/AGENTS.md)/reference/templates/AGENTS.md

Referência independente para quem cria agentes de IA. Não temos vínculo com nenhum dos fornecedores mencionados aqui.

© 2026 DotsAgent · Fatos verificados em 1 de outubro de 2026