nextclaw 0.4.9 → 0.4.11

package/dist/cli/index.js

@@ -2,7 +2,7 @@
 
 // src/cli/index.ts
 import { Command } from "commander";
-import { APP_NAME as APP_NAME2, APP_TAGLINE } from "nextclaw-core";
+import { APP_NAME as APP_NAME2, APP_TAGLINE } from "@nextclaw/core";
 
 // src/cli/runtime.ts
 import {
@@ -30,8 +30,26 @@ import {
   APP_NAME,
   DEFAULT_WORKSPACE_DIR,
   DEFAULT_WORKSPACE_PATH
-} from "nextclaw-core";
-import { startUiServer } from "nextclaw-server";
+} from "@nextclaw/core";
+import {
+  loadOpenClawPlugins,
+  buildPluginStatusReport,
+  enablePluginInConfig,
+  disablePluginInConfig,
+  addPluginLoadPath,
+  recordPluginInstall,
+  installPluginFromPath,
+  installPluginFromNpmSpec,
+  uninstallPlugin,
+  resolveUninstallDirectoryTarget,
+  setPluginRuntimeBridge,
+  getPluginChannelBindings,
+  getPluginUiMetadataFromRegistry,
+  resolvePluginChannelMessageToolHints,
+  startPluginChannelGateways,
+  stopPluginChannelGateways
+} from "@nextclaw/openclaw-compat";
+import { startUiServer } from "@nextclaw/server";
 import {
   closeSync,
   cpSync,
@@ -57,7 +75,7 @@ import {
   buildConfigSchema,
   ConfigSchema,
   redactConfigObject
-} from "nextclaw-core";
+} from "@nextclaw/core";
 
 // src/cli/utils.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from "fs";
@@ -65,7 +83,7 @@ import { join, resolve } from "path";
 import { spawn } from "child_process";
 import { createServer } from "net";
 import { fileURLToPath } from "url";
-import { getDataDir, getPackageVersion } from "nextclaw-core";
+import { getDataDir, getPackageVersion } from "@nextclaw/core";
 function resolveUiConfig(config, overrides) {
   const base = config.ui ?? { enabled: false, host: "127.0.0.1", port: 18791, open: false };
   return { ...base, ...overrides ?? {} };
@@ -331,7 +349,7 @@ function runSelfUpdate(options = {}) {
 
 // src/cli/gateway/controller.ts
 var hashRaw = (raw) => createHash("sha256").update(raw).digest("hex");
-var readConfigSnapshot = (getConfigPath2) => {
+var readConfigSnapshot = (getConfigPath2, plugins2) => {
   const path = getConfigPath2();
   let raw = "";
   let parsed = {};
@@ -355,12 +373,12 @@ var readConfigSnapshot = (getConfigPath2) => {
     raw = JSON.stringify(config, null, 2);
   }
   const hash = hashRaw(raw);
-  const schema = buildConfigSchema({ version: getPackageVersion() });
+  const schema = buildConfigSchema({ version: getPackageVersion(), plugins: plugins2 });
   const redacted = redactConfigObject(config, schema.uiHints);
   return { raw: valid ? JSON.stringify(redacted, null, 2) : null, hash: valid ? hash : null, config, redacted, valid };
 };
-var redactValue = (value) => {
-  const schema = buildConfigSchema({ version: getPackageVersion() });
+var redactValue = (value, plugins2) => {
+  const schema = buildConfigSchema({ version: getPackageVersion(), plugins: plugins2 });
   return redactConfigObject(value, schema.uiHints);
 };
 var mergeDeep = (base, patch) => {
@@ -405,7 +423,8 @@ var GatewayControllerImpl = class {
     return "Restart scheduled";
   }
   async getConfig() {
-    const snapshot = readConfigSnapshot(this.deps.getConfigPath);
+    const plugins2 = this.deps.getPluginUiMetadata?.() ?? [];
+    const snapshot = readConfigSnapshot(this.deps.getConfigPath, plugins2);
     return {
       raw: snapshot.raw,
       hash: snapshot.hash,
@@ -417,10 +436,11 @@ var GatewayControllerImpl = class {
     };
   }
   async getConfigSchema() {
-    return buildConfigSchema({ version: getPackageVersion() });
+    return buildConfigSchema({ version: getPackageVersion(), plugins: this.deps.getPluginUiMetadata?.() ?? [] });
   }
   async applyConfig(params) {
-    const snapshot = readConfigSnapshot(this.deps.getConfigPath);
+    const plugins2 = this.deps.getPluginUiMetadata?.() ?? [];
+    const snapshot = readConfigSnapshot(this.deps.getConfigPath, plugins2);
     if (!params.baseHash) {
       return { ok: false, error: "config base hash required; re-run config.get and retry" };
     }
@@ -449,12 +469,13 @@ var GatewayControllerImpl = class {
       ok: true,
       note: params.note ?? null,
       path: this.deps.getConfigPath(),
-      config: redactValue(validated),
+      config: redactValue(validated, plugins2),
       restart: { scheduled: true, delayMs }
     };
   }
   async patchConfig(params) {
-    const snapshot = readConfigSnapshot(this.deps.getConfigPath);
+    const plugins2 = this.deps.getPluginUiMetadata?.() ?? [];
+    const snapshot = readConfigSnapshot(this.deps.getConfigPath, plugins2);
     if (!params.baseHash) {
       return { ok: false, error: "config base hash required; re-run config.get and retry" };
     }
@@ -484,7 +505,7 @@ var GatewayControllerImpl = class {
       ok: true,
       note: params.note ?? null,
       path: this.deps.getConfigPath(),
-      config: redactValue(validated),
+      config: redactValue(validated, plugins2),
       restart: { scheduled: true, delayMs }
     };
   }
@@ -653,7 +674,12 @@ var ConfigReloader = class {
     }
     this.reloadTask = (async () => {
       await this.channels.stopAll();
-      this.channels = new ChannelManager(nextConfig, this.options.bus, this.options.sessionManager);
+      this.channels = new ChannelManager(
+        nextConfig,
+        this.options.bus,
+        this.options.sessionManager,
+        this.options.getExtensionChannels?.() ?? []
+      );
       await this.channels.startAll();
     })();
     try {
@@ -851,17 +877,29 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
   }
   async agent(opts) {
     const config = loadConfig();
+    const workspace = getWorkspacePath(config.agents.defaults.workspace);
+    const pluginRegistry = this.loadPluginRegistry(config, workspace);
+    const extensionRegistry = this.toExtensionRegistry(pluginRegistry);
+    this.logPluginDiagnostics(pluginRegistry);
     const bus = new MessageBus();
     const provider = this.makeProvider(config);
     const providerManager = new ProviderManager(provider);
     const agentLoop = new AgentLoop({
       bus,
       providerManager,
-      workspace: getWorkspacePath(config.agents.defaults.workspace),
+      workspace,
       braveApiKey: config.tools.web.search.apiKey || void 0,
       execConfig: config.tools.exec,
       restrictToWorkspace: config.tools.restrictToWorkspace,
-      contextConfig: config.agents.context
+      contextConfig: config.agents.context,
+      config,
+      extensionRegistry,
+      resolveMessageToolHints: ({ channel, accountId }) => resolvePluginChannelMessageToolHints({
+        registry: pluginRegistry,
+        channel,
+        cfg: loadConfig(),
+        accountId
+      })
     });
     if (opts.message) {
       const response = await agentLoop.processDirect({
@@ -939,6 +977,356 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       console.log(`Tip: restart ${APP_NAME} to apply the update.`);
     }
   }
+  pluginsList(opts = {}) {
+    const config = loadConfig();
+    const workspaceDir = getWorkspacePath(config.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config.channels),
+      reservedProviderIds: PROVIDERS.map((provider) => provider.name)
+    });
+    const list = opts.enabled ? report.plugins.filter((plugin) => plugin.status === "loaded") : report.plugins;
+    if (opts.json) {
+      console.log(
+        JSON.stringify(
+          {
+            workspaceDir,
+            plugins: list,
+            diagnostics: report.diagnostics
+          },
+          null,
+          2
+        )
+      );
+      return;
+    }
+    if (list.length === 0) {
+      console.log("No plugins discovered.");
+      return;
+    }
+    for (const plugin of list) {
+      const status = plugin.status === "loaded" ? "loaded" : plugin.status === "disabled" ? "disabled" : "error";
+      const title = plugin.name && plugin.name !== plugin.id ? `${plugin.name} (${plugin.id})` : plugin.id;
+      if (!opts.verbose) {
+        const desc = plugin.description ? plugin.description.length > 80 ? `${plugin.description.slice(0, 77)}...` : plugin.description : "(no description)";
+        console.log(`${title} ${status} - ${desc}`);
+        continue;
+      }
+      console.log(`${title} ${status}`);
+      console.log(`  source: ${plugin.source}`);
+      console.log(`  origin: ${plugin.origin}`);
+      if (plugin.version) {
+        console.log(`  version: ${plugin.version}`);
+      }
+      if (plugin.toolNames.length > 0) {
+        console.log(`  tools: ${plugin.toolNames.join(", ")}`);
+      }
+      if (plugin.channelIds.length > 0) {
+        console.log(`  channels: ${plugin.channelIds.join(", ")}`);
+      }
+      if (plugin.providerIds.length > 0) {
+        console.log(`  providers: ${plugin.providerIds.join(", ")}`);
+      }
+      if (plugin.error) {
+        console.log(`  error: ${plugin.error}`);
+      }
+      console.log("");
+    }
+  }
+  pluginsInfo(id, opts = {}) {
+    const config = loadConfig();
+    const workspaceDir = getWorkspacePath(config.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config.channels),
+      reservedProviderIds: PROVIDERS.map((provider) => provider.name)
+    });
+    const plugin = report.plugins.find((entry) => entry.id === id || entry.name === id);
+    if (!plugin) {
+      console.error(`Plugin not found: ${id}`);
+      process.exit(1);
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(plugin, null, 2));
+      return;
+    }
+    const install = config.plugins.installs?.[plugin.id];
+    const lines = [];
+    lines.push(plugin.name || plugin.id);
+    if (plugin.name && plugin.name !== plugin.id) {
+      lines.push(`id: ${plugin.id}`);
+    }
+    if (plugin.description) {
+      lines.push(plugin.description);
+    }
+    lines.push("");
+    lines.push(`Status: ${plugin.status}`);
+    lines.push(`Source: ${plugin.source}`);
+    lines.push(`Origin: ${plugin.origin}`);
+    if (plugin.version) {
+      lines.push(`Version: ${plugin.version}`);
+    }
+    if (plugin.toolNames.length > 0) {
+      lines.push(`Tools: ${plugin.toolNames.join(", ")}`);
+    }
+    if (plugin.channelIds.length > 0) {
+      lines.push(`Channels: ${plugin.channelIds.join(", ")}`);
+    }
+    if (plugin.providerIds.length > 0) {
+      lines.push(`Providers: ${plugin.providerIds.join(", ")}`);
+    }
+    if (plugin.error) {
+      lines.push(`Error: ${plugin.error}`);
+    }
+    if (install) {
+      lines.push("");
+      lines.push(`Install: ${install.source}`);
+      if (install.spec) {
+        lines.push(`Spec: ${install.spec}`);
+      }
+      if (install.sourcePath) {
+        lines.push(`Source path: ${install.sourcePath}`);
+      }
+      if (install.installPath) {
+        lines.push(`Install path: ${install.installPath}`);
+      }
+      if (install.version) {
+        lines.push(`Recorded version: ${install.version}`);
+      }
+      if (install.installedAt) {
+        lines.push(`Installed at: ${install.installedAt}`);
+      }
+    }
+    console.log(lines.join("\n"));
+  }
+  pluginsEnable(id) {
+    const config = loadConfig();
+    const next = enablePluginInConfig(config, id);
+    saveConfig(next);
+    console.log(`Enabled plugin "${id}". Restart the gateway to apply.`);
+  }
+  pluginsDisable(id) {
+    const config = loadConfig();
+    const next = disablePluginInConfig(config, id);
+    saveConfig(next);
+    console.log(`Disabled plugin "${id}". Restart the gateway to apply.`);
+  }
+  async pluginsUninstall(id, opts = {}) {
+    const config = loadConfig();
+    const workspaceDir = getWorkspacePath(config.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config.channels),
+      reservedProviderIds: PROVIDERS.map((provider) => provider.name)
+    });
+    const keepFiles = Boolean(opts.keepFiles || opts.keepConfig);
+    if (opts.keepConfig) {
+      console.log("`--keep-config` is deprecated, use `--keep-files`.");
+    }
+    const plugin = report.plugins.find((entry) => entry.id === id || entry.name === id);
+    const pluginId = plugin?.id ?? id;
+    const hasEntry = pluginId in (config.plugins.entries ?? {});
+    const hasInstall = pluginId in (config.plugins.installs ?? {});
+    if (!hasEntry && !hasInstall) {
+      if (plugin) {
+        console.error(
+          `Plugin "${pluginId}" is not managed by plugins config/install records and cannot be uninstalled.`
+        );
+      } else {
+        console.error(`Plugin not found: ${id}`);
+      }
+      process.exit(1);
+    }
+    const install = config.plugins.installs?.[pluginId];
+    const isLinked = install?.source === "path";
+    const preview = [];
+    if (hasEntry) {
+      preview.push("config entry");
+    }
+    if (hasInstall) {
+      preview.push("install record");
+    }
+    if (config.plugins.allow?.includes(pluginId)) {
+      preview.push("allowlist entry");
+    }
+    if (isLinked && install?.sourcePath && config.plugins.load?.paths?.includes(install.sourcePath)) {
+      preview.push("load path");
+    }
+    const deleteTarget = !keepFiles ? resolveUninstallDirectoryTarget({
+      pluginId,
+      hasInstall,
+      installRecord: install
+    }) : null;
+    if (deleteTarget) {
+      preview.push(`directory: ${deleteTarget}`);
+    }
+    const pluginName = plugin?.name || pluginId;
+    const pluginTitle = pluginName !== pluginId ? `${pluginName} (${pluginId})` : pluginName;
+    console.log(`Plugin: ${pluginTitle}`);
+    console.log(`Will remove: ${preview.length > 0 ? preview.join(", ") : "(nothing)"}`);
+    if (opts.dryRun) {
+      console.log("Dry run, no changes made.");
+      return;
+    }
+    if (!opts.force) {
+      const confirmed = await this.confirmYesNo(`Uninstall plugin "${pluginId}"?`);
+      if (!confirmed) {
+        console.log("Cancelled.");
+        return;
+      }
+    }
+    const result = await uninstallPlugin({
+      config,
+      pluginId,
+      deleteFiles: !keepFiles
+    });
+    if (!result.ok) {
+      console.error(result.error);
+      process.exit(1);
+    }
+    for (const warning of result.warnings) {
+      console.warn(warning);
+    }
+    saveConfig(result.config);
+    const removed = [];
+    if (result.actions.entry) {
+      removed.push("config entry");
+    }
+    if (result.actions.install) {
+      removed.push("install record");
+    }
+    if (result.actions.allowlist) {
+      removed.push("allowlist");
+    }
+    if (result.actions.loadPath) {
+      removed.push("load path");
+    }
+    if (result.actions.directory) {
+      removed.push("directory");
+    }
+    console.log(`Uninstalled plugin "${pluginId}". Removed: ${removed.length > 0 ? removed.join(", ") : "nothing"}.`);
+    console.log("Restart the gateway to apply changes.");
+  }
+  async pluginsInstall(pathOrSpec, opts = {}) {
+    const fileSpec = this.resolveFileNpmSpecToLocalPath(pathOrSpec);
+    if (fileSpec && !fileSpec.ok) {
+      console.error(fileSpec.error);
+      process.exit(1);
+    }
+    const normalized = fileSpec && fileSpec.ok ? fileSpec.path : pathOrSpec;
+    const resolved = resolve4(expandHome(normalized));
+    const config = loadConfig();
+    if (existsSync4(resolved)) {
+      if (opts.link) {
+        const probe = await installPluginFromPath({ path: resolved, dryRun: true });
+        if (!probe.ok) {
+          console.error(probe.error);
+          process.exit(1);
+        }
+        let next3 = addPluginLoadPath(config, resolved);
+        next3 = enablePluginInConfig(next3, probe.pluginId);
+        next3 = recordPluginInstall(next3, {
+          pluginId: probe.pluginId,
+          source: "path",
+          sourcePath: resolved,
+          installPath: resolved,
+          version: probe.version
+        });
+        saveConfig(next3);
+        console.log(`Linked plugin path: ${resolved}`);
+        console.log("Restart the gateway to load plugins.");
+        return;
+      }
+      const result2 = await installPluginFromPath({
+        path: resolved,
+        logger: {
+          info: (message) => console.log(message),
+          warn: (message) => console.warn(message)
+        }
+      });
+      if (!result2.ok) {
+        console.error(result2.error);
+        process.exit(1);
+      }
+      let next2 = enablePluginInConfig(config, result2.pluginId);
+      next2 = recordPluginInstall(next2, {
+        pluginId: result2.pluginId,
+        source: this.isArchivePath(resolved) ? "archive" : "path",
+        sourcePath: resolved,
+        installPath: result2.targetDir,
+        version: result2.version
+      });
+      saveConfig(next2);
+      console.log(`Installed plugin: ${result2.pluginId}`);
+      console.log("Restart the gateway to load plugins.");
+      return;
+    }
+    if (opts.link) {
+      console.error("`--link` requires a local path.");
+      process.exit(1);
+    }
+    if (this.looksLikePath(pathOrSpec)) {
+      console.error(`Path not found: ${resolved}`);
+      process.exit(1);
+    }
+    const result = await installPluginFromNpmSpec({
+      spec: pathOrSpec,
+      logger: {
+        info: (message) => console.log(message),
+        warn: (message) => console.warn(message)
+      }
+    });
+    if (!result.ok) {
+      console.error(result.error);
+      process.exit(1);
+    }
+    let next = enablePluginInConfig(config, result.pluginId);
+    next = recordPluginInstall(next, {
+      pluginId: result.pluginId,
+      source: "npm",
+      spec: pathOrSpec,
+      installPath: result.targetDir,
+      version: result.version
+    });
+    saveConfig(next);
+    console.log(`Installed plugin: ${result.pluginId}`);
+    console.log("Restart the gateway to load plugins.");
+  }
+  pluginsDoctor() {
+    const config = loadConfig();
+    const workspaceDir = getWorkspacePath(config.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config.channels),
+      reservedProviderIds: PROVIDERS.map((provider) => provider.name)
+    });
+    const pluginErrors = report.plugins.filter((plugin) => plugin.status === "error");
+    const diagnostics = report.diagnostics.filter((diag) => diag.level === "error");
+    if (pluginErrors.length === 0 && diagnostics.length === 0) {
+      console.log("No plugin issues detected.");
+      return;
+    }
+    if (pluginErrors.length > 0) {
+      console.log("Plugin errors:");
+      for (const entry of pluginErrors) {
+        console.log(`- ${entry.id}: ${entry.error ?? "failed to load"} (${entry.source})`);
+      }
+    }
+    if (diagnostics.length > 0) {
+      if (pluginErrors.length > 0) {
+        console.log("");
+      }
+      console.log("Diagnostics:");
+      for (const diag of diagnostics) {
+        const prefix = diag.pluginId ? `${diag.pluginId}: ` : "";
+        console.log(`- ${prefix}${diag.message}`);
+      }
+    }
+  }
   async skillsInstall(options) {
     const workdir = options.workdir ? expandHome(options.workdir) : getWorkspacePath();
     const result = await installClawHubSkill({
@@ -970,6 +1358,21 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     console.log(`Telegram: ${config.channels.telegram.enabled ? "\u2713" : "\u2717"}`);
     console.log(`Slack: ${config.channels.slack.enabled ? "\u2713" : "\u2717"}`);
     console.log(`QQ: ${config.channels.qq.enabled ? "\u2713" : "\u2717"}`);
+    const workspaceDir = getWorkspacePath(config.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config.channels),
+      reservedProviderIds: PROVIDERS.map((provider) => provider.name)
+    });
+    const pluginChannels = report.plugins.filter((plugin) => plugin.status === "loaded" && plugin.channelIds.length > 0);
+    if (pluginChannels.length > 0) {
+      console.log("Plugin Channels:");
+      for (const plugin of pluginChannels) {
+        const channels2 = plugin.channelIds.join(", ");
+        console.log(`- ${channels2} (plugin: ${plugin.id})`);
+      }
+    }
   }
   channelsLogin() {
     const bridgeDir = this.getBridgeDir();
@@ -980,6 +1383,95 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       console.error(`Bridge failed: ${result.status ?? 1}`);
     }
   }
+  channelsAdd(opts) {
+    const channelId = opts.channel?.trim();
+    if (!channelId) {
+      console.error("--channel is required");
+      process.exit(1);
+    }
+    const config = loadConfig();
+    const workspaceDir = getWorkspacePath(config.agents.defaults.workspace);
+    const pluginRegistry = this.loadPluginRegistry(config, workspaceDir);
+    const bindings = getPluginChannelBindings(pluginRegistry);
+    const binding = bindings.find((entry) => entry.channelId === channelId || entry.pluginId === channelId);
+    if (!binding) {
+      console.error(`No plugin channel found for: ${channelId}`);
+      process.exit(1);
+    }
+    const setup = binding.channel.setup;
+    if (!setup?.applyAccountConfig) {
+      console.error(`Channel "${binding.channelId}" does not support setup.`);
+      process.exit(1);
+    }
+    const input = {
+      name: opts.name,
+      token: opts.token,
+      code: opts.code,
+      url: opts.url,
+      httpUrl: opts.httpUrl
+    };
+    const currentView = this.toPluginConfigView(config, bindings);
+    const accountId = binding.channel.config?.defaultAccountId?.(currentView) ?? "default";
+    const validateError = setup.validateInput?.({
+      cfg: currentView,
+      input,
+      accountId
+    });
+    if (validateError) {
+      console.error(`Channel setup validation failed: ${validateError}`);
+      process.exit(1);
+    }
+    const nextView = setup.applyAccountConfig({
+      cfg: currentView,
+      input,
+      accountId
+    });
+    if (!nextView || typeof nextView !== "object" || Array.isArray(nextView)) {
+      console.error("Channel setup returned invalid config payload.");
+      process.exit(1);
+    }
+    let next = this.mergePluginConfigView(config, nextView, bindings);
+    next = enablePluginInConfig(next, binding.pluginId);
+    saveConfig(next);
+    console.log(`Configured channel "${binding.channelId}" via plugin "${binding.pluginId}".`);
+    console.log("Restart the gateway to apply changes.");
+  }
+  toPluginConfigView(config, bindings) {
+    const view = JSON.parse(JSON.stringify(config));
+    const channels2 = view.channels && typeof view.channels === "object" && !Array.isArray(view.channels) ? { ...view.channels } : {};
+    for (const binding of bindings) {
+      const pluginConfig = config.plugins.entries?.[binding.pluginId]?.config;
+      if (!pluginConfig || typeof pluginConfig !== "object" || Array.isArray(pluginConfig)) {
+        continue;
+      }
+      channels2[binding.channelId] = JSON.parse(JSON.stringify(pluginConfig));
+    }
+    view.channels = channels2;
+    return view;
+  }
+  mergePluginConfigView(baseConfig, pluginViewConfig, bindings) {
+    const next = JSON.parse(JSON.stringify(baseConfig));
+    const pluginChannels = pluginViewConfig.channels && typeof pluginViewConfig.channels === "object" && !Array.isArray(pluginViewConfig.channels) ? pluginViewConfig.channels : {};
+    const entries = { ...next.plugins.entries ?? {} };
+    for (const binding of bindings) {
+      if (!Object.prototype.hasOwnProperty.call(pluginChannels, binding.channelId)) {
+        continue;
+      }
+      const channelConfig = pluginChannels[binding.channelId];
+      if (!channelConfig || typeof channelConfig !== "object" || Array.isArray(channelConfig)) {
+        continue;
+      }
+      entries[binding.pluginId] = {
+        ...entries[binding.pluginId] ?? {},
+        config: channelConfig
+      };
+    }
+    next.plugins = {
+      ...next.plugins,
+      entries
+    };
+    return next;
+  }
   cronList(opts) {
     const storePath = join3(getDataDir2(), "cron", "jobs.json");
     const service = new CronService(storePath);
@@ -1071,14 +1563,85 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       }
     }
   }
+  loadPluginRegistry(config, workspaceDir) {
+    return loadOpenClawPlugins({
+      config,
+      workspaceDir,
+      reservedToolNames: [
+        "read_file",
+        "write_file",
+        "edit_file",
+        "list_dir",
+        "exec",
+        "web_search",
+        "web_fetch",
+        "message",
+        "spawn",
+        "sessions_list",
+        "sessions_history",
+        "sessions_send",
+        "memory_search",
+        "memory_get",
+        "subagents",
+        "gateway",
+        "cron"
+      ],
+      reservedChannelIds: Object.keys(config.channels),
+      reservedProviderIds: PROVIDERS.map((provider) => provider.name),
+      logger: {
+        info: (message) => console.log(message),
+        warn: (message) => console.warn(message),
+        error: (message) => console.error(message),
+        debug: (message) => console.debug(message)
+      }
+    });
+  }
+  toExtensionRegistry(pluginRegistry) {
+    return {
+      tools: pluginRegistry.tools.map((tool) => ({
+        extensionId: tool.pluginId,
+        factory: tool.factory,
+        names: tool.names,
+        optional: tool.optional,
+        source: tool.source
+      })),
+      channels: pluginRegistry.channels.map((channel) => ({
+        extensionId: channel.pluginId,
+        channel: channel.channel,
+        source: channel.source
+      })),
+      diagnostics: pluginRegistry.diagnostics.map((diag) => ({
+        level: diag.level,
+        message: diag.message,
+        extensionId: diag.pluginId,
+        source: diag.source
+      }))
+    };
+  }
+  logPluginDiagnostics(registry) {
+    for (const diag of registry.diagnostics) {
+      const prefix = diag.pluginId ? `${diag.pluginId}: ` : "";
+      const text = `${prefix}${diag.message}`;
+      if (diag.level === "error") {
+        console.error(`[plugins] ${text}`);
+      } else {
+        console.warn(`[plugins] ${text}`);
+      }
+    }
+  }
   async startGateway(options = {}) {
     const config = loadConfig();
+    const workspace = getWorkspacePath(config.agents.defaults.workspace);
+    const pluginRegistry = this.loadPluginRegistry(config, workspace);
+    const extensionRegistry = this.toExtensionRegistry(pluginRegistry);
+    this.logPluginDiagnostics(pluginRegistry);
     const bus = new MessageBus();
     const provider = options.allowMissingProvider === true ? this.makeProvider(config, { allowMissing: true }) : this.makeProvider(config);
     const providerManager = provider ? new ProviderManager(provider) : null;
-    const sessionManager = new SessionManager(getWorkspacePath(config.agents.defaults.workspace));
+    const sessionManager = new SessionManager(workspace);
     const cronStorePath = join3(getDataDir2(), "cron", "jobs.json");
     const cron2 = new CronService(cronStorePath);
+    const pluginUiMetadata = getPluginUiMetadataFromRegistry(pluginRegistry);
     const uiConfig = resolveUiConfig(config, options.uiOverrides);
     const uiStaticDir = options.uiStaticDir === void 0 ? resolveUiStaticDir() : options.uiStaticDir;
     if (!provider) {
@@ -1088,7 +1651,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       });
       return;
     }
-    const channels2 = new ChannelManager(config, bus, sessionManager);
+    const channels2 = new ChannelManager(config, bus, sessionManager, extensionRegistry.channels);
     const reloader = new ConfigReloader({
       initialConfig: config,
       channels: channels2,
@@ -1097,6 +1660,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       providerManager,
       makeProvider: (nextConfig) => this.makeProvider(nextConfig, { allowMissing: true }),
       loadConfig,
+      getExtensionChannels: () => extensionRegistry.channels,
       onRestartRequired: (paths) => {
         console.warn(`Config changes require restart: ${paths.join(", ")}`);
       }
@@ -1105,12 +1669,13 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       reloader,
       cron: cron2,
       getConfigPath,
-      saveConfig
+      saveConfig,
+      getPluginUiMetadata: () => pluginUiMetadata
     });
     const agent = new AgentLoop({
       bus,
       providerManager: providerManager ?? new ProviderManager(provider),
-      workspace: getWorkspacePath(config.agents.defaults.workspace),
+      workspace,
       model: config.agents.defaults.model,
       maxIterations: config.agents.defaults.maxToolIterations,
       braveApiKey: config.tools.web.search.apiKey || void 0,
@@ -1119,7 +1684,54 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       restrictToWorkspace: config.tools.restrictToWorkspace,
       sessionManager,
       contextConfig: config.agents.context,
-      gatewayController
+      gatewayController,
+      config,
+      extensionRegistry,
+      resolveMessageToolHints: ({ channel, accountId }) => resolvePluginChannelMessageToolHints({
+        registry: pluginRegistry,
+        channel,
+        cfg: loadConfig(),
+        accountId
+      })
+    });
+    const pluginChannelBindings = getPluginChannelBindings(pluginRegistry);
+    setPluginRuntimeBridge({
+      loadConfig: () => this.toPluginConfigView(loadConfig(), pluginChannelBindings),
+      writeConfigFile: async (nextConfigView) => {
+        if (!nextConfigView || typeof nextConfigView !== "object" || Array.isArray(nextConfigView)) {
+          throw new Error("plugin runtime writeConfigFile expects an object config");
+        }
+        const current = loadConfig();
+        const next = this.mergePluginConfigView(current, nextConfigView, pluginChannelBindings);
+        saveConfig(next);
+      },
+      dispatchReplyWithBufferedBlockDispatcher: async ({ ctx, dispatcherOptions }) => {
+        const bodyForAgent = typeof ctx.BodyForAgent === "string" ? ctx.BodyForAgent : "";
+        const body = typeof ctx.Body === "string" ? ctx.Body : "";
+        const content = (bodyForAgent || body).trim();
+        if (!content) {
+          return;
+        }
+        const sessionKey = typeof ctx.SessionKey === "string" && ctx.SessionKey.trim().length > 0 ? ctx.SessionKey : `plugin:${typeof ctx.OriginatingChannel === "string" ? ctx.OriginatingChannel : "channel"}:${typeof ctx.SenderId === "string" ? ctx.SenderId : "unknown"}`;
+        const channel = typeof ctx.OriginatingChannel === "string" && ctx.OriginatingChannel.trim().length > 0 ? ctx.OriginatingChannel : "cli";
+        const chatId = typeof ctx.OriginatingTo === "string" && ctx.OriginatingTo.trim().length > 0 ? ctx.OriginatingTo : typeof ctx.SenderId === "string" && ctx.SenderId.trim().length > 0 ? ctx.SenderId : "direct";
+        try {
+          const response = await agent.processDirect({
+            content,
+            sessionKey,
+            channel,
+            chatId,
+            metadata: typeof ctx.AccountId === "string" && ctx.AccountId.trim().length > 0 ? { account_id: ctx.AccountId } : {}
+          });
+          const replyText = typeof response === "string" ? response : String(response ?? "");
+          if (replyText.trim()) {
+            await dispatcherOptions.deliver({ text: replyText }, { kind: "final" });
+          }
+        } catch (error) {
+          dispatcherOptions.onError?.(error);
+          throw error;
+        }
+      }
     });
     cron2.onJob = async (job) => {
       const response = await agent.processDirect({
@@ -1140,7 +1752,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       return response;
     };
     const heartbeat = new HeartbeatService(
-      getWorkspacePath(config.agents.defaults.workspace),
+      workspace,
       async (promptText) => agent.processDirect({ content: promptText, sessionKey: "heartbeat" }),
       30 * 60,
       true
@@ -1166,7 +1778,32 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     watcher.on("unlink", () => reloader.scheduleReload("config unlink"));
     await cron2.start();
     await heartbeat.start();
-    await Promise.allSettled([agent.run(), reloader.getChannels().startAll()]);
+    let pluginGatewayHandles = [];
+    try {
+      const startedPluginGateways = await startPluginChannelGateways({
+        registry: pluginRegistry,
+        logger: {
+          info: (message) => console.log(`[plugins] ${message}`),
+          warn: (message) => console.warn(`[plugins] ${message}`),
+          error: (message) => console.error(`[plugins] ${message}`),
+          debug: (message) => console.debug(`[plugins] ${message}`)
+        }
+      });
+      pluginGatewayHandles = startedPluginGateways.handles;
+      for (const diag of startedPluginGateways.diagnostics) {
+        const prefix = diag.pluginId ? `${diag.pluginId}: ` : "";
+        const text = `${prefix}${diag.message}`;
+        if (diag.level === "error") {
+          console.error(`[plugins] ${text}`);
+        } else {
+          console.warn(`[plugins] ${text}`);
+        }
+      }
+      await Promise.allSettled([agent.run(), reloader.getChannels().startAll()]);
+    } finally {
+      await stopPluginChannelGateways(pluginGatewayHandles);
+      setPluginRuntimeBridge(null);
+    }
   }
   startUiIfEnabled(uiConfig, uiStaticDir) {
     if (!uiConfig.enabled) {
@@ -1310,6 +1947,18 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
     clearServiceState();
     console.log(`\u2713 ${APP_NAME} stopped`);
   }
+  async confirmYesNo(question) {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    const answer = await new Promise((resolve5) => {
+      rl.question(`${question} [y/N] `, (line) => resolve5(line));
+    });
+    rl.close();
+    const normalized = answer.trim().toLowerCase();
+    return normalized === "y" || normalized === "yes";
+  }
   makeProvider(config, options) {
     const provider = getProvider(config);
     const model = config.agents.defaults.model;
@@ -1330,6 +1979,36 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
       wireApi: provider?.wireApi ?? null
     });
   }
+  resolveFileNpmSpecToLocalPath(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed.toLowerCase().startsWith("file:")) {
+      return null;
+    }
+    const rest = trimmed.slice("file:".length);
+    if (!rest) {
+      return { ok: false, error: "unsupported file: spec: missing path" };
+    }
+    if (rest.startsWith("///")) {
+      return { ok: true, path: rest.slice(2) };
+    }
+    if (rest.startsWith("//localhost/")) {
+      return { ok: true, path: rest.slice("//localhost".length) };
+    }
+    if (rest.startsWith("//")) {
+      return {
+        ok: false,
+        error: 'unsupported file: URL host (expected "file:<path>" or "file:///abs/path")'
+      };
+    }
+    return { ok: true, path: rest };
+  }
+  looksLikePath(raw) {
+    return raw.startsWith(".") || raw.startsWith("~") || raw.startsWith("/") || raw.endsWith(".ts") || raw.endsWith(".js") || raw.endsWith(".mjs") || raw.endsWith(".cjs") || raw.endsWith(".tgz") || raw.endsWith(".tar.gz") || raw.endsWith(".tar") || raw.endsWith(".zip");
+  }
+  isArchivePath(filePath) {
+    const lower = filePath.toLowerCase();
+    return lower.endsWith(".zip") || lower.endsWith(".tgz") || lower.endsWith(".tar.gz") || lower.endsWith(".tar");
+  }
   createWorkspaceTemplates(workspace, options = {}) {
     const created = [];
     const force = Boolean(options.force);
@@ -1413,7 +2092,7 @@ ${this.logo} ${APP_NAME} is ready! (${source})`);
   resolveBuiltinSkillsDir() {
     try {
       const require2 = createRequire(import.meta.url);
-      const entry = require2.resolve("nextclaw-core");
+      const entry = require2.resolve("@nextclaw/core");
       const pkgRoot = resolve4(dirname(entry), "..");
       const distSkills = join3(pkgRoot, "dist", "skills");
       if (existsSync4(distSkills)) {
@@ -1516,7 +2195,16 @@ var skills = program.command("skills").description("Manage skills");
 registerClawHubInstall(skills);
 var clawhub = program.command("clawhub").description("Install skills from ClawHub");
 registerClawHubInstall(clawhub);
+var plugins = program.command("plugins").description("Manage OpenClaw-compatible plugins");
+plugins.command("list").description("List discovered plugins").option("--json", "Print JSON").option("--enabled", "Only show enabled plugins", false).option("--verbose", "Show detailed entries", false).action((opts) => runtime.pluginsList(opts));
+plugins.command("info <id>").description("Show plugin details").option("--json", "Print JSON").action((id, opts) => runtime.pluginsInfo(id, opts));
+plugins.command("enable <id>").description("Enable a plugin in config").action((id) => runtime.pluginsEnable(id));
+plugins.command("disable <id>").description("Disable a plugin in config").action((id) => runtime.pluginsDisable(id));
+plugins.command("uninstall <id>").description("Uninstall a plugin").option("--keep-files", "Keep installed files on disk", false).option("--keep-config", "Deprecated alias for --keep-files", false).option("--force", "Skip confirmation prompt", false).option("--dry-run", "Show what would be removed without making changes", false).action(async (id, opts) => runtime.pluginsUninstall(id, opts));
+plugins.command("install <path-or-spec>").description("Install a plugin (path, archive, or npm spec)").option("-l, --link", "Link a local path instead of copying", false).action(async (pathOrSpec, opts) => runtime.pluginsInstall(pathOrSpec, opts));
+plugins.command("doctor").description("Report plugin load issues").action(() => runtime.pluginsDoctor());
 var channels = program.command("channels").description("Manage channels");
+channels.command("add").description("Configure a plugin channel (OpenClaw-compatible setup)").requiredOption("--channel <id>", "Plugin channel id").option("--code <code>", "Pairing code").option("--token <token>", "Connector token").option("--name <name>", "Display name").option("--url <url>", "API base URL").option("--http-url <url>", "Alias for --url").action((opts) => runtime.channelsAdd(opts));
 channels.command("status").description("Show channel status").action(() => runtime.channelsStatus());
 channels.command("login").description("Link device via QR code").action(() => runtime.channelsLogin());
 var cron = program.command("cron").description("Manage scheduled tasks");

package/dist/index.d.ts

@@ -1 +1 @@
-export * from 'nextclaw-core';
+export * from '@nextclaw/core';

package/dist/index.js

@@ -1,2 +1,2 @@
 // src/index.ts
-export * from "nextclaw-core";
+export * from "@nextclaw/core";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",
@@ -38,8 +38,9 @@
   "dependencies": {
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
-    "nextclaw-core": "^0.4.7",
-    "nextclaw-server": "^0.3.3"
+    "@nextclaw/core": "^0.4.9",
+    "@nextclaw/server": "^0.3.5",
+    "@nextclaw/openclaw-compat": "^0.1.2"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",
@@ -55,8 +56,8 @@
   },
   "scripts": {
     "dev": "tsx watch --tsconfig tsconfig.json src/cli/index.ts",
-    "dev:build": "pnpm -C ../nextclaw-core build && pnpm -C ../nextclaw-server build && tsx src/cli/index.ts",
-    "build": "pnpm -C ../nextclaw-core build && pnpm -C ../nextclaw-server build && tsup src/index.ts src/cli/index.ts --format esm --dts --out-dir dist && node scripts/copy-ui-dist.mjs",
+    "dev:build": "pnpm -C ../nextclaw-core build && pnpm -C ../nextclaw-openclaw-compat build && pnpm -C ../nextclaw-server build && tsx src/cli/index.ts",
+    "build": "pnpm -C ../nextclaw-core build && pnpm -C ../nextclaw-openclaw-compat build && pnpm -C ../nextclaw-server build && tsup src/index.ts src/cli/index.ts --format esm --dts --out-dir dist && node scripts/copy-ui-dist.mjs",
     "start": "node dist/cli.js",
     "lint": "eslint .",
     "tsc": "tsc -p tsconfig.json",