- CLI/doctor: seed Control UI allowed origins when migrating legacy non-loopback gateway bind host aliases like `0.0.0.0`. Fixes #83286. Thanks @giodl73-repo.

- CLI/plugins: ship the bundled memory CLI as a package entry so package-installed `openclaw memory` commands register correctly.

- CLI/update: defer doctor-time plugin package installs during package swaps and seed post-core repair from the updated install registry, preventing duplicate reinstall failures.

- CLI/update: preserve old-parent-readable config metadata during legacy package handoffs, fall back to npm when ClawHub package artifacts are unavailable, and keep managed service package roots authoritative during updates.

- CLI/update: preserve old-parent-readable config metadata during legacy package handoffs, fall back only to official `@openclaw/*` npm plugin packages when ClawHub plugin artifacts are unavailable, and keep managed service package roots authoritative during updates.

- Feishu: detect SecretRef top-level credentials as a configured default account instead of treating object-backed app secrets as missing.

- Gateway/restart: keep ordinary unmanaged SIGUSR1/config restarts in-process instead of detach-spawning an orphaned child, preserving custom supervisor PID tracking while leaving update restarts on the fresh-process path. Fixes #65668.

- CLI/completion: resolve concrete PowerShell profile paths and reload commands during setup and doctor completion installation. Fixes #44296. (#83059) Thanks @yu-xin-c.

expect(result.warnings).toStrictEqual([]);

});

it("does not fall back from ClawHub to non-OpenClaw npm packages", async () => {

mocks.installPluginFromClawHub.mockResolvedValueOnce({

ok: false,

code: "artifact_download_unavailable",

error: "ClawHub artifact download is not available yet.",

});

mocks.listChannelPluginCatalogEntries.mockReturnValue([

{

id: "matrix",

pluginId: "matrix",

meta: { label: "Matrix" },

install: {

clawhubSpec: "clawhub:@openclaw/plugin-matrix@stable",

npmSpec: "@someone-else/plugin-matrix@1.2.3",

},

},

]);

const { repairMissingPluginInstallsForIds } =

await import("./missing-configured-plugin-install.js");

const result = await repairMissingPluginInstallsForIds({

cfg: {},

pluginIds: [],

channelIds: ["matrix"],

env: {},

});

expect(mocks.installPluginFromNpmSpec).not.toHaveBeenCalled();

expect(result.changes).toStrictEqual([]);

expect(result.warnings).toEqual([

'Failed to install missing configured plugin "matrix" from clawhub:@openclaw/plugin-matrix@stable: ClawHub artifact download is not available yet.',

]);

});

it("honors npm-first catalog metadata for missing OpenClaw channel plugins", async () => {

mocks.installPluginFromNpmSpec.mockResolvedValueOnce({

ok: true,

import type { OpenClawConfig } from "../../../config/types.openclaw.js";

import type { PluginInstallRecord } from "../../../config/types.plugins.js";

import { parseClawHubPluginSpec } from "../../../infra/clawhub-spec.js";

import { parseRegistryNpmSpec } from "../../../infra/npm-registry-spec.js";

import { isOpenClawOrgNpmSpec, parseRegistryNpmSpec } from "../../../infra/npm-registry-spec.js";

import {

normalizeUpdateChannel,

resolveRegistryUpdateChannel,

"requires compiled runtime output",

] as const;

function shouldFallbackClawHubToNpm(result: { ok: false; code?: string }): boolean {

function shouldFallbackClawHubToNpm(params: {

result: { ok: false; code?: string };

npmSpec?: string;

}): boolean {

if (!isOpenClawOrgNpmSpec(params.npmSpec)) {

return false;

}

return (

result.code === CLAWHUB_INSTALL_ERROR_CODE.PACKAGE_NOT_FOUND ||

result.code === CLAWHUB_INSTALL_ERROR_CODE.VERSION_NOT_FOUND ||

result.code === CLAWHUB_INSTALL_ERROR_CODE.ARTIFACT_DOWNLOAD_UNAVAILABLE

params.result.code === CLAWHUB_INSTALL_ERROR_CODE.PACKAGE_NOT_FOUND ||

params.result.code === CLAWHUB_INSTALL_ERROR_CODE.VERSION_NOT_FOUND ||

params.result.code === CLAWHUB_INSTALL_ERROR_CODE.ARTIFACT_DOWNLOAD_UNAVAILABLE

);

}

warnings: [],

};

}

if (!npmInstallSpec || !shouldFallbackClawHubToNpm(clawhubResult)) {

if (

!npmInstallSpec ||

!shouldFallbackClawHubToNpm({ result: clawhubResult, npmSpec: npmInstallSpec })

) {

return {

records: params.records,

changes: [],

compareOpenClawReleaseVersions,

formatPrereleaseResolutionError,

isExactSemverVersion,

isOpenClawOrgNpmSpec,

isOpenClawStableCorrectionVersion,

isPrereleaseSemverVersion,

isPrereleaseResolutionAllowed,

expect(parseRegistryNpmSpec(spec)).toEqual(expected);

});

it.each([

{ spec: "@openclaw/voice-call", expected: true },

{ spec: "@openclaw/voice-call@1.2.3", expected: true },

{ spec: "@other/voice-call", expected: false },

{ spec: "voice-call", expected: false },

{ spec: "npm:@openclaw/voice-call", expected: false },

{ spec: undefined, expected: false },

])("detects OpenClaw-org npm specs for %s", ({ spec, expected }) => {

expect(isOpenClawOrgNpmSpec(spec)).toBe(expected);

});

it.each([

{ value: "v1.2.3", expected: true },

{ value: "1.2", expected: false },

return parsed.ok ? parsed.parsed : null;

}

export function isOpenClawOrgNpmSpec(rawSpec: string | undefined): boolean {

const parsed = rawSpec ? parseRegistryNpmSpec(rawSpec) : null;

return parsed?.name.startsWith("@openclaw/") === true;

}

export function validateRegistryNpmSpec(rawSpec: string): string | null {

const parsed = parseRegistryNpmSpecInternal(rawSpec);

return parsed.ok ? null : parsed.error;

});

});

it("does not fall back from ClawHub to non-OpenClaw npm packages", async () => {

resolveBundledPluginSourcesMock.mockReturnValue(new Map());

installPluginFromClawHubMock.mockResolvedValue({

ok: false,

code: "package_not_found",

error: "Package not found on ClawHub.",

});

const config: OpenClawConfig = {

channels: {

"legacy-chat": {

enabled: true,

},

},

plugins: {

load: { paths: [appBundledPluginRoot("legacy-chat")] },

installs: {

"legacy-chat": {

source: "path",

sourcePath: appBundledPluginRoot("legacy-chat"),

installPath: appBundledPluginRoot("legacy-chat"),

},

},

},

};

const result = await syncPluginsForUpdateChannel({

channel: "stable",

externalizedBundledPluginBridges: [

{

bundledPluginId: "legacy-chat",

preferredSource: "clawhub",

clawhubSpec: "clawhub:legacy-chat@2026.5.1-beta.2",

npmSpec: "@someone-else/legacy-chat",

channelIds: ["legacy-chat"],

},

],

config,

});

expect(installPluginFromNpmSpecMock).not.toHaveBeenCalled();

expect(result.changed).toBe(false);

expect(result.config).toBe(config);

expect(result.summary.switchedToNpm).toStrictEqual([]);

expect(result.summary.warnings).toStrictEqual([]);

expect(result.summary.errors).toEqual([

"Failed to update legacy-chat: Package not found on ClawHub. (ClawHub clawhub:legacy-chat@2026.5.1-beta.2).",

]);

});

it("marks official externalized ClawHub-to-npm fallbacks as trusted", async () => {

resolveBundledPluginSourcesMock.mockReturnValue(new Map());

installPluginFromClawHubMock.mockResolvedValue({

import { resolveNpmSpecMetadata } from "../infra/install-source-utils.js";

import {

compareOpenClawReleaseVersions,

isOpenClawOrgNpmSpec,

isPrereleaseResolutionAllowed,

parseRegistryNpmSpec,

} from "../infra/npm-registry-spec.js";

return false;

}

function shouldFallbackClawHubBridgeToNpm(result: { ok: false; code?: string }): boolean {

function shouldFallbackClawHubBridgeToNpm(params: {

result: { ok: false; code?: string };

npmSpec?: string;

}): boolean {

if (!isOpenClawOrgNpmSpec(params.npmSpec)) {

return false;

}

return (

result.code === CLAWHUB_INSTALL_ERROR_CODE.PACKAGE_NOT_FOUND ||

result.code === CLAWHUB_INSTALL_ERROR_CODE.VERSION_NOT_FOUND

params.result.code === CLAWHUB_INSTALL_ERROR_CODE.PACKAGE_NOT_FOUND ||

params.result.code === CLAWHUB_INSTALL_ERROR_CODE.VERSION_NOT_FOUND

);

}

function shouldFallbackBetaClawHubUpdate(result: { ok: false; code?: string }): boolean {

return shouldFallbackClawHubBridgeToNpm(result);

return (

result.code === CLAWHUB_INSTALL_ERROR_CODE.PACKAGE_NOT_FOUND ||

result.code === CLAWHUB_INSTALL_ERROR_CODE.VERSION_NOT_FOUND

);

}

function describeBetaNpmFallback(params: {

expectedPluginId: targetPluginId,

logger,

});

if (!result.ok && npmSpec && shouldFallbackClawHubBridgeToNpm(result)) {

if (!result.ok && npmSpec && shouldFallbackClawHubBridgeToNpm({ result, npmSpec })) {

const warning = `ClawHub ${clawhubSpec} unavailable for ${targetPluginId}; falling back to npm ${npmSpec}.`;

summary.warnings.push(warning);

logger.warn?.(warning);