import path from "node:path";

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

import { formatErrorMessage } from "../../infra/errors.js";

import { extractErrorCode, formatErrorMessage } from "../../infra/errors.js";

import { isPathInside } from "../../infra/path-guards.js";

import { createSubsystemLogger } from "../../logging/subsystem.js";

import type {

}

}

// Walk the `.cause` chain looking for a Node-style "module not found" code.

// Native-require failures inside `module-loader.ts` rewrap the original Node

// error in a new Error with `{ cause }`, so the missing-module code lives on

// the cause rather than the top-level error.

function findMissingModuleCodeInChain(error: unknown): string | undefined {

const seen = new Set<unknown>();

let current: unknown = error;

while (current && !seen.has(current)) {

seen.add(current);

const code = extractErrorCode(current);

if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") {

return code;

}

if (typeof current !== "object") {

return undefined;

}

current = (current as { cause?: unknown }).cause;

}

return undefined;

}

export function describeBundledChannelLoadError(error: unknown, channelId: string): string {

const detail = formatErrorMessage(error);

if (findMissingModuleCodeInChain(error) !== undefined) {

return `${detail} (run \`openclaw doctor --fix\` to install missing bundled runtime dependencies for channel ${channelId})`;

}

return detail;

}

function loadGeneratedBundledChannelEntry(params: {

rootScope: BundledChannelRootScope;

metadata: BundledChannelPluginMetadata;

entry,

};

} catch (error) {

const detail = formatErrorMessage(error);

const detail = describeBundledChannelLoadError(error, params.metadata.manifest.id);

log.warn(`[channels] failed to load bundled channel ${params.metadata.manifest.id}: ${detail}`);

return null;

}

}

return setupEntry;

} catch (error) {

const detail = formatErrorMessage(error);

const detail = describeBundledChannelLoadError(error, params.metadata.manifest.id);

log.warn(

`[channels] failed to load bundled channel setup entry ${params.metadata.manifest.id}: ${detail}`,

);

loadContext.lazyPluginsById.set(id, normalizedPlugin);

return normalizedPlugin;

} catch (error) {

const detail = formatErrorMessage(error);

const detail = describeBundledChannelLoadError(error, id);

log.warn(`[channels] failed to load bundled channel ${id}: ${detail}`);

loadContext.lazyPluginsById.set(id, null);

return undefined;

loadContext.lazySecretsById.set(id, secrets ?? null);

return secrets;

} catch (error) {

const detail = formatErrorMessage(error);

const detail = describeBundledChannelLoadError(error, id);

log.warn(`[channels] failed to load bundled channel secrets ${id}: ${detail}`);

loadContext.lazySecretsById.set(id, null);

return undefined;

loadContext.lazyAccountInspectorsById.set(id, inspector);

return inspector;

} catch (error) {

const detail = formatErrorMessage(error);

const detail = describeBundledChannelLoadError(error, id);

log.warn(`[channels] failed to load bundled channel account inspector ${id}: ${detail}`);

loadContext.lazyAccountInspectorsById.set(id, null);

return undefined;

loadContext.lazySetupPluginsById.set(id, plugin);

return plugin;

} catch (error) {

const detail = formatErrorMessage(error);

const detail = describeBundledChannelLoadError(error, id);

log.warn(`[channels] failed to load bundled channel setup ${id}: ${detail}`);

loadContext.lazySetupPluginsById.set(id, null);

return undefined;

loadContext.lazySetupSecretsById.set(id, secrets ?? null);

return secrets;

} catch (error) {

const detail = formatErrorMessage(error);

const detail = describeBundledChannelLoadError(error, id);

log.warn(`[channels] failed to load bundled channel setup secrets ${id}: ${detail}`);

loadContext.lazySetupSecretsById.set(id, null);

return undefined;