Failed with result 'exit-code'.
β
Solved
I had my agent working on a project and not the gateway shutdown and won't start.
{"0":"Gateway failed to start: Error: hooks.allowedSessionKeyPrefixes must include 'hook:' when hooks.defaultSessionKey is unset","_meta":{"runtime":"node","runtimeVersion":"22.22.0","hostname":"unknown","name":"openclaw","date":"2026-02-27T19:02:30.961Z","logLevelId":5,"logLevelName":"ERROR","path":{"fullFilePath":"file:///usr/lib/node_modules/openclaw/dist/subsystem-DypCPrmP.js:1012:68","fileName":"subsystem-DypCPrmP.js","fileNameWithLine":"subsystem-DypCPrmP.js:1012","fileColumn":"68","fileLine":"1012","filePath":"/usr/lib/node_modules/openclaw/dist/subsystem-DypCPrmP.js","filePathWithLine":"/usr/lib/node_modules/openclaw/dist/subsystem-DypCPrmP.js:1012","method":"console.error"}},"time":"2026-02-27T19:02:30.964Z"}
{"0":"Gateway failed to start: Error: hooks.allowedSessionKeyPrefixes must include 'hook:' when hooks.defaultSessionKey is unset","_meta":{"runtime":"node","runtimeVersion":"22.22.0","hostname":"unknown","name":"openclaw","date":"2026-02-27T19:02:30.961Z","logLevelId":5,"logLevelName":"ERROR","path":{"fullFilePath":"file:///usr/lib/node_modules/openclaw/dist/subsystem-DypCPrmP.js:1012:68","fileName":"subsystem-DypCPrmP.js","fileNameWithLine":"subsystem-DypCPrmP.js:1012","fileColumn":"68","fileLine":"1012","filePath":"/usr/lib/node_modules/openclaw/dist/subsystem-DypCPrmP.js","filePathWithLine":"/usr/lib/node_modules/openclaw/dist/subsystem-DypCPrmP.js:1012","method":"console.error"}},"time":"2026-02-27T19:02:30.964Z"}
Solution
Docs for the breaking change + the expected config:
- https://docs.openclaw.ai/automation/webhook (see βSession key policy (breaking change)β)
- https://docs.openclaw.ai/gateway/configuration-reference#hooks
If it still wonβt start after that, paste:
OpenClaw: The AI that actually does things. Emails, calendar, home automation - all from your favorite chat app. New shell, ready to help. The lobster way.
155,459Members
Resources
Similar Threads
Was this page helpful?
