openclaw - 💡(How to fix) Fix Control UI: invalid config key agents.defaultId in Set Default Model [1 comments, 2 participants]

Error seen in Gateway logs:

TL;DR

Update the Control UI's submit handler to use the correct agents.list[].default schema field instead of agents.defaultId.

Guidance

• Verify the Control UI's submit handler is constructing the agents.defaultId field and update it to use agents.list[].default as per the OpenClaw config schema.
• Check the OpenClaw version (2026.4.26) to ensure the agents.list[].default mechanism is supported.
• Review the Gateway logs to confirm the error message invalid config: agents: Unrecognized key: "defaultId" is resolved after applying the fix.
• Test the "Set Default Model" page after updating the submit handler to ensure the correct configuration is sent and saved.

Example

// Before
const configPatch = { agents: { defaultId: 'main' } };

// After
const configPatch = { agents: { list: [{ id: 'main', default: true }] } };

Notes

This fix assumes the Control UI has the capability to update the submit handler and that the agents.list[].default mechanism is correctly implemented in the OpenClaw version being used.

Recommendation

Apply workaround: Update the Control UI's submit handler to use the correct agents.list[].default schema field, as this is a more targeted fix and does not require upgrading the OpenClaw version.