Pular para o conteúdo principal

​
Contexto

“Contexto” é tudo o que o OpenClaw envia ao modelo em uma execução. Ele é limitado pela janela de contexto do modelo (limite de tokens). Modelo mental para iniciantes:
  • Prompt de sistema (construído pelo OpenClaw): regras, ferramentas, lista de Skills, tempo/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 comando, leituras de arquivo, 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 foi injetado + tamanhos aproximados (por arquivo + totais).
  • /context detail → detalhamento mais profundo: tamanhos por arquivo, por schema de ferramenta, por entrada de skill e tamanho do prompt de sistema.
  • /usage tokens → anexa 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, Compactação.

​
Exemplo de saída

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

​
/context list

🧠 Detalhamento de contexto
Workspace: <workspaceDir>
Máximo de bootstrap/arquivo: 20,000 chars
Sandbox: mode=non-main sandboxed=false
Prompt de sistema (execução): 38,412 chars (~9,603 tok) (Contexto do projeto 23,901 chars (~5,976 tok))

Arquivos do workspace injetados:
- AGENTS.md: OK | bruto 1,742 chars (~436 tok) | injetado 1,742 chars (~436 tok)
- SOUL.md: OK | bruto 912 chars (~228 tok) | injetado 912 chars (~228 tok)
- TOOLS.md: TRUNCADO | bruto 54,210 chars (~13,553 tok) | injetado 20,962 chars (~5,241 tok)
- IDENTITY.md: OK | bruto 211 chars (~53 tok) | injetado 211 chars (~53 tok)
- USER.md: OK | bruto 388 chars (~97 tok) | injetado 388 chars (~97 tok)
- HEARTBEAT.md: AUSENTE | bruto 0 | injetado 0
- BOOTSTRAP.md: OK | bruto 0 chars (~0 tok) | injetado 0 chars (~0 tok)

Lista de Skills (texto do prompt de sistema): 2,184 chars (~546 tok) (12 skills)
Ferramentas: read, edit, write, exec, process, browser, message, sessions_send, …
Lista de ferramentas (texto do prompt de sistema): 1,032 chars (~258 tok)
Schemas de ferramentas (JSON): 31,988 chars (~7,997 tok) (conta para o contexto; não exibido como texto)
Ferramentas: (o mesmo acima)

Tokens da sessão (em cache): 14,250 total / ctx=32,000

​
/context detail

🧠 Detalhamento de contexto (detalhado)
…
Principais skills (tamanho da entrada no prompt):
- frontend-design: 412 chars (~103 tok)
- oracle: 401 chars (~101 tok)
… (+10 mais skills)

Principais ferramentas (tamanho do schema):
- browser: 9,812 chars (~2,453 tok)
- exec: 6,240 chars (~1,560 tok)
… (+N mais ferramentas)

​
O que conta para a janela de contexto

Tudo o que o modelo recebe conta, incluindo:
  • Prompt de 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, mas ainda contam).

​
Como o OpenClaw constrói o prompt de sistema

O prompt de sistema é de propriedade do 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/OS/modelo/pensamento).
  • Arquivos bootstrap do workspace injetados em Contexto do projeto.
Detalhamento completo: Prompt de sistema.

​
Arquivos do workspace injetados (Contexto do projeto)

Por padrão, o OpenClaw injeta um conjunto fixo de arquivos do workspace (se presentes):
  • 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 20000 chars). O OpenClaw também aplica um limite total de injeção bootstrap entre arquivos com agents.defaults.bootstrapTotalMaxChars (padrão 150000 chars). /context mostra os tamanhos brutos vs injetados 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 once).

​
Skills: injetadas vs carregadas sob demanda

O prompt de sistema inclui uma lista de Skills compacta (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 modelo use read no 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 de sistema (o que você vê como “Tooling”).
  2. Schemas de ferramentas (JSON). Eles são enviados ao modelo para que ele possa chamar ferramentas. Contam para o contexto mesmo que você não os veja como texto simples.
/context detail detalha os maiores schemas de ferramentas para que você veja 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 /... é executada como comando.
  • Diretivas: /think, /verbose, /reasoning, /elevated, /model, /queue são removidos antes de o modelo ver a mensagem.
    • Mensagens somente 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 allowlist): certos tokens /... dentro de uma mensagem normal podem ser executados imediatamente (exemplo: “hey /status”) e são removidos antes de o modelo ver o texto restante.
Detalhes: Comandos de barra.

​
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 intactas as mensagens recentes.
  • Poda remove resultados antigos de ferramentas do prompt em memória de uma execução, mas não reescreve a transcrição.
Documentação: Sessão, Compactação, Poda de sessão. Por padrão, o OpenClaw usa o mecanismo de contexto legacy integrado para montagem e compactação. Se você instalar um plugin que forneça kind: "context-engine" e selecioná-lo com plugins.slots.contextEngine, o OpenClaw delega a montagem do 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 precisa implementar compact() corretamente. Veja Context Engine para a interface conectável completa, hooks de ciclo de vida e configuração.

​
O que /context realmente informa

/context prefere o relatório mais recente de prompt de sistema construído em execução quando disponível:
  • System prompt (run) = capturado da última execução embutida (capaz de usar 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 informa tamanhos e principais contribuintes; não despeja o prompt de sistema completo nem os schemas de ferramentas.

​
Relacionado