openclaw - 💡(How to fix) Fix ACP SDK: Missing default values for optional array parameters cause Claude tool schema validation to fail [1 participants]

When using Claude (via API Pro or other providers) with OpenClaw's ACP SDK, the agent registration fails with the following error:

• ❌ Claude models: Fail with Invalid schema error until fixed
• Error occurs when agent registers tools with Claude

TL;DR

Add default values to optional array parameters in the affected Zod schemas to fix the agent registration issue with Claude.

Guidance

• Identify the affected Zod schemas in the OpenClaw ACP SDK and add default values to optional array parameters.
• Verify that the fix works by attempting to register an agent with Claude after making the changes.
• Consider manually patching the installed package as a temporary workaround until the fix is available upstream.
• Review the OpenClaw version and provider configuration to ensure compatibility with the fix.

Example

// Example of adding a default value to an optional array parameter
const mySchema = z.array(z.string()).default([]);

Notes

The fix may not be applicable to all versions of OpenClaw or providers, and it's essential to review the specific configuration and version being used.

Recommendation

Apply the workaround by manually patching the installed package until the fix is available upstream, as this will allow for immediate resolution of the issue.