Solução para a janela de contexto de 16k do OpenClaw

Solução para a janela de contexto de 16k do OpenClaw

O tamanho do contexto dos modelos no OpenClaw não é fixo em 16k; ele depende principalmente da configuração local. Verifique ~/.openclaw/openclaw.json ou ~/.openclaw/agents/<agentId>/agent/models.json e altere contextWindow e maxTokens do modelo correspondente para os valores realmente suportados. Para o MiniMax-M2.5, por exemplo, você pode usar contextWindow: 196608 e maxTokens: 8192. Depois da alteração, reinicie o OpenClaw. Tanto a referência oficial de configuração quanto o exemplo do MiniMax permitem esse formato.

Em essência, o problema é este: contextWindow foi definido como 16000 (ou até menos) em um provider personalizado ou modelo personalizado. O contexto real do OpenClaw depende bastante da configuração; se o modelo realmente aceitar um contexto maior, você deve aumentar esse valor. Caso contrário, podem ocorrer problemas como API rate limit reached, contexto insuficiente ou comportamento inesperado em conversas longas. A referência oficial de configuração informa claramente que o arquivo principal do OpenClaw é ~/.openclaw/openclaw.json e que também é possível manter um models.json separado no diretório do agent. Ao identificar um modelo, contextWindow / maxTokens assumem o maior valor entre a configuração e o catalog implícito.

A imagem mostra a aba “Settings” da página de configuração do OpenClaw.…

Como alterar a configuração de contexto do OpenClaw

Um. Sintomas do problema

Ao integrar um modelo personalizado ou um modelo de um serviço intermediário de terceiros ao OpenClaw, se a janela de contexto estiver configurada com um valor muito baixo, por exemplo:

"contextWindow": 16000,
"maxTokens": 4096

podem ocorrer os seguintes problemas:

• Conversas longas falham com facilidade
• Chamadas de ferramentas apresentam erros com mais frequência
• A página exibe API rate limit reached
• Mesmo que o modelo aceite um contexto maior, o OpenClaw continua usando o valor menor

A documentação oficial do OpenClaw informa que contextWindow e maxTokens podem ser definidos explicitamente na configuração. O arquivo principal fica em ~/.openclaw/openclaw.json, mas você também pode usar um models.json no diretório do agent para sobrescrever esses valores separadamente.

Dois. Localização dos arquivos de configuração

1) Caminho do arquivo principal

O arquivo principal padrão do OpenClaw é:

~/.openclaw/openclaw.json

Isso está explicitamente indicado na documentação oficial.

2) Caminho da configuração de modelos do Agent

Se você configurar os modelos separadamente por agent, o caminho normalmente será:

~/.openclaw/agents/<agentId>/agent/models.json

A documentação oficial informa que providers personalizados podem ser adicionados em models.providers ou definidos em ~/.openclaw/agents/<agentId>/agent/models.json.

3) Caso você tenha alterado o diretório raiz personalizado do Agent

Se você definiu a variável de ambiente:

OPENCLAW_AGENT_DIR

o diretório de configuração do agent será substituído pelo valor dessa variável. A documentação oficial também informa que o diretório raiz da configuração do agent pode ser alterado por OPENCLAW_AGENT_DIR (ou PI_CODING_AGENT_DIR).

Três. Como alterar

Opção A: alterar a configuração principal

openclaw.json

Abra:

~/.openclaw/openclaw.json

Encontre a configuração correspondente ao provider do modelo que você está usando, por exemplo:

{
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        api: "anthropic-messages",
        apiKey: "你的 API Key",
        models: [
          {
            id: "MiniMax-M2.5",
            name: "MiniMax-M2.5",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 196608,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}

No exemplo oficial do MiniMax, o MiniMax-M2.5 é configurado exatamente com contextWindow: 196608 e maxTokens: 8192.

Opção B: alterar o arquivo do agent

models.json

Abra:

~/.openclaw/agents/<agentId>/agent/models.json

Altere, no modelo correspondente:

"contextWindow": 16000,
"maxTokens": 4096

para valores mais adequados, por exemplo:

"contextWindow": 196608,
"maxTokens": 8192

Quatro. Valores recomendados

Não invente valores, como “quero um contexto de 1M, então vou definir 1000000”. O universo não funciona assim.

Princípios recomendados

• contextWindow: preencha com o valor realmente aceito pelo modelo
• maxTokens: preencha com o limite real de saída do modelo
• Se você usa uma plataforma intermediária, consulte o limite realmente liberado por ela, não apenas o valor divulgado pelo fabricante original

Exemplo com o MiniMax-M2.5

O exemplo oficial do OpenClaw recomenda:

"contextWindow": 196608,
"maxTokens": 8192

Cinco. O que fazer depois da alteração

Depois de salvar a configuração, reinicie o OpenClaw ou o processo gateway correspondente.

Comandos comuns:

openclaw models list
openclaw models set minimax/MiniMax-M2.5

A documentação oficial também apresenta esses dois comandos para verificar e trocar o modelo.

Se você executa o sistema como serviço, também precisa reiniciar o serviço correspondente, por exemplo:

openclaw gateway restart

ou reinicie seu próprio contêiner systemd / pm2 / docker.

Seis. Observações adicionais

A referência oficial de configuração do OpenClaw também informa que:

• Providers personalizados podem ser definidos diretamente em models.providers
• contextWindow / maxTokens aceitam definição explícita
• Ao identificar um modelo, o maior valor entre a configuração explícita e o catalog implícito é usado
• Para substituir completamente models.json pela sua própria configuração, use models.mode: "replace".

Além disso, a documentação oficial agora informa que para custom providers, quando esses campos são omitidos, os valores padrão são contextWindow: 200000 e maxTokens: 8192. Portanto, se o ambiente do seu cliente ainda estiver em 16k ou 4k, provavelmente não é porque “o padrão atual do OpenClaw só aceita 16k”, mas porque a configuração local do modelo foi reduzida manualmente ou ainda há uma configuração antiga residual.