nextclaw 0.6.1 → 0.6.3

package/dist/cli/index.js

@@ -6,13 +6,13 @@ import { APP_NAME as APP_NAME5, APP_TAGLINE } from "@nextclaw/core";
 
 // src/cli/runtime.ts
 import {
-  loadConfig as loadConfig5,
-  saveConfig as saveConfig3,
+  loadConfig as loadConfig6,
+  saveConfig as saveConfig5,
   getConfigPath as getConfigPath3,
   getDataDir as getDataDir6,
   ConfigSchema as ConfigSchema2,
-  getWorkspacePath as getWorkspacePath3,
-  expandHome,
+  getWorkspacePath as getWorkspacePath5,
+  expandHome as expandHome2,
   MessageBus as MessageBus2,
   AgentLoop as AgentLoop2,
   ProviderManager as ProviderManager2,
@@ -20,9 +20,10 @@ import {
   DEFAULT_WORKSPACE_DIR,
   DEFAULT_WORKSPACE_PATH
 } from "@nextclaw/core";
-import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "fs";
-import { join as join6, resolve as resolve7 } from "path";
-import { createInterface } from "readline";
+import { resolvePluginChannelMessageToolHints as resolvePluginChannelMessageToolHints2 } from "@nextclaw/openclaw-compat";
+import { existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "fs";
+import { join as join6, resolve as resolve8 } from "path";
+import { createInterface as createInterface2 } from "readline";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { spawn as spawn3 } from "child_process";
 
@@ -254,7 +255,7 @@ async function waitForExit(pid, timeoutMs) {
     if (!isProcessRunning(pid)) {
       return true;
     }
-    await new Promise((resolve8) => setTimeout(resolve8, 200));
+    await new Promise((resolve9) => setTimeout(resolve9, 200));
   }
   return !isProcessRunning(pid);
 }
@@ -344,8 +345,8 @@ function printAgentResponse(response) {
 async function prompt(rl, question) {
   rl.setPrompt(question);
   rl.prompt();
-  return new Promise((resolve8) => {
-    rl.once("line", (line) => resolve8(line));
+  return new Promise((resolve9) => {
+    rl.once("line", (line) => resolve9(line));
   });
 }
 
@@ -391,8 +392,549 @@ function runSelfUpdate(options = {}) {
   return { ok: false, error: "no update strategy available", strategy: "none", steps };
 }
 
+// src/cli/commands/plugins.ts
+import {
+  addPluginLoadPath,
+  buildPluginStatusReport,
+  disablePluginInConfig,
+  enablePluginInConfig,
+  installPluginFromNpmSpec,
+  installPluginFromPath,
+  loadOpenClawPlugins,
+  recordPluginInstall,
+  resolveUninstallDirectoryTarget,
+  uninstallPlugin
+} from "@nextclaw/openclaw-compat";
+import {
+  loadConfig,
+  saveConfig,
+  getWorkspacePath,
+  PROVIDERS,
+  expandHome
+} from "@nextclaw/core";
+import { createInterface } from "readline";
+import { existsSync as existsSync3 } from "fs";
+import { resolve as resolve4 } from "path";
+function loadPluginRegistry(config2, workspaceDir) {
+  return loadOpenClawPlugins({
+    config: config2,
+    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(config2.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)
+    }
+  });
+}
+function 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
+    }))
+  };
+}
+function 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}`);
+    }
+  }
+}
+function toPluginConfigView(config2, bindings) {
+  const view = JSON.parse(JSON.stringify(config2));
+  const channels2 = view.channels && typeof view.channels === "object" && !Array.isArray(view.channels) ? { ...view.channels } : {};
+  for (const binding of bindings) {
+    const pluginConfig = config2.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;
+}
+function 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;
+}
+var PluginCommands = class {
+  constructor(deps) {
+    this.deps = deps;
+  }
+  pluginsList(opts = {}) {
+    const config2 = loadConfig();
+    const workspaceDir = getWorkspacePath(config2.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config: config2,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config2.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 config2 = loadConfig();
+    const workspaceDir = getWorkspacePath(config2.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config: config2,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config2.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 = config2.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"));
+  }
+  async pluginsEnable(id) {
+    const config2 = loadConfig();
+    const next = enablePluginInConfig(config2, id);
+    saveConfig(next);
+    await this.deps.requestRestart({
+      reason: `plugin enabled: ${id}`,
+      manualMessage: `Enabled plugin "${id}". Restart the gateway to apply.`
+    });
+  }
+  async pluginsDisable(id) {
+    const config2 = loadConfig();
+    const next = disablePluginInConfig(config2, id);
+    saveConfig(next);
+    await this.deps.requestRestart({
+      reason: `plugin disabled: ${id}`,
+      manualMessage: `Disabled plugin "${id}". Restart the gateway to apply.`
+    });
+  }
+  async pluginsUninstall(id, opts = {}) {
+    const config2 = loadConfig();
+    const workspaceDir = getWorkspacePath(config2.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config: config2,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config2.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 (config2.plugins.entries ?? {});
+    const hasInstall = pluginId in (config2.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 = config2.plugins.installs?.[pluginId];
+    const isLinked = install?.source === "path" && (!install.installPath || !install.sourcePath || resolve4(install.installPath) === resolve4(install.sourcePath));
+    const preview = [];
+    if (hasEntry) {
+      preview.push("config entry");
+    }
+    if (hasInstall) {
+      preview.push("install record");
+    }
+    if (config2.plugins.allow?.includes(pluginId)) {
+      preview.push("allowlist entry");
+    }
+    if (isLinked && install?.sourcePath && config2.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: config2,
+      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"}.`);
+    await this.deps.requestRestart({
+      reason: `plugin uninstalled: ${pluginId}`,
+      manualMessage: "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 config2 = loadConfig();
+    if (existsSync3(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(config2, 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}`);
+        await this.deps.requestRestart({
+          reason: `plugin linked: ${probe.pluginId}`,
+          manualMessage: "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(config2, 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}`);
+      await this.deps.requestRestart({
+        reason: `plugin installed: ${result2.pluginId}`,
+        manualMessage: "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(config2, 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}`);
+    await this.deps.requestRestart({
+      reason: `plugin installed: ${result.pluginId}`,
+      manualMessage: "Restart the gateway to load plugins."
+    });
+  }
+  pluginsDoctor() {
+    const config2 = loadConfig();
+    const workspaceDir = getWorkspacePath(config2.agents.defaults.workspace);
+    const report = buildPluginStatusReport({
+      config: config2,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config2.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 confirmYesNo(question) {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    const answer = await new Promise((resolve9) => {
+      rl.question(`${question} [y/N] `, (line) => resolve9(line));
+    });
+    rl.close();
+    const normalized = answer.trim().toLowerCase();
+    return normalized === "y" || normalized === "yes";
+  }
+  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");
+  }
+};
+
 // src/cli/commands/config.ts
-import { buildReloadPlan, diffConfigPaths, loadConfig, saveConfig } from "@nextclaw/core";
+import { buildReloadPlan, diffConfigPaths, loadConfig as loadConfig2, saveConfig as saveConfig2 } from "@nextclaw/core";
 
 // src/cli/config-path.ts
 function isIndexSegment(raw) {
@@ -587,7 +1129,7 @@ var ConfigCommands = class {
     this.deps = deps;
   }
   configGet(pathExpr, opts = {}) {
-    const config2 = loadConfig();
+    const config2 = loadConfig2();
     let parsedPath;
     try {
       parsedPath = parseRequiredConfigPath(pathExpr);
@@ -629,7 +1171,7 @@ var ConfigCommands = class {
       process.exit(1);
       return;
     }
-    const prevConfig = loadConfig();
+    const prevConfig = loadConfig2();
     const nextConfig = structuredClone(prevConfig);
     try {
       setAtConfigPath(nextConfig, parsedPath, parsedValue);
@@ -638,7 +1180,7 @@ var ConfigCommands = class {
       process.exit(1);
       return;
     }
-    saveConfig(nextConfig);
+    saveConfig2(nextConfig);
     await this.requestRestartForConfigDiff({
       prevConfig,
       nextConfig,
@@ -655,7 +1197,7 @@ var ConfigCommands = class {
       process.exit(1);
       return;
     }
-    const prevConfig = loadConfig();
+    const prevConfig = loadConfig2();
     const nextConfig = structuredClone(prevConfig);
     const removed = unsetAtConfigPath(nextConfig, parsedPath);
     if (!removed) {
@@ -663,7 +1205,7 @@ var ConfigCommands = class {
       process.exit(1);
       return;
     }
-    saveConfig(nextConfig);
+    saveConfig2(nextConfig);
     await this.requestRestartForConfigDiff({
       prevConfig,
       nextConfig,
@@ -689,13 +1231,14 @@ var ConfigCommands = class {
 
 // src/cli/commands/channels.ts
 import { spawnSync as spawnSync3 } from "child_process";
-import { loadConfig as loadConfig2 } from "@nextclaw/core";
+import { getWorkspacePath as getWorkspacePath2, loadConfig as loadConfig3, saveConfig as saveConfig3, PROVIDERS as PROVIDERS2 } from "@nextclaw/core";
+import { buildPluginStatusReport as buildPluginStatusReport2, enablePluginInConfig as enablePluginInConfig2, getPluginChannelBindings } from "@nextclaw/openclaw-compat";
 var ChannelCommands = class {
   constructor(deps) {
     this.deps = deps;
   }
   channelsStatus() {
-    const config2 = loadConfig2();
+    const config2 = loadConfig3();
     console.log("Channel Status");
     console.log(`WhatsApp: ${config2.channels.whatsapp.enabled ? "\u2713" : "\u2717"}`);
     console.log(`Discord: ${config2.channels.discord.enabled ? "\u2713" : "\u2717"}`);
@@ -704,6 +1247,21 @@ var ChannelCommands = class {
     console.log(`Telegram: ${config2.channels.telegram.enabled ? "\u2713" : "\u2717"}`);
     console.log(`Slack: ${config2.channels.slack.enabled ? "\u2713" : "\u2717"}`);
     console.log(`QQ: ${config2.channels.qq.enabled ? "\u2713" : "\u2717"}`);
+    const workspaceDir = getWorkspacePath2(config2.agents.defaults.workspace);
+    const report = buildPluginStatusReport2({
+      config: config2,
+      workspaceDir,
+      reservedChannelIds: Object.keys(config2.channels),
+      reservedProviderIds: PROVIDERS2.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.deps.getBridgeDir();
@@ -714,6 +1272,62 @@ var ChannelCommands = class {
       console.error(`Bridge failed: ${result.status ?? 1}`);
     }
   }
+  async channelsAdd(opts) {
+    const channelId = opts.channel?.trim();
+    if (!channelId) {
+      console.error("--channel is required");
+      process.exit(1);
+    }
+    const config2 = loadConfig3();
+    const workspaceDir = getWorkspacePath2(config2.agents.defaults.workspace);
+    const pluginRegistry = loadPluginRegistry(config2, 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 = toPluginConfigView(config2, 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 = mergePluginConfigView(config2, nextView, bindings);
+    next = enablePluginInConfig2(next, binding.pluginId);
+    saveConfig3(next);
+    console.log(`Configured channel "${binding.channelId}" via plugin "${binding.pluginId}".`);
+    await this.deps.requestRestart({
+      reason: `channel configured via plugin: ${binding.pluginId}`,
+      manualMessage: "Restart the gateway to apply changes."
+    });
+  }
 };
 
 // src/cli/commands/cron.ts
@@ -794,15 +1408,15 @@ var CronCommands = class {
 
 // src/cli/commands/diagnostics.ts
 import { createServer as createNetServer } from "net";
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
-import { resolve as resolve4 } from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync2 } from "fs";
+import { resolve as resolve5 } from "path";
 import {
   APP_NAME,
   getConfigPath,
   getDataDir as getDataDir3,
-  getWorkspacePath,
-  loadConfig as loadConfig3,
-  PROVIDERS
+  getWorkspacePath as getWorkspacePath3,
+  loadConfig as loadConfig4,
+  PROVIDERS as PROVIDERS3
 } from "@nextclaw/core";
 var DiagnosticsCommands = class {
   constructor(deps) {
@@ -963,9 +1577,9 @@ var DiagnosticsCommands = class {
   }
   async collectRuntimeStatus(params) {
     const configPath = getConfigPath();
-    const config2 = loadConfig3();
-    const workspacePath = getWorkspacePath(config2.agents.defaults.workspace);
-    const serviceStatePath = resolve4(getDataDir3(), "run", "service.json");
+    const config2 = loadConfig4();
+    const workspacePath = getWorkspacePath3(config2.agents.defaults.workspace);
+    const serviceStatePath = resolve5(getDataDir3(), "run", "service.json");
     const fixActions = [];
     let serviceState = readServiceState();
     if (params.fix && serviceState && !isProcessRunning(serviceState.pid)) {
@@ -984,7 +1598,7 @@ var DiagnosticsCommands = class {
     const managedHealth = running && managedApiUrl ? await this.probeApiHealth(`${managedApiUrl}/health`) : { state: "unreachable", detail: "service not running" };
     const configuredHealth = await this.probeApiHealth(`${configuredApiUrl}/health`, 900);
     const orphanSuspected = !running && configuredHealth.state === "ok";
-    const providers = PROVIDERS.map((spec) => {
+    const providers = PROVIDERS3.map((spec) => {
       const provider = config2.providers[spec.name];
       if (!provider) {
         return { name: spec.displayName ?? spec.name, configured: false, detail: "missing config" };
@@ -1004,11 +1618,11 @@ var DiagnosticsCommands = class {
     });
     const issues = [];
     const recommendations = [];
-    if (!existsSync3(configPath)) {
+    if (!existsSync4(configPath)) {
       issues.push("Config file is missing.");
       recommendations.push(`Run ${APP_NAME} init to create config files.`);
     }
-    if (!existsSync3(workspacePath)) {
+    if (!existsSync4(workspacePath)) {
       issues.push("Workspace directory does not exist.");
       recommendations.push(`Run ${APP_NAME} init to create workspace templates.`);
     }
@@ -1036,13 +1650,13 @@ var DiagnosticsCommands = class {
     return {
       generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
       configPath,
-      configExists: existsSync3(configPath),
+      configExists: existsSync4(configPath),
       workspacePath,
-      workspaceExists: existsSync3(workspacePath),
+      workspaceExists: existsSync4(workspacePath),
       model: config2.agents.defaults.model,
       providers,
       serviceStatePath,
-      serviceStateExists: existsSync3(serviceStatePath),
+      serviceStateExists: existsSync4(serviceStatePath),
       fixActions,
       process: {
         managedByState,
@@ -1092,7 +1706,7 @@ var DiagnosticsCommands = class {
     }
   }
   readLogTail(path, maxLines = 25) {
-    if (!existsSync3(path)) {
+    if (!existsSync4(path)) {
       return [];
     }
     try {
@@ -1106,17 +1720,17 @@ var DiagnosticsCommands = class {
     }
   }
   async checkPortAvailability(params) {
-    return await new Promise((resolve8) => {
+    return await new Promise((resolve9) => {
       const server = createNetServer();
       server.once("error", (error) => {
-        resolve8({
+        resolve9({
           available: false,
           detail: `bind failed on ${params.host}:${params.port} (${String(error)})`
         });
       });
       server.listen(params.port, params.host, () => {
         server.close(() => {
-          resolve8({
+          resolve9({
             available: true,
             detail: `bind ok on ${params.host}:${params.port}`
           });
@@ -1137,24 +1751,31 @@ import {
   getDataDir as getDataDir4,
   getProvider,
   getProviderName,
-  getWorkspacePath as getWorkspacePath2,
+  getWorkspacePath as getWorkspacePath4,
   HeartbeatService,
   LiteLLMProvider,
-  loadConfig as loadConfig4,
+  loadConfig as loadConfig5,
   MessageBus,
   ProviderManager,
-  saveConfig as saveConfig2,
+  saveConfig as saveConfig4,
   SessionManager
 } from "@nextclaw/core";
+import {
+  getPluginChannelBindings as getPluginChannelBindings2,
+  resolvePluginChannelMessageToolHints,
+  setPluginRuntimeBridge,
+  startPluginChannelGateways,
+  stopPluginChannelGateways
+} from "@nextclaw/openclaw-compat";
 import { startUiServer } from "@nextclaw/server";
 import { closeSync, mkdirSync as mkdirSync2, openSync } from "fs";
-import { join as join4, resolve as resolve5 } from "path";
+import { join as join4, resolve as resolve6 } from "path";
 import { spawn as spawn2 } from "child_process";
 import chokidar from "chokidar";
 
 // src/cli/gateway/controller.ts
 import { createHash } from "crypto";
-import { existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync3 } from "fs";
 import {
   buildConfigSchema,
   ConfigSchema,
@@ -1165,7 +1786,7 @@ var readConfigSnapshot = (getConfigPath4) => {
   const path = getConfigPath4();
   let raw = "";
   let parsed = {};
-  if (existsSync4(path)) {
+  if (existsSync5(path)) {
     raw = readFileSync3(path, "utf-8");
     try {
       parsed = JSON.parse(raw);
@@ -1491,8 +2112,11 @@ var ServiceCommands = class {
     this.deps = deps;
   }
   async startGateway(options = {}) {
-    const config2 = loadConfig4();
-    const workspace = getWorkspacePath2(config2.agents.defaults.workspace);
+    const config2 = loadConfig5();
+    const workspace = getWorkspacePath4(config2.agents.defaults.workspace);
+    const pluginRegistry = loadPluginRegistry(config2, workspace);
+    const extensionRegistry = toExtensionRegistry(pluginRegistry);
+    logPluginDiagnostics(pluginRegistry);
     const bus = new MessageBus();
     const provider = options.allowMissingProvider === true ? this.makeProvider(config2, { allowMissing: true }) : this.makeProvider(config2);
     const providerManager = new ProviderManager(provider ?? this.makeMissingProvider(config2));
@@ -1504,7 +2128,7 @@ var ServiceCommands = class {
     if (!provider) {
       console.warn("Warning: No API key configured. The gateway is running, but agent replies are disabled until provider config is set.");
     }
-    const channels2 = new ChannelManager2(config2, bus, sessionManager, []);
+    const channels2 = new ChannelManager2(config2, bus, sessionManager, extensionRegistry.channels);
     const reloader = new ConfigReloader({
       initialConfig: config2,
       channels: channels2,
@@ -1512,7 +2136,8 @@ var ServiceCommands = class {
       sessionManager,
       providerManager,
       makeProvider: (nextConfig) => this.makeProvider(nextConfig, { allowMissing: true }) ?? this.makeMissingProvider(nextConfig),
-      loadConfig: loadConfig4,
+      loadConfig: loadConfig5,
+      getExtensionChannels: () => extensionRegistry.channels,
       onRestartRequired: (paths) => {
         void this.deps.requestRestart({
           reason: `config reload requires restart: ${paths.join(", ")}`,
@@ -1525,7 +2150,7 @@ var ServiceCommands = class {
       reloader,
       cron: cron2,
       getConfigPath: getConfigPath2,
-      saveConfig: saveConfig2,
+      saveConfig: saveConfig4,
       requestRestart: async (options2) => {
         await this.deps.requestRestart({
           reason: options2?.reason ?? "gateway tool restart",
@@ -1551,9 +2176,55 @@ var ServiceCommands = class {
       sessionManager,
       contextConfig: config2.agents.context,
       gatewayController,
-      config: config2
+      config: config2,
+      extensionRegistry,
+      resolveMessageToolHints: ({ channel, accountId }) => resolvePluginChannelMessageToolHints({
+        registry: pluginRegistry,
+        channel,
+        cfg: loadConfig5(),
+        accountId
+      })
     });
     reloader.setApplyAgentRuntimeConfig((nextConfig) => agent.applyRuntimeConfig(nextConfig));
+    const pluginChannelBindings = getPluginChannelBindings2(pluginRegistry);
+    setPluginRuntimeBridge({
+      loadConfig: () => toPluginConfigView(loadConfig5(), pluginChannelBindings),
+      writeConfigFile: async (nextConfigView) => {
+        if (!nextConfigView || typeof nextConfigView !== "object" || Array.isArray(nextConfigView)) {
+          throw new Error("plugin runtime writeConfigFile expects an object config");
+        }
+        const current = loadConfig5();
+        const next = mergePluginConfigView(current, nextConfigView, pluginChannelBindings);
+        saveConfig4(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({
         content: job.payload.message,
@@ -1599,10 +2270,35 @@ var ServiceCommands = class {
     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);
+    }
   }
   async runForeground(options) {
-    const config2 = loadConfig4();
+    const config2 = loadConfig5();
     const uiConfig = resolveUiConfig(config2, options.uiOverrides);
     const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
     if (options.open) {
@@ -1615,7 +2311,7 @@ var ServiceCommands = class {
     });
   }
   async startService(options) {
-    const config2 = loadConfig4();
+    const config2 = loadConfig5();
     const uiConfig = resolveUiConfig(config2, options.uiOverrides);
     const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
     const apiUrl = `${uiUrl}/api`;
@@ -1664,7 +2360,7 @@ var ServiceCommands = class {
       console.log("Warning: UI frontend not found in package assets.");
     }
     const logPath = resolveServiceLogPath();
-    const logDir = resolve5(logPath, "..");
+    const logDir = resolve6(logPath, "..");
     mkdirSync2(logDir, { recursive: true });
     const logFd = openSync(logPath, "a");
     const serveArgs = buildServeArgs({
@@ -1759,22 +2455,22 @@ var ServiceCommands = class {
       try {
         const response = await fetch(params.healthUrl, { method: "GET" });
         if (!response.ok) {
-          await new Promise((resolve8) => setTimeout(resolve8, 200));
+          await new Promise((resolve9) => setTimeout(resolve9, 200));
           continue;
         }
         const payload = await response.json();
         const healthy = payload?.ok === true && payload?.data?.status === "ok";
         if (!healthy) {
-          await new Promise((resolve8) => setTimeout(resolve8, 200));
+          await new Promise((resolve9) => setTimeout(resolve9, 200));
           continue;
         }
-        await new Promise((resolve8) => setTimeout(resolve8, 300));
+        await new Promise((resolve9) => setTimeout(resolve9, 300));
         if (isProcessRunning(params.pid)) {
           return true;
         }
       } catch {
       }
-      await new Promise((resolve8) => setTimeout(resolve8, 200));
+      await new Promise((resolve9) => setTimeout(resolve9, 200));
     }
     return false;
   }
@@ -1847,9 +2543,9 @@ var ServiceCommands = class {
 };
 
 // src/cli/workspace.ts
-import { cpSync, existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync4, readdirSync, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
+import { cpSync, existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync4, readdirSync, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
 import { createRequire } from "module";
-import { dirname, join as join5, resolve as resolve6 } from "path";
+import { dirname, join as join5, resolve as resolve7 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { APP_NAME as APP_NAME3, getDataDir as getDataDir5 } from "@nextclaw/core";
 import { spawnSync as spawnSync4 } from "child_process";
@@ -1880,11 +2576,11 @@ var WorkspaceManager = class {
     ];
     for (const entry of templateFiles) {
       const filePath = join5(workspace, entry.target);
-      if (!force && existsSync5(filePath)) {
+      if (!force && existsSync6(filePath)) {
         continue;
       }
       const templatePath = join5(templateDir, entry.source);
-      if (!existsSync5(templatePath)) {
+      if (!existsSync6(templatePath)) {
         console.warn(`Warning: Template file missing: ${templatePath}`);
         continue;
       }
@@ -1895,12 +2591,12 @@ var WorkspaceManager = class {
       created.push(entry.target);
     }
     const memoryDir = join5(workspace, "memory");
-    if (!existsSync5(memoryDir)) {
+    if (!existsSync6(memoryDir)) {
       mkdirSync3(memoryDir, { recursive: true });
       created.push(join5("memory", ""));
     }
     const skillsDir = join5(workspace, "skills");
-    if (!existsSync5(skillsDir)) {
+    if (!existsSync6(skillsDir)) {
       mkdirSync3(skillsDir, { recursive: true });
       created.push(join5("skills", ""));
     }
@@ -1922,11 +2618,11 @@ var WorkspaceManager = class {
         continue;
       }
       const src = join5(sourceDir, entry.name);
-      if (!existsSync5(join5(src, "SKILL.md"))) {
+      if (!existsSync6(join5(src, "SKILL.md"))) {
         continue;
       }
       const dest = join5(targetDir, entry.name);
-      if (!force && existsSync5(dest)) {
+      if (!force && existsSync6(dest)) {
         continue;
       }
       cpSync(src, dest, { recursive: true, force: true });
@@ -1938,13 +2634,13 @@ var WorkspaceManager = class {
     try {
       const require2 = createRequire(import.meta.url);
       const entry = require2.resolve("@nextclaw/core");
-      const pkgRoot = resolve6(dirname(entry), "..");
+      const pkgRoot = resolve7(dirname(entry), "..");
       const distSkills = join5(pkgRoot, "dist", "skills");
-      if (existsSync5(distSkills)) {
+      if (existsSync6(distSkills)) {
         return distSkills;
       }
       const srcSkills = join5(pkgRoot, "src", "agent", "skills");
-      if (existsSync5(srcSkills)) {
+      if (existsSync6(srcSkills)) {
         return srcSkills;
       }
       return null;
@@ -1957,11 +2653,11 @@ var WorkspaceManager = class {
     if (override) {
       return override;
     }
-    const cliDir = resolve6(fileURLToPath2(new URL(".", import.meta.url)));
-    const pkgRoot = resolve6(cliDir, "..", "..");
+    const cliDir = resolve7(fileURLToPath2(new URL(".", import.meta.url)));
+    const pkgRoot = resolve7(cliDir, "..", "..");
     const candidates = [join5(pkgRoot, "templates")];
     for (const candidate of candidates) {
-      if (existsSync5(candidate)) {
+      if (existsSync6(candidate)) {
         return candidate;
       }
     }
@@ -1969,21 +2665,21 @@ var WorkspaceManager = class {
   }
   getBridgeDir() {
     const userBridge = join5(getDataDir5(), "bridge");
-    if (existsSync5(join5(userBridge, "dist", "index.js"))) {
+    if (existsSync6(join5(userBridge, "dist", "index.js"))) {
       return userBridge;
     }
     if (!which("npm")) {
       console.error("npm not found. Please install Node.js >= 18.");
       process.exit(1);
     }
-    const cliDir = resolve6(fileURLToPath2(new URL(".", import.meta.url)));
-    const pkgRoot = resolve6(cliDir, "..", "..");
+    const cliDir = resolve7(fileURLToPath2(new URL(".", import.meta.url)));
+    const pkgRoot = resolve7(cliDir, "..", "..");
     const pkgBridge = join5(pkgRoot, "bridge");
     const srcBridge = join5(pkgRoot, "..", "..", "bridge");
     let source = null;
-    if (existsSync5(join5(pkgBridge, "package.json"))) {
+    if (existsSync6(join5(pkgBridge, "package.json"))) {
       source = pkgBridge;
-    } else if (existsSync5(join5(srcBridge, "package.json"))) {
+    } else if (existsSync6(join5(srcBridge, "package.json"))) {
       source = srcBridge;
     }
     if (!source) {
@@ -1991,8 +2687,8 @@ var WorkspaceManager = class {
       process.exit(1);
     }
     console.log(`${this.logo} Setting up bridge...`);
-    mkdirSync3(resolve6(userBridge, ".."), { recursive: true });
-    if (existsSync5(userBridge)) {
+    mkdirSync3(resolve7(userBridge, ".."), { recursive: true });
+    if (existsSync6(userBridge)) {
       rmSync2(userBridge, { recursive: true, force: true });
     }
     cpSync(source, userBridge, {
@@ -2032,6 +2728,7 @@ var CliRuntime = class {
   workspaceManager;
   serviceCommands;
   configCommands;
+  pluginCommands;
   channelCommands;
   cronCommands;
   diagnosticsCommands;
@@ -2044,9 +2741,13 @@ var CliRuntime = class {
     this.configCommands = new ConfigCommands({
       requestRestart: (params) => this.requestRestart(params)
     });
+    this.pluginCommands = new PluginCommands({
+      requestRestart: (params) => this.requestRestart(params)
+    });
     this.channelCommands = new ChannelCommands({
       logo: this.logo,
-      getBridgeDir: () => this.workspaceManager.getBridgeDir()
+      getBridgeDir: () => this.workspaceManager.getBridgeDir(),
+      requestRestart: (params) => this.requestRestart(params)
     });
     this.cronCommands = new CronCommands();
     this.diagnosticsCommands = new DiagnosticsCommands({ logo: this.logo });
@@ -2112,7 +2813,7 @@ var CliRuntime = class {
     const delayMs = typeof params.delayMs === "number" && Number.isFinite(params.delayMs) ? Math.max(0, Math.floor(params.delayMs)) : 100;
     const cliPath = process.env.NEXTCLAW_SELF_RELAUNCH_CLI?.trim() || fileURLToPath3(new URL("./index.js", import.meta.url));
     const startArgs = [cliPath, "start", "--ui-port", String(uiPort)];
-    const serviceStatePath = resolve7(getDataDir6(), "run", "service.json");
+    const serviceStatePath = resolve8(getDataDir6(), "run", "service.json");
     const helperScript = [
       'const { spawnSync } = require("node:child_process");',
       'const { readFileSync } = require("node:fs");',
@@ -2217,15 +2918,15 @@ var CliRuntime = class {
     const force = Boolean(options.force);
     const configPath = getConfigPath3();
     let createdConfig = false;
-    if (!existsSync6(configPath)) {
+    if (!existsSync7(configPath)) {
       const config3 = ConfigSchema2.parse({});
-      saveConfig3(config3);
+      saveConfig5(config3);
       createdConfig = true;
     }
-    const config2 = loadConfig5();
+    const config2 = loadConfig6();
     const workspaceSetting = config2.agents.defaults.workspace;
-    const workspacePath = !workspaceSetting || workspaceSetting === DEFAULT_WORKSPACE_PATH ? join6(getDataDir6(), DEFAULT_WORKSPACE_DIR) : expandHome(workspaceSetting);
-    const workspaceExisted = existsSync6(workspacePath);
+    const workspacePath = !workspaceSetting || workspaceSetting === DEFAULT_WORKSPACE_PATH ? join6(getDataDir6(), DEFAULT_WORKSPACE_DIR) : expandHome2(workspaceSetting);
+    const workspaceExisted = existsSync7(workspacePath);
     mkdirSync4(workspacePath, { recursive: true });
     const templateResult = this.workspaceManager.createWorkspaceTemplates(workspacePath, { force });
     if (createdConfig) {
@@ -2322,8 +3023,11 @@ ${this.logo} ${APP_NAME4} is ready! (${source})`);
     await this.serviceCommands.stopService();
   }
   async agent(opts) {
-    const config2 = loadConfig5();
-    const workspace = getWorkspacePath3(config2.agents.defaults.workspace);
+    const config2 = loadConfig6();
+    const workspace = getWorkspacePath5(config2.agents.defaults.workspace);
+    const pluginRegistry = loadPluginRegistry(config2, workspace);
+    const extensionRegistry = toExtensionRegistry(pluginRegistry);
+    logPluginDiagnostics(pluginRegistry);
     const bus = new MessageBus2();
     const provider = this.serviceCommands.createProvider(config2) ?? this.serviceCommands.createMissingProvider(config2);
     const providerManager = new ProviderManager2(provider);
@@ -2339,7 +3043,14 @@ ${this.logo} ${APP_NAME4} is ready! (${source})`);
       execConfig: config2.tools.exec,
       restrictToWorkspace: config2.tools.restrictToWorkspace,
       contextConfig: config2.agents.context,
-      config: config2
+      config: config2,
+      extensionRegistry,
+      resolveMessageToolHints: ({ channel, accountId }) => resolvePluginChannelMessageToolHints2({
+        registry: pluginRegistry,
+        channel,
+        cfg: loadConfig6(),
+        accountId
+      })
     });
     if (opts.message) {
       const response = await agentLoop.processDirect({
@@ -2354,10 +3065,10 @@ ${this.logo} ${APP_NAME4} is ready! (${source})`);
     console.log(`${this.logo} Interactive mode (type exit or Ctrl+C to quit)
 `);
     const historyFile = join6(getDataDir6(), "history", "cli_history");
-    const historyDir = resolve7(historyFile, "..");
+    const historyDir = resolve8(historyFile, "..");
     mkdirSync4(historyDir, { recursive: true });
-    const history = existsSync6(historyFile) ? readFileSync5(historyFile, "utf-8").split("\n").filter(Boolean) : [];
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const history = existsSync7(historyFile) ? readFileSync5(historyFile, "utf-8").split("\n").filter(Boolean) : [];
+    const rl = createInterface2({ input: process.stdin, output: process.stdout });
     rl.on("close", () => {
       const merged = history.concat(rl.history ?? []);
       writeFileSync3(historyFile, merged.join("\n"));
@@ -2417,6 +3128,27 @@ ${this.logo} ${APP_NAME4} is ready! (${source})`);
       console.log(`Tip: restart ${APP_NAME4} to apply the update.`);
     }
   }
+  pluginsList(opts = {}) {
+    this.pluginCommands.pluginsList(opts);
+  }
+  pluginsInfo(id, opts = {}) {
+    this.pluginCommands.pluginsInfo(id, opts);
+  }
+  async pluginsEnable(id) {
+    await this.pluginCommands.pluginsEnable(id);
+  }
+  async pluginsDisable(id) {
+    await this.pluginCommands.pluginsDisable(id);
+  }
+  async pluginsUninstall(id, opts = {}) {
+    await this.pluginCommands.pluginsUninstall(id, opts);
+  }
+  async pluginsInstall(pathOrSpec, opts = {}) {
+    await this.pluginCommands.pluginsInstall(pathOrSpec, opts);
+  }
+  pluginsDoctor() {
+    this.pluginCommands.pluginsDoctor();
+  }
   configGet(pathExpr, opts = {}) {
     this.configCommands.configGet(pathExpr, opts);
   }
@@ -2432,6 +3164,9 @@ ${this.logo} ${APP_NAME4} is ready! (${source})`);
   channelsLogin() {
     this.channelCommands.channelsLogin();
   }
+  async channelsAdd(opts) {
+    await this.channelCommands.channelsAdd(opts);
+  }
   cronList(opts) {
     this.cronCommands.cronList(opts);
   }
@@ -2454,7 +3189,7 @@ ${this.logo} ${APP_NAME4} is ready! (${source})`);
     await this.diagnosticsCommands.doctor(opts);
   }
   async skillsInstall(options) {
-    const workdir = options.workdir ? expandHome(options.workdir) : getWorkspacePath3();
+    const workdir = options.workdir ? expandHome2(options.workdir) : getWorkspacePath5();
     const result = await installClawHubSkill({
       slug: options.slug,
       version: options.version,
@@ -2497,11 +3232,20 @@ 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 config = program.command("config").description("Manage config values");
 config.command("get <path>").description("Get a config value by dot path").option("--json", "Output JSON", false).action((path, opts) => runtime.configGet(path, opts));
 config.command("set <path> <value>").description("Set a config value by dot path").option("--json", "Parse value as JSON", false).action((path, value, opts) => runtime.configSet(path, value, opts));
 config.command("unset <path>").description("Remove a config value by dot path").action((path) => runtime.configUnset(path));
 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");