Contexto
“Contexto” é tudo o 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 (construído pelo OpenClaw): regras, ferramentas, lista de Skills, tempo/tempo de execução e arquivos do workspace injetados.
- Histórico da conversa: suas mensagens + as mensagens do assistente desta sessão.
- Chamadas/resultados de ferramentas + anexos: saída de comandos, leituras de arquivos, imagens/áudio etc.
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 é injetado + tamanhos aproximados (por arquivo + totais)./context detail→ detalhamento mais profundo: por arquivo, tamanhos de esquemas por ferramenta, tamanhos de entradas por Skill e tamanho do prompt do sistema./usage tokens→ acrescenta um rodapé de uso por resposta às respostas normais./compact→ resume histórico mais antigo em uma entrada compacta para liberar espaço da janela.
Exemplo de saída
Os valores variam por modelo, provedor, política de ferramentas e pelo que está no seu workspace./context list
/context detail
O que conta para a janela de contexto
Tudo o que o modelo recebe conta, incluindo:- Prompt do sistema (todas as seções).
- Histórico da conversa.
- Chamadas de ferramentas + resultados de ferramentas.
- Anexos/transcrições (imagens/áudio/arquivos).
- Resumos de compactação e artefatos de poda.
- “Wrappers” do provedor ou cabeçalhos ocultos (não visíveis, ainda contam).
Como o OpenClaw constrói o prompt do sistema
O prompt do sistema é de propriedade do OpenClaw e é reconstruído a cada execução. Ele inclui:- Lista de ferramentas + descrições curtas.
- Lista de Skills (apenas metadados; veja abaixo).
- Localização do workspace.
- Hora (UTC + hora do usuário convertida, se configurado).
- Metadados de runtime (host/SO/modelo/raciocínio).
- Arquivos de bootstrap do workspace injetados em Project Context.
Arquivos do workspace injetados (Project Context)
Por padrão, o OpenClaw injeta um conjunto fixo de arquivos do workspace (se presentes):AGENTS.mdSOUL.mdTOOLS.mdIDENTITY.mdUSER.mdHEARTBEAT.mdBOOTSTRAP.md(apenas na primeira execução)
agents.defaults.bootstrapMaxChars (padrão 20000 caracteres). O OpenClaw também aplica um limite total de injeção de bootstrap entre arquivos com agents.defaults.bootstrapTotalMaxChars (padrão 24000 caracteres). /context mostra os tamanhos brutos vs injetados e se houve truncamento.
Skills: o que é injetado vs carregado sob demanda
O prompt do sistema inclui uma lista compacta de Skills (nome + descrição + localização). Essa lista tem sobrecarga real. As instruções das Skills não são incluídas por padrão. Espera-se que o modeloread o SKILL.md da Skill apenas quando necessário.
Ferramentas: existem dois custos
Ferramentas afetam o contexto de duas maneiras:- Texto da lista de ferramentas no prompt do sistema (o que você vê como “Tooling”).
- Esquemas 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 esquemas de ferramentas para que você veja o que domina.
Comandos, diretivas e “atalhos inline”
Slash commands são tratados pelo Gateway. Existem alguns comportamentos diferentes:- Comandos independentes: uma mensagem que é apenas
/...executa como um comando. - Diretivas:
/think,/verbose,/reasoning,/elevated,/model,/queuesão removidas antes de o modelo ver a mensagem.- Mensagens apenas com diretivas persistem as configurações da sessão.
- Diretivas inline em uma mensagem normal atuam como dicas por mensagem.
- Atalhos inline (apenas remetentes na lista de permissões): certos tokens
/...dentro de uma mensagem normal podem executar imediatamente (exemplo: “hey /status”) e são removidos antes de o modelo ver o texto restante.
Sessões, compactação e poda (o que persiste)
O que persiste entre mensagens depende do mecanismo:- Histórico normal persiste na transcrição da sessão até ser compactado/podado pela política.
- Compactação persiste um resumo na transcrição e mantém mensagens recentes intactas.
- Poda remove resultados antigos de ferramentas do prompt em memória para uma execução, mas não reescreve a transcrição.
O que /context realmente reporta
/context prefere o relatório mais recente do prompt do sistema construído na execução, quando disponível:
System prompt (run)= capturado da última execução incorporada (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 via um backend de CLI que não gera o relatório).