PR #62013: fix(config): suggest .config nesting for misplaced plugin entry keys

• Repository: openclaw/openclaw
• Author: martingarramon
• State: open | merged: False
• Link: https://github.com/openclaw/openclaw/pull/62013

Description (problem / solution / changelog)

Plugin-specific config keys placed directly on plugins.entries.<id> (e.g. plugins.entries.openshell.policy) are rejected with a bare "Unrecognized key" message that doesn't indicate the correct nesting under .config.

The validation error now suggests the right path:

Unrecognized key(s) in object: "policy"
  (did you mean plugins.entries.openshell.config.policy?
   Plugin-specific settings belong under the "config" key)

The hint is added in the existing Zod issue post-processing pipeline — no schema changes. If the path/message pattern doesn't match, the original message is returned unchanged.

Fixes #60963

Testing

• 3 new tests in validation.plugin-entry-hint.test.ts: single key hint, multiple key hint, no hint on non-plugin paths
• Existing validation.policy.test.ts suite passes (5/5)

Note: tsgo in the pre-commit hook fails on 4 pre-existing type errors on main — unrelated to this change. Filed as #62014.

Changed files

• src/config/validation.plugin-entry-hint.test.ts (added, +68/-0)
• src/config/validation.ts (modified, +22/-4)

PR #62091: fix(config): append bound hints to numeric ceiling/floor rejections

• Repository: openclaw/openclaw
• Author: martingarramon
• State: open | merged: False
• Link: https://github.com/openclaw/openclaw/pull/62091

Description (problem / solution / changelog)

Closes #52500

When a numeric config value violates a .max() or .min() Zod constraint, the error message now appends a structured (maximum: N) or (minimum: N) hint — matching the existing (allowed: ...) pattern already used for enum rejections.

Before: session.agentToAgent.maxPingPongTurns: Number must be less than or equal to 5 After: session.agentToAgent.maxPingPongTurns: Number must be less than or equal to 5 (maximum: 5)

The formatBoundHint helper handles both inclusive (maximum: N) and exclusive (must be less than N) constraints, and is scoped to too_big/too_small Zod issue codes only — it does not affect enum, union, or type-mismatch error paths.

Testing: Two new test cases in validation.allowed-values.test.ts covering ceiling and floor violations against session.agentToAgent.maxPingPongTurns (capped at 0–5). Pre-commit hook skipped due to pre-existing tsgo type errors on main (#62014).

🤖 Generated with Claude Code

Changed files

• src/config/validation.allowed-values.test.ts (modified, +30/-0)
• src/config/validation.ts (modified, +29/-8)