OpenClaw: Lösung für 16K-Kontextfehler

OpenClaw: Lösung für 16K-Kontextfehler

Das Kontextfenster eines Modells ist in OpenClaw nicht grundsätzlich auf 16k festgelegt, sondern wird vor allem durch die lokale Konfiguration bestimmt. Prüfen Sie ~/.openclaw/openclaw.json oder ~/.openclaw/agents/<agentId>/agent/models.json und setzen Sie contextWindow und maxTokens auf Werte, die das jeweilige Modell tatsächlich unterstützt. Für MiniMax-M2.5 können Sie beispielsweise contextWindow: 196608 und maxTokens: 8192 verwenden. Starten Sie OpenClaw nach der Änderung neu. Sowohl die offizielle OpenClaw-Konfigurationsreferenz als auch das MiniMax-Beispiel verwenden diese Werte.

Die Ursache ist in der Regel, dass contextWindow für einen benutzerdefinierten Provider oder ein benutzerdefiniertes Modell auf 16000 oder weniger gesetzt wurde. Unterstützt das Modell tatsächlich ein größeres Kontextfenster, sollten Sie den Wert anheben. Andernfalls kann OpenClaw Fehler wie API rate limit reached melden, zu wenig Kontext bereitstellen oder lange Unterhaltungen unerwartet abbrechen. Laut offizieller Referenz liegt die Hauptkonfiguration unter ~/.openclaw/openclaw.json; zusätzlich kann eine eigene models.json im Agentenverzeichnis verwendet werden. Bei einem passenden Modell verwendet OpenClaw für contextWindow und maxTokens den höheren Wert aus der expliziten Konfiguration und dem impliziten Katalog.

Screenshot zur Konfiguration von OpenClaw

OpenClaw-Kontextfenster konfigurieren

1. Problembeschreibung

Wenn Sie in OpenClaw ein benutzerdefiniertes Modell oder ein Modell über einen Drittanbieter-Gateway einrichten, kann das Kontextfenster in der Modellkonfiguration zu klein gesetzt sein, zum Beispiel:

"contextWindow": 16000,
"maxTokens": 4096

Folgende Probleme können auftreten:

• Lange Unterhaltungen schlagen häufig fehl.
• Tool-Aufrufe verursachen eher Fehler.
• Die Oberfläche meldet API rate limit reached.
• Das Modell unterstützt ein größeres Kontextfenster, OpenClaw verwendet jedoch weiterhin den kleineren Wert.

Die offizielle OpenClaw-Dokumentation bestätigt, dass contextWindow und maxTokens für ein Modell explizit konfiguriert werden können. Die Hauptkonfiguration liegt unter ~/.openclaw/openclaw.json; eine models.json im Agentenverzeichnis kann die Werte separat überschreiben.

2. Speicherort der Konfigurationsdatei

1) Pfad der Hauptkonfiguration

Die standardmäßige OpenClaw-Hauptkonfiguration befindet sich unter:

~/.openclaw/openclaw.json

Dieser Pfad ist in der offiziellen Dokumentation angegeben.

2) Pfad der Agenten-Modellkonfiguration

Wenn ein Modell für einen einzelnen Agenten konfiguriert wird, lautet der Pfad in der Regel:

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

Benutzerdefinierte Provider können laut offizieller Dokumentation unter models.providers oder in ~/.openclaw/agents/<agentId>/agent/models.json definiert werden.

3) Bei einem benutzerdefinierten Stammverzeichnis des Agenten

Wenn Sie die folgende Umgebungsvariable gesetzt haben:

OPENCLAW_AGENT_DIR

Dann wird das Konfigurationsverzeichnis des Agenten durch diese Variable überschrieben. Das Stammverzeichnis der Agentenkonfiguration kann laut Dokumentation über OPENCLAW_AGENT_DIR oder PI_CODING_AGENT_DIR geändert werden.

3. Konfiguration ändern

Lösung A: Hauptkonfiguration ändern

openclaw.json

Öffnen:

~/.openclaw/openclaw.json

Suchen Sie die Konfiguration Ihres aktuellen Modellanbieters, beispielsweise:

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

Das offizielle MiniMax-Beispiel verwendet für MiniMax-M2.5 contextWindow: 196608 und maxTokens: 8192.

Lösung B: Agentenkonfiguration ändern

models.json

Öffnen:

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

Suchen Sie im entsprechenden Modell nach:

"contextWindow": 16000,
"maxTokens": 4096

Ersetzen Sie die Werte durch passende Angaben, beispielsweise:

"contextWindow": 196608,
"maxTokens": 8192

4. Empfohlene Werte

Wählen Sie die Werte nicht willkürlich. Ein gewünschtes Kontextfenster von 1M bedeutet nicht, dass Sie einfach 1000000 eintragen können; das Modell und der Gateway müssen diesen Wert tatsächlich unterstützen.

Grundsätze für die Auswahl

• contextWindow: Verwenden Sie den tatsächlich vom Modell unterstützten Wert.
• maxTokens: Verwenden Sie die tatsächlich unterstützte maximale Ausgabelänge.
• Bei einem API-Gateway gilt dessen tatsächlich freigegebene Obergrenze, nicht nur der vom Modellhersteller beworbene Wert.

Beispiel: MiniMax-M2.5

Das offizielle OpenClaw-Beispiel empfiehlt:

"contextWindow": 196608,
"maxTokens": 8192

5. Schritte nach der Änderung

Starten Sie nach dem Speichern OpenClaw oder den zugehörigen Gateway-Prozess neu.

Häufig verwendete Befehle:

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

Diese beiden Befehle werden auch in der offiziellen Dokumentation zum Prüfen und Wechseln von Modellen genannt.

Wenn OpenClaw als Dienst ausgeführt wird, starten Sie auch den zugehörigen Dienst neu, beispielsweise:

openclaw gateway restart

Alternativ starten Sie Ihren eigenen systemd-, pm2- oder Docker-Dienst neu.

6. Zusätzliche Hinweise

Die offizielle OpenClaw-Konfigurationsreferenz nennt außerdem folgende Punkte:

• Benutzerdefinierte Provider können direkt unter models.providers definiert werden.
• contextWindow und maxTokens lassen sich explizit festlegen.
• Bei einem passenden Modell wird der höhere Wert aus der expliziten Konfiguration und dem impliziten Katalog verwendet.
• Mit models.mode: "replace" können Sie models.json vollständig durch Ihre eigene Konfiguration ersetzen.

In der aktuellen offiziellen Dokumentation steht außerdem: Wenn diese Felder bei benutzerdefinierten Providern fehlen, gelten standardmäßig contextWindow: 200000 und maxTokens: 8192. Wenn ein Client weiterhin nur 16k oder 4k verwendet, liegt das daher normalerweise nicht an einem neuen OpenClaw-Standard, sondern daran, dass die lokale Modellkonfiguration einen kleineren Wert enthält oder eine alte Konfiguration weiterverwendet wird.