echo "publish_openclaw_npm=true requires dispatching this workflow from main, release/YYYY.M.D, or a Tideclaw alpha branch for alpha prereleases." >&2

exit 1

fi

if [[ "${PUBLISH_OPENCLAW_NPM}" == "true" && "${PLUGIN_PUBLISH_SCOPE}" != "all-publishable" ]]; then

echo "publish_openclaw_npm=true requires plugin_publish_scope=all-publishable so every publishable official plugin is released with OpenClaw." >&2

exit 1

fi

if [[ "${PLUGIN_PUBLISH_SCOPE}" == "selected" && -z "${PLUGINS}" ]]; then

echo "plugin_publish_scope=selected requires plugins." >&2

exit 1

```

Use the lower-level `Plugin NPM Release` and `Plugin ClawHub Release` workflows

only for focused repair or republish work. For a selected plugin repair, pass

`plugin_publish_scope=selected` and `plugins=@openclaw/name` to

`OpenClaw Release Publish`, or dispatch the child workflow directly when the

OpenClaw package must not be published.

only for focused repair or republish work. `OpenClaw Release Publish` rejects

`plugin_publish_scope=selected` when `publish_openclaw_npm=true` so the core

package cannot ship without every publishable official plugin, including

`@openclaw/diffs-language-pack`. For a selected plugin repair, set

`publish_openclaw_npm=false` with `plugin_publish_scope=selected` and

`plugins=@openclaw/name`, or dispatch the child workflow directly.

## NPM workflow inputs

required when `publish_openclaw_npm=true`

- `npm_dist_tag`: npm target tag for the OpenClaw package

- `plugin_publish_scope`: defaults to `all-publishable`; use `selected` only

for focused repair work

for focused plugin-only repair work with `publish_openclaw_npm=false`

- `plugins`: comma-separated `@openclaw/*` package names when

`plugin_publish_scope=selected`

- `publish_openclaw_npm`: defaults to `true`; set `false` only when using the

if (options.pluginPublishScope === "selected" && !options.plugins.trim()) {

throw new Error("--plugin-publish-scope selected requires --plugins");

}

if (options.pluginPublishScope === "selected") {

throw new Error(

"--plugin-publish-scope selected is only for plugin-only repair publishes; release candidates publish OpenClaw with --plugin-publish-scope all-publishable",

);

}

if (options.pluginPublishScope === "all-publishable" && options.plugins.trim()) {

throw new Error("--plugins is only valid with --plugin-publish-scope selected");

}

expect(workflow).toContain(

"Full release validation must run rerun_group=all before npm publish",

);

expect(workflow).toContain(

"publish_openclaw_npm=true requires plugin_publish_scope=all-publishable",

);

expect(workflow).toContain("preflight-manifest.json");

expect(npmWorkflow).toContain("preflight-manifest.json");

expect(npmWorkflow).toContain("Verify full release validation run metadata");

).toThrow("--plugin-publish-scope selected requires --plugins");

});

it("rejects selected plugin publish scope for release candidates", () => {

expect(() =>

parseArgs([

"--tag",

"v2026.5.14-beta.3",

"--plugin-publish-scope",

"selected",

"--plugins",

"@openclaw/diffs",

]),

).toThrow("release candidates publish OpenClaw with --plugin-publish-scope all-publishable");

});

it("extracts a workflow run id from gh dispatch output", () => {

expect(

parseRunIdFromDispatchOutput(