Skip to content

agents.list[].params rejected by doctor as 'Unrecognized key' despite being documented #29771

@zweice

Description

@zweice

Bug Report

Version: 2026.2.26

Description:
The params key in agents.list[] entries is documented as supported for per-agent model param overrides (configuration-reference.md: "params: per-agent stream params merged over the selected model entry in agents.defaults.models"), but openclaw doctor rejects it as an unrecognized key.

Config example (from docs):

agents: {
  list: [
    {
      id: "myagent",
      params: { cacheRetention: "short" }  // per-agent override
    }
  ]
}

Doctor output:

Invalid config:
- agents.list.2: Unrecognized key: "params"

Expected: Doctor passes, per-agent params override works at runtime.
Actual: Doctor rejects with "Invalid config" — cannot safely restart gateway.

Use case: Different agents have different activity patterns (burst vs long-running cycles), so per-agent cacheRetention is important for cost optimization. Currently blocked.

Workaround: Using global agents.defaults.models params, which applies to all agents uniformly.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions