Three Common Pitfalls When Installing a Plugin Into OpenClaw's Agent Gateway
A developer documented three distinct failures encountered while integrating a custom plugin into OpenClaw, an MIT-licensed npm-distributed agent runtime built by steipete and vincentkoc. The first issue arose because OpenClaw's plugin loader refused to load code from WSL's DrvFs mount, which exposes Windows filesystem paths as world-writable (mode 777), a deliberate security measure requiring the plugin to be moved to a native ext4 filesystem with restricted permissions. The second problem was that a loose TypeScript file registered via config could be discovered but would never activate at gateway startup without a proper manifest declaring 'activation: { onStartup: true }', a distinction the CLI surfaces through separate commands. The third failure occurred during installation, when OpenClaw's '--link' install command immediately calls the plugin's register function, exposing a malformed hook matcher argument — an object shape instead of the required array of tool names — as a hard runtime error. Each issue reflected a sensible enforcement by OpenClaw rather than a bug, and resolving all three required using the framework's official scaffold command and reading its generated manifest structure carefully.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.


Discussion (0)
Log in to join the discussion and vote.
Log in