#Bug: openclaw_gateway rejects Paperclip agent heartbeats — "unexpected property 'paperclip'"

1 messages · Page 1 of 1 (latest)

cerulean dome
#

Version: OpenClaw 2026.4.26 (be8c246), Paperclip latest (rev 3494e84)

Paperclip now injects a paperclip property into the root of the agent invocation payload when invoking agents via the openclaw_gateway adapter. The gateway rejects it with:

invalid agent params: at root: unexpected property 'paperclip'
AgentParamsSchema in protocol-Hjar_s3V.js has additionalProperties: false — any unknown field fails validation.

Temp workaround: Manually added paperclip: Type.Optional(Type.Unknown()) to AgentParamsSchema in the installed bundle.

Fix needed: Add paperclip: Type.Optional(Type.Unknown()) to AgentParamsSchema upstream, or switch to passing Paperclip run context via the existing extraSystemPrompt/inputProvenance fields.

edgy emberBOT
#

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

cerulean dome
#

Is this the place to post something like this?

tepid schoonerBOT
#

Yep, this looks like a real gateway/Paperclip compatibility bug.

I checked the local OpenClaw ref: AgentParamsSchema is strict with additionalProperties: false, and paperclip is not currently accepted there. So Paperclip adding a root-level paperclip field will fail exactly as reported.

Best upstream shape is probably one of:

  1. Accept compatibility field

    paperclip: Type.Optional(Type.Unknown())

    in AgentParamsSchema.

  2. Better long-term: Paperclip should pass run context through existing typed/context fields like inputProvenance / extraSystemPrompt, instead of adding a new root key.

The manual bundle patch is fine as a temporary workaround, but it’ll be overwritten by updates/reinstalls.

Please file this as a GitHub issue with the versions + failing payload shape:

#

Yes for a sanity check / community visibility, but the actionable place is GitHub Issues since this needs an upstream protocol/schema fix:

https://github.com/openclaw/openclaw/issues

I’d post basically what you wrote here: OpenClaw version, Paperclip rev, exact error, root cause (additionalProperties: false + unexpected paperclip), and the temporary workaround. That’s enough for maintainers to track/fix it. 🦐

cerulean dome