Hook parity with upstream openclaw
WednesdayAI is a fork of upstream openclaw, and the plugin hook surface has drifted between the two. This page is the map. It pins the upstream reference level: openclawv2026.6.9
(commit c645ec4), taken from the PLUGIN_HOOK_NAMES array in upstream
src/plugins/hook-types.ts.
Every upstream hook name has one of three statuses:
both— the hook exists in upstream openclaw and WednesdayAI dispatches it. Register it withapi.onand it works in both.upstream only— the hook exists upstream but WednesdayAI does not dispatch it. Each row carries a disposition (below) and, where one exists, the WednesdayAI hook to use instead.WednesdayAI only— the hook is a WednesdayAI addition with no upstream equivalent.
upstream only hook has one of two dispositions:
planned port— a port into the WednesdayAI hook surface is planned and tracked.unsupported— there is no equivalent seam in WednesdayAI and no port is planned.
Use instead hook, the plugin must register that hook itself.
When a hook is not dispatched
When a plugin registers an upstream only hook name withapi.on, the handler is ignored and
the plugin keeps loading. The ignored registration is reported as a PLUGIN_HOOK_NOT_DISPATCHED
warning, so a plugin that relies on the handler silently does nothing while still appearing to
load.
Operators see the warning in four places:
-
The gateway startup log, for example:
-
wednesdayai plugins listshows the plugin asdegraded. -
wednesdayai plugins statuslists the issue with its remediation. -
wednesdayai plugins doctorreports the same warnings.
api.registerHook. A typed hook name belongs on api.on;
registering one through registerHook warns. An event string that no internal emitter
produces warns the same way. The event strings that core actually produces are listed in
Internal hooks.
Parity table
Upstream reference level: openclawv2026.6.9 (commit c645ec4).
Updating the map
Maintainers update the map when the upstream hook surface changes:- Copy the upstream hook names at the new tag from upstream
src/plugins/hook-types.ts(thePLUGIN_HOOK_NAMESarray at 2026.6.x, thePLUGIN_HOOK_METADATAkeys at 2026.10.x) intosrc/plugins/hook-parity.jsontogether with the new version, tag and commit. - Run
pnpm exec vitest run src/plugins/hook-parity.test.ts. The test names every missing or stale disposition. - Fill in the dispositions in
src/plugins/hook-parity.jsonand runpnpm docs:hook-parityto regenerate the table above. - Amend the compatibility ADR.