openclaw - ✅(Solved) Fix Docs: contextTokens placement in agents.defaults.model doesn't match schema [1 pull requests, 1 comments, 2 participants]

openclaw2026-04-19 02:03:07

ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

GitHub issue URL

Helpful · Quick feedback

GitHub stats

openclaw/openclaw#68768•Fetched 2026-04-19 15:07:52

View on GitHub

Comments

Participants

Timeline

Reactions

Author

ajfonthemove

Participants

ajfonthemove

shakkernerd

Timeline (top)

closed ×1commented ×1cross-referenced ×1labeled ×1

Code Example

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        contextTokens: 200000
      }
    }
  }
}

---

{
  agents: {
    defaults: {
      model: {
        primary: "openai-codex/gpt-5.4",
        fallbacks: []
      },
      contextTokens: 1050000
    }
  }
}

RAW_BUFFERClick to expand / collapse

Problem

The configuration reference at /gateway/configuration-reference documents contextTokens as a field inside agents.defaults.model:

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        contextTokens: 200000
      }
    }
  }
}

The gateway rejects this with agents.defaults.model: Invalid input on startup (tested on 2026.4.15).

Correct placement

contextTokens is accepted as a sibling to model at the agents.defaults level:

{
  agents: {
    defaults: {
      model: {
        primary: "openai-codex/gpt-5.4",
        fallbacks: []
      },
      contextTokens: 1050000
    }
  }
}

This starts cleanly with no config warnings.

Impact

Anyone following the docs to override the default runtime context cap (e.g. raising openai-codex/gpt-5.4 from the 272K default to its native 1.05M) will hit a startup failure and have to guess the correct placement.

Versions

OpenClaw 2026.4.15 (041266a)
Config schema validation rejects contextTokens inside model object

extent analysis

TL;DR

Move the contextTokens field to be a sibling of model inside the agents.defaults object to resolve the configuration error.

Guidance

Verify that the contextTokens field is correctly placed outside of the model object, as shown in the corrected example.
Check the configuration reference at /gateway/configuration-reference for any updates or corrections to the agents.defaults.model structure.
Test the configuration with the corrected placement of contextTokens to ensure a clean startup without warnings.
If issues persist, review the config schema validation rules to ensure they align with the expected structure.

Example

{
  agents: {
    defaults: {
      model: {
        primary: "openai-codex/gpt-5.4",
        fallbacks: []
      },
      contextTokens: 1050000
    }
  }
}

Notes

The provided solution assumes that the configuration reference will be updated to reflect the correct placement of contextTokens. Until then, users will need to manually correct their configurations to match the expected structure.

Recommendation

Apply workaround: Move the contextTokens field to be a sibling of model inside the agents.defaults object, as this resolves the immediate configuration error and allows for a clean startup.

Vote matrix · Quick signals

Works

Did the solution work? Tap to confirm.

Easy Fix

Was it a quick fix?

Time Saver

Did it save you time?

Blocking

Was it severely blocking?

Common Issue

Are others likely hitting this too?

Flaky / Intermittent

Is it intermittent?

Verified / Reproducible

Can you reproduce it reliably?

#environment setup #docker error #permission error #memory optimization #batch processing

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

openclaw - ✅(Solved) Fix Docs: contextTokens placement in agents.defaults.model doesn't match schema [1 pull requests, 1 comments, 2 participants]

Recommended Tools

GitHub issue graph ai analysis

Fix Action

Fixed

PR fix notes

PR #68775: docs(providers): fix contextTokens placement for openai-codex

Description (problem / solution / changelog)

Summary

Change Type (select all)

Scope (select all touched areas)

Linked Issue/PR

Root Cause (if applicable)

Regression Test Plan (if applicable)

User-visible / Behavior Changes

Diagram (if applicable)

Security Impact (required)

Repro + Verification

Environment

Steps

Expected

Actual

Evidence

Human Verification (required)

Review Conversations

Compatibility / Migration

Risks and Mitigations

AI Disclosure

Changed files