Pular para o conteúdo principal
“Contexto” é tudo que o OpenClaw envia ao modelo para uma execução. Ele é limitado pela janela de contexto do modelo (limite de tokens). Modelo mental para iniciantes:
  • Prompt do sistema (criado pelo OpenClaw): regras, ferramentas, lista de Skills, horário/runtime e arquivos do workspace injetados.
  • Histórico da conversa: suas mensagens + as mensagens do assistente nesta sessão.
  • Chamadas/resultados de ferramentas + anexos: saída de comandos, leituras de arquivos, imagens/áudio etc.
Contexto não é a mesma coisa que “memória”: a memória pode ser armazenada em disco e recarregada depois; contexto é o que está dentro da janela atual do modelo.

​
Início rápido (inspecionar contexto)

  • /status → visão rápida de “quão cheia está minha janela?” + configurações da sessão.
  • /context list → o que está injetado + tamanhos aproximados (por arquivo + totais).
  • /context detail → detalhamento mais profundo: tamanhos por arquivo, por schema de ferramenta, por entrada de Skill, tamanho do prompt do sistema e contagens de mensagens do transcript que podem ser compactadas.
  • /context map → imagem em treemap no estilo WinDirStat dos contribuidores de contexto rastreados da sessão atual.
  • /usage tokens → adiciona um rodapé de uso por resposta às respostas normais.
  • /compact → resume o histórico mais antigo em uma entrada compacta para liberar espaço na janela.
Veja também: Comandos de barra, Uso de tokens e custos, Compaction.

​
Exemplo de saída

Os valores variam conforme modelo, provedor, política de ferramentas e o que há no seu workspace.

​
/context list

🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 12,000 chars
Sandbox: mode=non-main sandboxed=false
System prompt (run): 38,412 chars (~9,603 tok) (Project Context 23,901 chars (~5,976 tok))

Injected workspace files:
- AGENTS.md: OK | raw 1,742 chars (~436 tok) | injected 1,742 chars (~436 tok)
- SOUL.md: OK | raw 912 chars (~228 tok) | injected 912 chars (~228 tok)
- TOOLS.md: TRUNCATED | raw 54,210 chars (~13,553 tok) | injected 20,962 chars (~5,241 tok)
- IDENTITY.md: OK | raw 211 chars (~53 tok) | injected 211 chars (~53 tok)
- USER.md: OK | raw 388 chars (~97 tok) | injected 388 chars (~97 tok)
- HEARTBEAT.md: MISSING | raw 0 | injected 0
- BOOTSTRAP.md: OK | raw 0 chars (~0 tok) | injected 0 chars (~0 tok)

Skills list (system prompt text): 2,184 chars (~546 tok) (12 skills)
Tools: read, edit, write, exec, process, browser, message, sessions_send, …
Tool list (system prompt text): 1,032 chars (~258 tok)
Tool schemas (JSON): 31,988 chars (~7,997 tok) (counts toward context; not shown as text)
Tools: (same as above)

Session tokens (cached): 14,250 total / ctx=32,000

​
/context detail

🧠 Context breakdown (detailed)
…
Top skills (prompt entry size):
- frontend-design: 412 chars (~103 tok)
- oracle: 401 chars (~101 tok)
… (+10 more skills)

Top tools (schema size):
- browser: 9,812 chars (~2,453 tok)
- exec: 6,240 chars (~1,560 tok)
… (+N more tools)

​
/context map

Envia uma imagem gerada a partir do relatório de execução em cache mais recente. Antes de uma mensagem normal produzir um relatório de execução na sessão, /context map retorna uma mensagem de indisponibilidade em vez de renderizar uma estimativa. A área do retângulo é proporcional aos caracteres rastreados do prompt:
  • arquivos do workspace injetados
  • texto base do prompt do sistema
  • entradas de prompt de Skills
  • schemas JSON de ferramentas
/context list, /context detail e /context json ainda podem inspecionar uma estimativa sob demanda quando nenhum relatório de execução está em cache.

​
O que conta para a janela de contexto

Tudo que o modelo recebe conta, incluindo:
  • Prompt do sistema (todas as seções).
  • Histórico da conversa.
  • Chamadas de ferramentas + resultados de ferramentas.
  • Anexos/transcripts (imagens/áudio/arquivos).
  • Resumos de Compaction e artefatos de poda.
  • “Wrappers” do provedor ou cabeçalhos ocultos (não visíveis, mas ainda contabilizados).

​
Como o OpenClaw cria o prompt do sistema

O prompt do sistema é controlado pelo OpenClaw e reconstruído a cada execução. Ele inclui:
  • Lista de ferramentas + descrições curtas.
  • Lista de Skills (somente metadados; veja abaixo).
  • Localização do workspace.
  • Horário (UTC + horário do usuário convertido, se configurado).
  • Metadados de runtime (host/SO/modelo/thinking).
  • Arquivos de bootstrap do workspace injetados em Contexto do projeto.
Detalhamento completo: Prompt do sistema.

​
Arquivos do workspace injetados (Contexto do projeto)

Por padrão, o OpenClaw injeta um conjunto fixo de arquivos do workspace (se existirem):
  • AGENTS.md
  • SOUL.md
  • TOOLS.md
  • IDENTITY.md
  • USER.md
  • HEARTBEAT.md
  • BOOTSTRAP.md (somente na primeira execução)
Arquivos grandes são truncados por arquivo usando agents.defaults.bootstrapMaxChars (padrão de 20000 caracteres). O OpenClaw também impõe um limite total de injeção de bootstrap entre arquivos com agents.defaults.bootstrapTotalMaxChars (padrão de 60000 caracteres). /context mostra os tamanhos bruto vs injetado e se houve truncamento. Quando ocorre truncamento, o runtime pode injetar um bloco de aviso no prompt em Contexto do projeto. Configure isso com agents.defaults.bootstrapPromptTruncationWarning (off, once, always; padrão always).

​
Skills: injetadas vs carregadas sob demanda

O prompt do sistema inclui uma lista de Skills compacta (nome + descrição + localização). Essa lista tem overhead real. As instruções de Skill não são incluídas por padrão. Espera-se que o modelo faça read do SKILL.md da Skill somente quando necessário.

​
Ferramentas: há dois custos

Ferramentas afetam o contexto de duas formas:
  1. Texto da lista de ferramentas no prompt do sistema (o que você vê como “Tooling”).
  2. Schemas de ferramentas (JSON). Eles são enviados ao modelo para que ele possa chamar ferramentas. Eles contam para o contexto mesmo que você não os veja como texto simples.
/context detail detalha os maiores schemas de ferramentas para você ver o que domina.

​
Comandos, diretivas e “atalhos inline”

Comandos de barra são tratados pelo Gateway. Há alguns comportamentos diferentes:
  • Comandos autônomos: uma mensagem que é apenas /... executa como comando.
  • Diretivas: /think, /verbose, /trace, /reasoning, /elevated, /model, /queue são removidas antes de o modelo ver a mensagem.
    • Mensagens apenas com diretiva persistem configurações da sessão.
    • Diretivas inline em uma mensagem normal atuam como dicas por mensagem.
  • Atalhos inline (somente remetentes permitidos): certos tokens /... dentro de uma mensagem normal podem ser executados imediatamente (exemplo: “ei /status”) e são removidos antes de o modelo ver o texto restante.
Detalhes: Comandos de barra.

​
Sessões, Compaction e poda (o que persiste)

O que persiste entre mensagens depende do mecanismo:
  • Histórico normal persiste no transcript da sessão até ser compactado/podado pela política.
  • Compaction persiste um resumo no transcript e mantém as mensagens recentes intactas.
  • Poda remove resultados antigos de ferramentas do prompt em memória para liberar espaço na janela de contexto, mas não reescreve o transcript da sessão - o histórico completo ainda pode ser inspecionado em disco.
Docs: Sessão, Compaction, Poda de sessão. Por padrão, o OpenClaw usa o mecanismo de contexto integrado legacy para montagem e Compaction. Se você instalar um Plugin que fornece kind: "context-engine" e selecioná-lo com plugins.slots.contextEngine, o OpenClaw delega a montagem de contexto, /compact e hooks relacionados do ciclo de vida de contexto de subagentes a esse mecanismo. ownsCompaction: false não faz fallback automático para o mecanismo legacy; o mecanismo ativo ainda deve implementar compact() corretamente. Veja Mecanismo de contexto para a interface plugável completa, hooks de ciclo de vida e configuração.

​
O que /context realmente relata

/context prefere o relatório do prompt do sistema criado pela execução mais recente quando disponível:
  • System prompt (run) = capturado da última execução embutida (com capacidade de ferramentas) e persistido no armazenamento da sessão.
  • System prompt (estimate) = calculado dinamicamente quando não existe relatório de execução (ou ao executar por um backend de CLI que não gera o relatório).
De qualquer forma, ele relata tamanhos e principais contribuidores; ele não despeja o prompt do sistema completo nem os schemas de ferramentas. No modo detalhado, ele também compara o transcript da sessão com o mesmo predicado de mensagens de conversa real usado pela Compaction, então fica mais fácil distinguir uso alto de prompt/cache de histórico de conversa compactável.

​
Relacionado

Context engine

Injeção de contexto personalizada via plugins.

Compaction

Resumir conversas longas para mantê-las dentro da janela do modelo.

System prompt

Como o prompt do sistema é criado e o que ele injeta a cada turno.

Agent loop

O ciclo completo de execução do agente, da mensagem recebida à resposta final.