Explication centralisée de l’erreur de contexte 16k d’OpenClaw et de sa correction dans la configuration locale.

Solution au contexte 16k d’OpenClaw

Si OpenClaw affiche une erreur API rate limit, c’est que le contexte local est configuré sur 16 k. Vous devez modifier ce réglage vous-même.

Capture de l’erreur OpenClaw « API rate limit reached. Please try again…

Capture de la configuration OpenClaw du modèle MiniMax-M2.5. Les valeurs…

La fenêtre de contexte d’un modèle dans OpenClaw n’est pas limitée à 16k : elle dépend principalement de votre configuration locale. Vérifiez ~/.openclaw/openclaw.json ou ~/.openclaw/agents/<agentId>/agent/models.json, puis remplacez les valeurs contextWindow et maxTokens du modèle par celles qu’il prend réellement en charge. Pour MiniMax-M2.5, vous pouvez par exemple utiliser contextWindow: 196608 et maxTokens: 8192. Redémarrez ensuite OpenClaw. La documentation de configuration officielle et l’exemple MiniMax acceptent tous deux cette syntaxe.

En substance, le problème vient de ceci : contextWindow a été défini sur 16000, voire moins, pour un provider ou un modèle personnalisé. Or, dans OpenClaw, la capacité de contexte dépend étroitement de ce réglage. Si le modèle prend réellement en charge une fenêtre plus grande, vous devez augmenter cette valeur. Sinon, vous risquez de rencontrer des erreurs API rate limit reached, un contexte insuffisant ou un comportement imprévisible pendant les conversations longues. La documentation officielle précise que le fichier de configuration principal d’OpenClaw est ~/.openclaw/openclaw.json et qu’un fichier models.json peut également être placé dans le répertoire d’un agent. Lorsqu’un modèle correspond, OpenClaw retient la valeur la plus élevée entre la configuration contextWindow / maxTokens et son catalogue implicite.

Dans la configuration Web, recherchez contextWindow, puis remplacez sa valeur par 128000.

Capture de l’onglet « Settings » de la page de configuration OpenClaw. L…

Modifier la configuration du contexte dans OpenClaw

1. Symptômes

Lorsque vous connectez un modèle personnalisé ou un modèle fourni par un relais tiers à OpenClaw, une fenêtre de contexte trop petite dans la configuration du modèle, par exemple :

"contextWindow": 16000,
"maxTokens": 4096

peut entraîner les problèmes suivants :

Échec fréquent des conversations longues
Erreurs plus fréquentes lors de l’appel d’outils
Message API rate limit reached dans l’interface
Traitement du modèle avec une petite fenêtre par OpenClaw alors qu’il prend en charge un contexte plus grand

La documentation officielle d’OpenClaw précise que contextWindow et maxTokens peuvent être définis explicitement dans la configuration. Le fichier de configuration principal se trouve dans ~/.openclaw/openclaw.json, mais une surcharge séparée peut également être définie dans models.json, au sein du répertoire de l’agent.

2. Emplacement des fichiers de configuration

1) Fichier de configuration principal

Chemin par défaut du fichier de configuration principal d’OpenClaw :

~/.openclaw/openclaw.json

Ce chemin est explicitement indiqué dans la documentation officielle.

2) Configuration des modèles d’un agent

Si vous configurez les modèles séparément pour chaque agent, le chemin est généralement le suivant :

~/.openclaw/agents/&lt;agentId&gt;/agent/models.json

La documentation officielle précise qu’un provider personnalisé peut être ajouté dans models.providers ou dans ~/.openclaw/agents/<agentId>/agent/models.json.

3) Répertoire racine personnalisé pour les agents

Si vous avez défini la variable d’environnement suivante :

OPENCLAW_AGENT_DIR

elle remplace le répertoire de configuration des agents. La documentation officielle indique également que OPENCLAW_AGENT_DIR, ou PI_CODING_AGENT_DIR, permet de modifier le répertoire racine de configuration des agents.

3. Modifier les valeurs

Option A : modifier la configuration principale

openclaw.json

Ouvrez :

~/.openclaw/openclaw.json

Repérez la configuration du fournisseur correspondant à votre modèle actif, par exemple :

{
  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
          }
        ]
      }
    }
  }
}

Dans l’exemple MiniMax officiel, MiniMax-M2.5 est bien configuré avec contextWindow: 196608 et maxTokens: 8192.

Option B : modifier le fichier de l’agent

models.json

Ouvrez :

~/.openclaw/agents/&lt;agentId&gt;/agent/models.json

Remplacez les valeurs suivantes pour le modèle concerné :

"contextWindow": 16000,
"maxTokens": 4096

par des valeurs plus adaptées, par exemple :

"contextWindow": 196608,
"maxTokens": 8192

4. Valeurs recommandées

Ne choisissez pas ces valeurs au hasard. Déclarer 1000000 parce que vous souhaiteriez disposer d’un contexte de 1M ne suffit pas à le rendre réel.

Principes recommandés

contextWindow : indiquez la valeur réellement prise en charge par le modèle
maxTokens : indiquez la limite réelle de sortie du modèle
Si vous utilisez une plateforme de relais, vérifiez la limite effectivement autorisée par le relais, et pas uniquement la valeur annoncée par le fournisseur d’origine

Exemple avec MiniMax-M2.5

L’exemple officiel d’OpenClaw recommande :

"contextWindow": 196608,
"maxTokens": 8192

5. Après la modification

Après avoir enregistré la configuration, redémarrez OpenClaw ou le processus gateway concerné.

Commandes courantes :

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

La documentation officielle fournit également ces deux commandes pour vérifier et changer le modèle.

Si OpenClaw fonctionne en tant que service, redémarrez aussi le service correspondant, par exemple :

openclaw gateway restart

Vous pouvez également redémarrer votre propre service systemd / pm2 / docker.

6. Informations complémentaires

La référence de configuration officielle d’OpenClaw précise aussi les points suivants :

Un provider personnalisé peut être défini directement dans models.providers
contextWindow / maxTokens peuvent être définis explicitement
Lorsqu’un modèle correspond, la valeur la plus élevée entre la configuration explicite et le catalogue implicite est retenue
Pour remplacer entièrement models.json par votre propre configuration, utilisez models.mode: "replace".

Enfin, la documentation officielle indique désormais que pour les custom providers, lorsque ces champs sont omis, les valeurs par défaut sont contextWindow: 200000 et maxTokens: 8192. Si la configuration de votre client reste limitée à 16k ou 4k, cela ne signifie probablement pas qu’OpenClaw est actuellement limité à 16k par défaut. Il s’agit plutôt d’une valeur locale réduite manuellement ou d’une ancienne configuration restée en place.

Your privacy choices

Solution au contexte 16k d’OpenClaw