Publish a WednesdayAI plugin to npm and understand the managed install lifecycle: install, enable, update, uninstall.
Publishing a plugin
A WednesdayAI plugin is an npm package. Once published, operators install it with openclaw plugins install, which copies it into the managed extensions directory and tracks it for updates.
Before you publish
Make sure your package meets the basics:
"type": "module" in package.json (the SDK is ESM).
An openclaw.plugin.json manifest at the package root with id + configSchema. See the manifest reference.
openclaw pinned to exactly 2026.3.2 in devDependencies / peerDependencies — never in dependencies, never a range.
No workspace:* in dependencies (it breaks npm install --omit=dev).
Plugin id, directory name, and npm package name all match.
New WednesdayAI-native plugins publish under the @wednesdayai/* scope.
Include openclaw.plugin.json in your published files list. Without the manifest in the
tarball, the plugin will fail config validation after install.
Publish to npm
npm run build # produce dist/npm pack # inspect the tarball contents firstnpm publish --access public
The managed install lifecycle
Operators manage your plugin with the openclaw plugins commands. Installs are registry-only — git, URL, and file specs are rejected for remote installs; local installs use a path.
Install
openclaw plugins install @wednesdayai/my-pluginopenclaw plugins install @wednesdayai/my-plugin --pin # save the exact resolved name@versionopenclaw plugins install ./my-plugin-1.0.0.tgz # local archiveopenclaw plugins install -l ./my-plugin # link a local dir (adds to plugins.load.paths)
Supported archives: .zip, .tgz, .tar.gz, .tar.
Dependency installs run with --ignore-scripts (no lifecycle scripts) for safety.
A bare spec that matches a bundled plugin id installs the bundled plugin; use an explicit scoped spec to install a same-named npm package.
Managed installs land in ~/.openclaw/extensions/ and are enabled by default.
Updates apply only to plugins installed from npm (tracked in plugins.installs). When a stored integrity hash exists and the fetched artifact hash changes, WednesdayAI warns and asks for confirmation before proceeding. Use the global --yes flag to bypass prompts in CI.
Inspect
openclaw plugins list # all discovered plugins + statusopenclaw plugins info my-pluginopenclaw plugins doctor # manifest/schema/config diagnostics
Uninstall removes the plugin’s records from plugins.entries, plugins.installs, the allowlist, and any linked plugins.load.paths entries, and by default removes the install directory under the state-dir extensions root. --keep-files leaves files on disk.
Security expectations
Treat plugin installs like running code. The install path is hardened, but operators are trusting your package:
Prefer pinned versions (--pin).
Keep dependencies minimal and free of postinstall build steps (installs use --ignore-scripts).
Document any native build requirements clearly.
Getting listed as a community plugin
WednesdayAI maintains a community plugin list. To be listed, a plugin should be:
Published on npm (installable via openclaw plugins install <npm-spec>).
Open-source on GitHub with setup docs and an issue tracker.
Submit a PR adding your plugin’s name, npm package, repo URL, one-line description, and install command. Low-effort wrappers or unmaintained packages may be declined.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"WednesdayAI","description":"The AI platform that stays yours. Documentation for administrators, users, and developers.","colors":{"primary":"#6366f1","light":"#818cf8","dark":"#4f46e5"},"logo":{"light":"https://mintcdn.com/expansionxpartners/dow-8PUnQ_SAIAho/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=dow-8PUnQ_SAIAho\u0026q=85\u0026s=8b9f28296cca622a181934acf27d274b","dark":"https://mintcdn.com/expansionxpartners/dow-8PUnQ_SAIAho/assets/logo-dark.svg?fit=max\u0026auto=format\u0026n=dow-8PUnQ_SAIAho\u0026q=85\u0026s=635a03b67088a77559481dfab5e1e12f"},"favicon":"https://mintcdn.com/expansionxpartners/dow-8PUnQ_SAIAho/assets/favicon.svg?fit=max\u0026auto=format\u0026n=dow-8PUnQ_SAIAho\u0026q=85\u0026s=88396129c7038fbb5e487a35b26b1ffd","background":{"color":{"dark":"#0f172a"}},"navbar":{"links":[{"icon":"github","href":"https://github.com/ExpansionX/WednesdayAI-core","label":"GitHub"},{"icon":"discord","href":"https://discord.gg/wednesdayai","label":"Discord"}],"primary":{"type":"button","label":"Get started","href":"/admin/getting-started"}},"search":{"prompt":"Search WednesdayAI docs..."},"seo":{"indexing":"navigable"},"fonts":{"heading":{"family":"Space Grotesk"},"body":{"family":"Inter"}},"icons":{"library":"lucide"},"styling":{"codeblocks":"dark","latex":true},"banner":{"content":"Latest release: WednesdayAI v0.6.1 ([release notes](https://github.com/ExpansionX/WednesdayAI-core/releases/tag/v0.6.1)). Use the version menu for unreleased (next) or older docs.","dismissible":true},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"megaphone","href":"/changelog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/ExpansionX/WednesdayAI-core"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"expansionxpartners","hasAudioNarration":false,"actualSubdomain":"expansionxpartners","customDomains":["docs.wednesdayai.dev"],"gitSource":{"type":"github","owner":"expansionx","repo":"wednesdayai-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afc0b28959cb52827702c74","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Administrators","count":366},{"language":"default","tag":"Users","count":298},{"language":"default","tag":"Developers","count":212},{"language":"default","tag":"CLI command reference","count":90},{"language":"default","tag":"AI providers","count":66},{"language":"default","tag":"Gateway (synced pages)","count":62},{"language":"default","tag":"Core concepts (developer)","count":58},{"language":"default","tag":"More agent tools","count":56},{"language":"default","tag":"Extension points","count":50},{"language":"default","tag":"Channels (synced pages)","count":40}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--wai-indigo: #6366f1;--wai-indigo-400: #818cf8;--wai-indigo-600: #5457e5;--wai-violet: #8b5cf6;--wai-pink: #f472b6;--wai-slate-950: #0f172a;--wai-radius: 12px;--wai-ease: cubic-bezier(0.16, 1, 0.3, 1)}h1,h2,h3,.prose h1,.prose h2,.prose h3{letter-spacing:-0.025em}h1,.prose h1{letter-spacing:-0.035em}.eyebrow,[data-eyebrow]{text-transform:uppercase;letter-spacing:0.08em;font-weight:600}a[class*=\"card\"],div[class*=\"card\"],.card{border-radius:var(--wai-radius);transition:border-color 200ms var(--wai-ease),\n transform 120ms var(--wai-ease),\n box-shadow 200ms var(--wai-ease)}@media (prefers-reduced-motion: no-preference){a[class*=\"card\"]:hover,div[class*=\"card\"]:hover,.card:hover{transform:translateY(-1px);border-color:var(--wai-indigo-400);box-shadow:0 4px 12px rgba(0, 0, 0, 0.18), 0 0 0 1px rgba(99, 102, 241, 0.25)}}a:hover{text-decoration-color:var(--wai-indigo)}a:focus-visible,button:focus-visible,[tabindex]:focus-visible{outline:none;box-shadow:0 0 0 2px var(--wai-slate-950), 0 0 0 4px var(--wai-indigo);border-radius:6px}:root[class~=\"light\"] a:focus-visible,:root[class~=\"light\"] button:focus-visible{box-shadow:0 0 0 2px #ffffff, 0 0 0 4px var(--wai-indigo)}@media (prefers-reduced-motion: no-preference){a[class*=\"primary\"]:hover,button[class*=\"primary\"]:hover{box-shadow:0 8px 24px rgba(99, 102, 241, 0.4);transform:translateY(-1px)}}pre ::selection,code ::selection{background:rgba(99, 102, 241, 0.28)}[aria-current=\"page\"]{--tw-text-opacity: 1}header,nav[class*=\"navbar\"]{background-image:radial-gradient(60% 120% at 12% 0%, rgba(99, 102, 241, 0.10), transparent 60%)}.brand-accent,.nav__title b{color:var(--wai-pink)}"}]}
{"page":{"pagePath":"developers/plugins/publishing","slug":"/developers/plugins/publishing","pageMetadata":{"title":"Publishing a plugin","description":"Publish a WednesdayAI plugin to npm and understand the managed install lifecycle: install, enable, update, uninstall.","audience":"developer","href":"/developers/plugins/publishing"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Publish a WednesdayAI plugin to npm and understand the managed install lifecycle: install, enable, update, uninstall.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`publishing-a-plugin`,children:`Publishing a plugin`}),`\n`,_jsxs(_components.p,{children:[`A WednesdayAI plugin is an npm package. Once published, operators install it with `,_jsx(_components.code,{children:`openclaw plugins install`}),`, which copies it into the managed extensions directory and tracks it for updates.`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-publish`,children:`Before you publish`}),`\n`,_jsx(_components.p,{children:`Make sure your package meets the basics:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`\"type\": \"module\"`}),` in `,_jsx(_components.code,{children:`package.json`}),` (the SDK is ESM).`]}),`\n`,_jsxs(_components.li,{children:[`An `,_jsx(_components.code,{children:`openclaw.plugin.json`}),` manifest at the package root with `,_jsx(_components.code,{children:`id`}),` + `,_jsx(_components.code,{children:`configSchema`}),`. See the `,_jsx(_components.a,{href:`/developers/plugins/manifest`,children:`manifest reference`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`openclaw`}),` pinned to exactly `,_jsx(_components.code,{children:`2026.3.2`}),` in `,_jsx(_components.code,{children:`devDependencies`}),` / `,_jsx(_components.code,{children:`peerDependencies`}),` — never in `,_jsx(_components.code,{children:`dependencies`}),`, never a range.`]}),`\n`,_jsxs(_components.li,{children:[`No `,_jsx(_components.code,{children:`workspace:*`}),` in `,_jsx(_components.code,{children:`dependencies`}),` (it breaks `,_jsx(_components.code,{children:`npm install --omit=dev`}),`).`]}),`\n`,_jsx(_components.li,{children:`Plugin id, directory name, and npm package name all match.`}),`\n`,_jsxs(_components.li,{children:[`New WednesdayAI-native plugins publish under the `,_jsx(_components.code,{children:`@wednesdayai/*`}),` scope.`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"@wednesdayai/my-plugin\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"version\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"1.0.0\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"module\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"main\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"dist/index.js\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"files\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"dist\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"openclaw.plugin.json\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"openclaw\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"my-plugin\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"peerDependencies\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`\"openclaw\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"2026.3.2\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"devDependencies\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`\"openclaw\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"2026.3.2\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Include `,_jsx(_components.code,{children:`openclaw.plugin.json`}),` in your published `,_jsx(_components.code,{children:`files`}),` list. Without the manifest in the\ntarball, the plugin will fail config validation after install.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`publish-to-npm`,children:`Publish to npm`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` run build `}),_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`# produce dist/`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` pack `}),_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`# inspect the tarball contents first`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` publish --access public`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`the-managed-install-lifecycle`,children:`The managed install lifecycle`}),`\n`,_jsxs(_components.p,{children:[`Operators manage your plugin with the `,_jsx(_components.code,{children:`openclaw plugins`}),` commands. Installs are `,_jsx(_components.strong,{children:`registry-only`}),` — git, URL, and file specs are rejected for remote installs; local installs use a path.`]}),`\n`,_jsx(Heading,{level:`3`,id:`install`,children:`Install`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins install @wednesdayai/my-plugin`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins install @wednesdayai/my-plugin --pin `}),_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`# save the exact resolved name@version`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins install ./my-plugin-1.0.0.tgz `}),_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`# local archive`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins install -l ./my-plugin `}),_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`# link a local dir (adds to plugins.load.paths)`})]}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Supported archives: `,_jsx(_components.code,{children:`.zip`}),`, `,_jsx(_components.code,{children:`.tgz`}),`, `,_jsx(_components.code,{children:`.tar.gz`}),`, `,_jsx(_components.code,{children:`.tar`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Dependency installs run with `,_jsx(_components.code,{children:`--ignore-scripts`}),` (no lifecycle scripts) for safety.`]}),`\n`,_jsx(_components.li,{children:`A bare spec that matches a bundled plugin id installs the bundled plugin; use an explicit scoped spec to install a same-named npm package.`}),`\n`,_jsxs(_components.li,{children:[`Managed installs land in `,_jsx(_components.code,{children:`~/.openclaw/extensions/`}),` and are `,_jsx(_components.strong,{children:`enabled by default`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`enable-/-disable`,children:`Enable / disable`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins enable my-plugin`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins disable my-plugin`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Bundled plugins ship `,_jsx(_components.strong,{children:`disabled`}),` and must be enabled explicitly. Installed plugins are enabled on install but can be disabled the same way.`]}),`\n`,_jsx(Heading,{level:`3`,id:`update`,children:`Update`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins update my-plugin`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins update --all`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins update my-plugin --dry-run`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Updates apply only to plugins installed from npm (tracked in `,_jsx(_components.code,{children:`plugins.installs`}),`). When a stored integrity hash exists and the fetched artifact hash changes, WednesdayAI warns and asks for confirmation before proceeding. Use the global `,_jsx(_components.code,{children:`--yes`}),` flag to bypass prompts in CI.`]}),`\n`,_jsx(Heading,{level:`3`,id:`inspect`,children:`Inspect`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins list `}),_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`# all discovered plugins + status`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins info my-plugin`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins doctor `}),_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`# manifest/schema/config diagnostics`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`uninstall`,children:`Uninstall`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins uninstall my-plugin`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins uninstall my-plugin --dry-run`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`openclaw plugins uninstall my-plugin --keep-files`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Uninstall removes the plugin’s records from `,_jsx(_components.code,{children:`plugins.entries`}),`, `,_jsx(_components.code,{children:`plugins.installs`}),`, the allowlist, and any linked `,_jsx(_components.code,{children:`plugins.load.paths`}),` entries, and by default removes the install directory under the state-dir extensions root. `,_jsx(_components.code,{children:`--keep-files`}),` leaves files on disk.`]}),`\n`,_jsx(Heading,{level:`2`,id:`security-expectations`,children:`Security expectations`}),`\n`,_jsx(_components.p,{children:`Treat plugin installs like running code. The install path is hardened, but operators are trusting your package:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Prefer pinned versions (`,_jsx(_components.code,{children:`--pin`}),`).`]}),`\n`,_jsxs(_components.li,{children:[`Keep dependencies minimal and free of postinstall build steps (installs use `,_jsx(_components.code,{children:`--ignore-scripts`}),`).`]}),`\n`,_jsx(_components.li,{children:`Document any native build requirements clearly.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`getting-listed-as-a-community-plugin`,children:`Getting listed as a community plugin`}),`\n`,_jsx(_components.p,{children:`WednesdayAI maintains a community plugin list. To be listed, a plugin should be:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Published on npm (installable via `,_jsx(_components.code,{children:`openclaw plugins install \u003cnpm-spec>`}),`).`]}),`\n`,_jsx(_components.li,{children:`Open-source on GitHub with setup docs and an issue tracker.`}),`\n`,_jsx(_components.li,{children:`Actively maintained (responsive issues, recent updates).`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Submit a PR adding your plugin’s name, npm package, repo URL, one-line description, and install command. Low-effort wrappers or unmaintained packages may be declined.`}),`\n`,_jsx(Heading,{level:`2`,id:`what’s-next`,children:`What’s next`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/developers/plugins/manifest`,children:`Plugin manifest reference`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/developers/plugins/your-first-plugin`,children:`Write your first plugin`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/developers/contributing`,children:`Contributing`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Publishing a plugin","description":"Publish a WednesdayAI plugin to npm and understand the managed install lifecycle: install, enable, update, uninstall.","audience":"developer","href":"/developers/plugins/publishing"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Publishing a plugin","slug":"publishing-a-plugin","depth":1,"children":[]},{"title":"Before you publish","slug":"before-you-publish","depth":2,"children":[]},{"title":"Publish to npm","slug":"publish-to-npm","depth":2,"children":[]},{"title":"The managed install lifecycle","slug":"the-managed-install-lifecycle","depth":2,"children":[{"title":"Install","slug":"install","depth":3,"children":[]},{"title":"Enable / disable","slug":"enable-/-disable","depth":3,"children":[]},{"title":"Update","slug":"update","depth":3,"children":[]},{"title":"Inspect","slug":"inspect","depth":3,"children":[]},{"title":"Uninstall","slug":"uninstall","depth":3,"children":[]}]},{"title":"Security expectations","slug":"security-expectations","depth":2,"children":[]},{"title":"Getting listed as a community plugin","slug":"getting-listed-as-a-community-plugin","depth":2,"children":[]},{"title":"What’s next","slug":"what’s-next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"expansionxpartners","siteName":"WednesdayAI","title":"Publishing a plugin - WednesdayAI","navMaps":{"firstHrefInVersion":{"v0.6.1":{"href":"/developers/plugins/publishing","matchLevel":0},"next":{"href":"/next/developers/plugins/publishing","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-05-30T11:13:21.242Z","originalFileLocation":"developers/plugins/publishing.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Publish a WednesdayAI plugin to npm and understand the managed install lifecycle: install, enable, update, uninstall.\">\u003cmeta data-mint-head name=\"application-name\" content=\"WednesdayAI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/expansionxpartners/ueEk4c188hOwlmD6/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/expansionxpartners/ueEk4c188hOwlmD6/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/expansionxpartners/ueEk4c188hOwlmD6/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/expansionxpartners/ueEk4c188hOwlmD6/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/expansionxpartners/ueEk4c188hOwlmD6/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/expansionxpartners/ueEk4c188hOwlmD6/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/expansionxpartners/ueEk4c188hOwlmD6/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/expansionxpartners/ueEk4c188hOwlmD6/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/expansionxpartners/ueEk4c188hOwlmD6/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Publishing a plugin - WednesdayAI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Publish a WednesdayAI plugin to npm and understand the managed install lifecycle: install, enable, update, uninstall.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"WednesdayAI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.wednesdayai.dev/developers/plugins/publishing\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://expansionxpartners.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Publishing+a+plugin\u0026amp;description=Publish+a+WednesdayAI+plugin+to+npm+and+understand+the+managed+install+lifecycle%3A+install%2C+enable%2C+update%2C+uninstall.\u0026amp;theme=723ad5e52117fba83642fb4a\u0026amp;signature=d4f637200dee669f8cd695aabf2273902cdf6791718afba81a8004511f3cd431\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Publishing a plugin - WednesdayAI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Publish a WednesdayAI plugin to npm and understand the managed install lifecycle: install, enable, update, uninstall.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://expansionxpartners.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Publishing+a+plugin\u0026amp;description=Publish+a+WednesdayAI+plugin+to+npm+and+understand+the+managed+install+lifecycle%3A+install%2C+enable%2C+update%2C+uninstall.\u0026amp;theme=723ad5e52117fba83642fb4a\u0026amp;signature=d4f637200dee669f8cd695aabf2273902cdf6791718afba81a8004511f3cd431\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/expansionxpartners/ueEk4c188hOwlmD6/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"WednesdayAI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366f1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.wednesdayai.dev/developers/plugins/publishing\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developers/plugins/publishing.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.wednesdayai.dev/#organization\",\"name\":\"WednesdayAI\",\"url\":\"https://docs.wednesdayai.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/expansionxpartners/dow-8PUnQ_SAIAho/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=dow-8PUnQ_SAIAho\u0026q=85\u0026s=8b9f28296cca622a181934acf27d274b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.wednesdayai.dev#website\",\"name\":\"WednesdayAI\",\"url\":\"https://docs.wednesdayai.dev\",\"publisher\":{\"@id\":\"https://docs.wednesdayai.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.wednesdayai.dev/developers/plugins/publishing#webpage\",\"url\":\"https://docs.wednesdayai.dev/developers/plugins/publishing\",\"name\":\"Publishing a plugin\",\"description\":\"Publish a WednesdayAI plugin to npm and understand the managed install lifecycle: install, enable, update, uninstall.\",\"dateModified\":\"2026-05-30T11:13:21.242Z\",\"isPartOf\":{\"@id\":\"https://docs.wednesdayai.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.wednesdayai.dev/developers/plugins/publishing#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.wednesdayai.dev/developers/plugins/publishing#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting started\",\"item\":\"https://docs.wednesdayai.dev/developers/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Publishing a plugin\",\"item\":\"https://docs.wednesdayai.dev/developers/plugins/publishing\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.wednesdayai.dev/developers/plugins/publishing#article\",\"headline\":\"Publishing a plugin\",\"name\":\"Publishing a plugin\",\"description\":\"Publish a WednesdayAI plugin to npm and understand the managed install lifecycle: install, enable, update, uninstall.\",\"url\":\"https://docs.wednesdayai.dev/developers/plugins/publishing\",\"mainEntityOfPage\":{\"@id\":\"https://docs.wednesdayai.dev/developers/plugins/publishing#webpage\"},\"dateModified\":\"2026-05-30T11:13:21.242Z\",\"publisher\":{\"@id\":\"https://docs.wednesdayai.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.wednesdayai.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"WednesdayAI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"WednesdayAI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developers/plugins/publishing.md","siteName":"WednesdayAI","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"megaphone","href":"/changelog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/ExpansionX/WednesdayAI-core"}]},"versions":[{"version":"v0.6.1","default":true,"tag":"Latest","tabs":[{"tab":"Administrators","icon":"server-cog","pages":[{"title":"Administrators","href":"/admin/getting-started"}]},{"tab":"Users","icon":"user-round","pages":[{"title":"Users","href":"/users/what-is-wednesdayai"}]},{"tab":"Developers","icon":"code","groups":[{"group":"Getting started","icon":"rocket","pages":[{"title":"Developer overview","href":"/developers/overview"},{"title":"Write your first plugin","href":"/developers/plugins/your-first-plugin"},{"title":"Plugin Manifest","href":"/developers/plugins/manifest"},{"title":"Versioned Kernel Contracts","href":"/developers/plugins/contracts"},{"title":"Hook parity with upstream openclaw","href":"/developers/plugins/hook-parity"},{"title":null,"description":null,"href":"/developers/plugins/session-identity-keying"},{"title":"Publishing a plugin","href":"/developers/plugins/publishing"}]},{"group":"Extension points","icon":"puzzle","pages":[{"title":"Hooks","description":"Two kinds of hooks in WednesdayAI: in-plugin lifecycle hooks via api.on(), and standalone HOOK.md event hooks.","href":"/developers/hooks"},{"title":"Task pipeline","sidebarTitle":"Task pipeline","href":"/developers/tasks"},{"title":"Channel adapters","href":"/developers/channel-adapters"},{"title":"Agent tools","href":"/developers/agent-tools"},{"title":"Plugin Analysis Runtime","href":"/developers/analysis-runtime"},{"title":"Agent signals","href":"/developers/agent-signals"},{"title":"Session storage","href":"/developers/plugins/session-store"},{"title":"Logging","href":"/developers/plugins/logging"},{"title":"Chat commands","href":"/developers/plugins/register-command"},{"title":"Web search providers","href":"/developers/plugins/web-search-provider"},{"title":"Session analytics","href":"/developers/plugins/session-analytics"},{"title":"Cognitive Substrate Backbone","sidebarTitle":"Backbone message bus","href":"/developers/plugins/backbone"},{"title":"Agent-turn runner","href":"/developers/plugins/agent-turn-runner"},{"title":null,"href":"/developers/plugins/session-consumer-claims"},{"title":"Chunk delivery","href":"/developers/plugins/chunk-delivery"},{"title":"Plugin Media Understanding Providers","href":"/developers/plugins/media-understanding-providers"},{"title":"Auto-reply pipeline","href":"/developers/auto-reply"},{"title":"Context engine","href":"/developers/context-engine"},{"title":"Deep observability runtime metrics","sidebarTitle":"Runtime metrics","href":"/developers/deep-observability"},{"title":"Exec and plugin tools","sidebarTitle":"Exec","href":"/developers/exec"},{"title":"Config writes","sidebarTitle":"Config writes","href":"/developers/config-writes"},{"title":"Redis session cache","href":"/developers/redis-session-cache"},{"title":"Realtime voice API","sidebarTitle":"Realtime voice API","href":"/developers/realtime-voice-api"},{"title":"Learning Core internals","sidebarTitle":"Learning Core","href":"/developers/learning"},{"title":"Product naming","href":"/developers/product-naming"}]},{"group":"Channel references","icon":"messages-square","pages":[{"title":"WhatsApp channel — developer reference","href":"/developers/channels/whatsapp"},{"title":"Telegram channel — developer reference","href":"/developers/channels/telegram"}]},{"group":"SDK reference","icon":"boxes","pages":[{"title":"Plugin SDK","href":"/developers/sdk/index"}]},{"group":"Contributing","icon":"git-pull-request","pages":[{"title":"Contributing","href":"/developers/contributing"},{"title":"Coding style","href":"/developers/contributing/coding-style"},{"title":"Testing policy","href":"/developers/contributing/testing"},{"title":"Secure development","href":"/developers/contributing/secure-development"},{"title":"Measuring performance","href":"/developers/contributing/performance"},{"title":"Documentation","href":"/developers/contributing/documentation"},{"title":"Release Checklist","href":"/developers/contributing/release"}]},{"group":"Core concepts (developer)","pages":[{"title":"Agent Runtime","href":"/developers/concepts/agent"},{"title":"Agent Loop","href":"/developers/concepts/agent-loop"},{"title":"Agent Workspace","href":"/developers/concepts/agent-workspace"},{"title":"Gateway Architecture","href":"/developers/concepts/architecture"},{"title":"Compaction","href":"/developers/concepts/compaction"},{"title":"Context","href":"/developers/concepts/context"},{"title":"Features","href":"/developers/concepts/features"},{"title":"Markdown Formatting","href":"/developers/concepts/markdown-formatting"},{"title":"Memory","href":"/developers/concepts/memory"},{"title":"Messages","href":"/developers/concepts/messages"},{"title":"Model Failover","href":"/developers/concepts/model-failover"},{"title":"Model Providers","href":"/developers/concepts/model-providers"},{"title":"Models CLI","href":"/developers/concepts/models"},{"title":"Multi-Agent Routing","href":"/developers/concepts/multi-agent"},{"title":"OAuth","href":"/developers/concepts/oauth"},{"title":"Command Queue","href":"/developers/concepts/queue"},{"title":"Retry Policy","href":"/developers/concepts/retry"},{"title":"Session Management","href":"/developers/concepts/session"},{"title":"Session Analytics — Economics, Turns, and FTS","href":"/developers/concepts/session-analytics"},{"title":"Session History Hygiene — Clean Replay and Turn Provenance","href":"/developers/concepts/session-history-hygiene"},{"title":"Session Journal","href":"/developers/concepts/session-journal"},{"title":"Session Pruning","href":"/developers/concepts/session-pruning"},{"title":"Session Tools","href":"/developers/concepts/session-tool"},{"title":"Streaming and Chunking","href":"/developers/concepts/streaming"},{"title":"Timezones","href":"/developers/concepts/timezone"},{"title":"TypeBox","href":"/developers/concepts/typebox"},{"title":"Typing Indicators","href":"/developers/concepts/typing-indicators"},{"title":"Usage Tracking","href":"/developers/concepts/usage-tracking"},{"title":"Workspace Lanes","href":"/developers/concepts/workspace-lanes"}]},{"group":"More plugins","pages":[{"title":"Community plugins","href":"/developers/plugins/community"},{"title":"Learning Core","href":"/developers/plugins/learning-core"},{"title":"OpenProse","href":"/developers/plugins/open-prose"},{"title":"Phone Control","href":"/developers/plugins/phone-control"},{"title":"Thread Ownership","href":"/developers/plugins/thread-ownership"},{"title":"Voice Call plugin","href":"/developers/plugins/voice-call"},{"title":"Zalo Personal Plugin","href":"/developers/plugins/zalouser"}]},{"group":"Developer reference","pages":[{"title":"Default AGENTS.md","href":"/developers/reference/AGENTS.default"},{"title":"API Usage and Costs","href":"/developers/reference/api-usage-costs"},{"title":"Device Model Database","href":"/developers/reference/device-models"},{"title":"Prompt Caching","href":"/developers/reference/prompt-caching"},{"title":"RPC Adapters","href":"/developers/reference/rpc"},{"title":"SecretRef Credential Surface","href":"/developers/reference/secretref-credential-surface"},{"title":"Session Management Deep Dive","href":"/developers/reference/session-management-compaction"},{"title":"Tests","href":"/developers/reference/test"},{"title":"Trusted npm publishing for contributors","href":"/developers/reference/trusted-npm-publishing-developer"},{"title":"Token Use and Costs","href":"/developers/reference/token-use"},{"title":"Transcript Hygiene","href":"/developers/reference/transcript-hygiene"},{"title":"Onboarding Wizard Reference","sidebarTitle":"Wizard Reference","href":"/developers/reference/wizard"},{"title":"Brand tokens","href":"/developers/reference/brand-tokens"},{"title":"Web client components","href":"/developers/reference/web-client-components"}]},{"group":"Prompt templates","pages":[{"title":"AGENTS.md Template","href":"/developers/reference/templates/AGENTS"},{"title":null,"href":"/developers/reference/templates/AGENTS.dev"},{"title":"BOOT.md Template","href":"/developers/reference/templates/BOOT"},{"title":"BOOTSTRAP.md Template","href":"/developers/reference/templates/BOOTSTRAP"},{"title":"HEARTBEAT.md Template","href":"/developers/reference/templates/HEARTBEAT"},{"title":null,"href":"/developers/reference/templates/IDENTITY"},{"title":null,"href":"/developers/reference/templates/IDENTITY.dev"},{"title":"SOUL.md Template","href":"/developers/reference/templates/SOUL"},{"title":null,"href":"/developers/reference/templates/SOUL.dev"},{"title":"TOOLS.md Template","href":"/developers/reference/templates/TOOLS"},{"title":null,"href":"/developers/reference/templates/TOOLS.dev"},{"title":null,"href":"/developers/reference/templates/USER"},{"title":null,"href":"/developers/reference/templates/USER.dev"}]},{"group":"Shohin","pages":[{"title":"Shohin developer notes","href":"/developers/shohin"}]}]},{"tab":"Reference","icon":"book-open","pages":[{"title":"Reference","href":"/reference/config"}]}]},{"version":"next","tag":"Unreleased","pages":[{"title":"next","href":"/next/developers/plugins/publishing"}]}]},"basePath":"","title":"Publishing a plugin - WednesdayAI","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["10e4515597"],"chunks":["BannerMarkdown-DnSAhvaM.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}