claw-control-center 0.1.7 → 0.1.8

package/dist/index.cjs

@@ -5449,10 +5449,10 @@ function resolvePluginConfig(config) {
 function resolvePluginConfigWithHostDefaults(configPath, config) {
   const resolved = resolvePluginConfig(config);
   const hostConfig = readHostGatewayConfig(resolveHostConfigPath(configPath));
-  if (!resolved.gateway.baseUrl && hostConfig.baseUrl) {
+  if (hostConfig.baseUrl && (!resolved.gateway.baseUrl || shouldPreferHostGateway(resolved.gateway.baseUrl, hostConfig.baseUrl))) {
     resolved.gateway.baseUrl = hostConfig.baseUrl;
   }
-  if (!resolved.gateway.secret && hostConfig.secret) {
+  if (hostConfig.secret && (!resolved.gateway.secret || resolved.gateway.baseUrl === hostConfig.baseUrl)) {
     resolved.gateway.secret = hostConfig.secret;
   }
   if (!resolved.hub53ai.botId && hostConfig.hub53ai?.botId) {
@@ -5466,6 +5466,28 @@ function resolvePluginConfigWithHostDefaults(configPath, config) {
   }
   return resolved;
 }
+function shouldPreferHostGateway(configuredBaseUrl, hostBaseUrl) {
+  if (configuredBaseUrl === hostBaseUrl) {
+    return false;
+  }
+  const configured = parseGatewayUrl(configuredBaseUrl);
+  const host = parseGatewayUrl(hostBaseUrl);
+  if (!configured || !host) {
+    return false;
+  }
+  return configured.isLoopback && host.isLoopback;
+}
+function parseGatewayUrl(value) {
+  try {
+    const url = new URL(value);
+    const hostname = url.hostname.replace(/^\[|\]$/g, "").toLowerCase();
+    return {
+      isLoopback: hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1"
+    };
+  } catch {
+    return void 0;
+  }
+}
 function sanitizePluginConfig(config) {
   if (!config) {
     return {};
@@ -8859,12 +8881,29 @@ function toRecord3(value) {
 
 // src/install-qclaw.ts
 var import_node_crypto4 = require("crypto");
-var import_promises4 = require("fs/promises");
+var import_promises4 = require("readline/promises");
+var import_promises5 = require("fs/promises");
 var import_node_fs4 = require("fs");
+var import_node_os2 = require("os");
 var import_node_path6 = require("path");
 var PLUGIN_ID = "claw-control-center";
 var LEGACY_PLUGIN_ID = "53ai-openclaw";
 var COPY_ITEMS = ["dist", "openclaw.plugin.json", "package.json", "bin", "web-dist"];
+var SUPPORTED_ARGS = /* @__PURE__ */ new Set([
+  "gateway",
+  "bot-id",
+  "secret",
+  "prefer-responses-api",
+  "gateway-model",
+  "hub-ws-url",
+  "hub-bot-id",
+  "hub-secret",
+  "hub-enabled",
+  "extensions-dir",
+  "config-path",
+  "console-host",
+  "console-port"
+]);
 async function installIntoQClaw(input) {
   return installIntoHost(input, "QClaw");
 }
@@ -8872,19 +8911,21 @@ async function installIntoOpenClaw(input) {
   return installIntoHost(input, "OpenClaw");
 }
 async function installIntoHost(input, hostLabel) {
-  await (0, import_promises4.mkdir)(input.extensionsDir, { recursive: true });
+  await (0, import_promises5.mkdir)(input.extensionsDir, { recursive: true });
   const destination = (0, import_node_path6.join)(input.extensionsDir, PLUGIN_ID);
-  await (0, import_promises4.mkdir)(destination, { recursive: true });
+  await (0, import_promises5.mkdir)(destination, { recursive: true });
   await copyPublishablePackage(input.packageRoot, destination);
-  await (0, import_promises4.mkdir)((0, import_node_path6.dirname)(input.configPath), { recursive: true });
+  await (0, import_promises5.mkdir)((0, import_node_path6.dirname)(input.configPath), { recursive: true });
   const config = await readOpenClawConfig(input.configPath);
   const inferredGateway = inferGatewaySettings(config);
   const inferredHub53AI = inferHub53AISettings(config);
-  const gatewayBaseUrl = input.gateway?.trim() || inferredGateway.baseUrl;
+  const explicitGatewayBaseUrl = input.gateway?.trim();
+  const explicitGatewaySecret = input.secret?.trim();
+  const gatewayBaseUrl = explicitGatewayBaseUrl || inferredGateway.baseUrl;
   if (!gatewayBaseUrl) {
     throw new Error(`missing gateway URL and no local ${hostLabel} gateway could be inferred`);
   }
-  const secret = input.secret?.trim() || inferredGateway.secret;
+  const secret = explicitGatewaySecret || inferredGateway.secret;
   if (!secret) {
     throw new Error(`missing gateway secret and no local ${hostLabel} gateway token could be inferred`);
   }
@@ -8919,8 +8960,16 @@ async function installIntoHost(input, hostLabel) {
   const previousEntry = ensureObject(entries, PLUGIN_ID);
   const previousConfig = ensureObject(previousEntry, "config");
   const previousGateway = ensureObject(previousConfig, "gateway");
-  previousGateway.baseUrl = gatewayBaseUrl;
-  previousGateway.secret = secret;
+  if (explicitGatewayBaseUrl) {
+    previousGateway.baseUrl = explicitGatewayBaseUrl;
+  } else {
+    delete previousGateway.baseUrl;
+  }
+  if (explicitGatewaySecret) {
+    previousGateway.secret = explicitGatewaySecret;
+  } else {
+    delete previousGateway.secret;
+  }
   previousGateway.preferResponsesApi = preferResponsesApi;
   if (botId) {
     previousGateway.botId = botId;
@@ -8961,7 +9010,7 @@ async function installIntoHost(input, hostLabel) {
     }
   }
   previousEntry.enabled = true;
-  await (0, import_promises4.writeFile)(input.configPath, `${JSON.stringify(config, null, 2)}
+  await (0, import_promises5.writeFile)(input.configPath, `${JSON.stringify(config, null, 2)}
 `);
   return {
     configPath: input.configPath,
@@ -8978,7 +9027,11 @@ async function runInstallCommand(input) {
     throw new Error("expected subcommand: install");
   }
   const args = parseArgs(argv.slice(1));
-  const destination = resolveInstallDestination(args);
+  const destination = await resolveInstallDestination(args, {
+    hostDefinitions: input.hostDefinitions,
+    selectHost: input.selectHost,
+    ttyPath: input.ttyPath
+  });
   const result = await installIntoHost(
     {
       packageRoot: input.packageRoot,
@@ -8996,34 +9049,141 @@ async function runInstallCommand(input) {
       consoleHost: args["console-host"],
       consolePort: args["console-port"] ? Number(args["console-port"]) : void 0
     },
-    "Claw"
+    destination.label
   );
   process.stdout.write(
     [
-      `Installed ${PLUGIN_ID} into Claw.`,
+      `Installed ${PLUGIN_ID} into ${destination.label}.`,
       `Extensions: ${result.extensionsDir}`,
       `Config: ${result.configPath}`,
       `Gateway: ${result.gatewayBaseUrl}`,
       `53AIHub: ${result.hub53aiConfigured ? "configured" : "not configured"}`,
       `Plugin build: ${result.pluginBuild}`,
-      "Restart your Claw host to load the plugin."
+      `Restart ${destination.label} to load the plugin.`
     ].join("\n") + "\n"
   );
 }
-function resolveInstallDestination(args) {
-  if (args.target !== void 0) {
-    throw new Error("--target is no longer supported; pass --config-path and --extensions-dir from your Claw host");
-  }
+async function resolveInstallDestination(args, options = {}) {
   const explicitConfigPath = args["config-path"] ? (0, import_node_path6.resolve)(args["config-path"]) : void 0;
   const explicitExtensionsDir = args["extensions-dir"] ? (0, import_node_path6.resolve)(args["extensions-dir"]) : void 0;
-  if (!explicitConfigPath || !explicitExtensionsDir) {
-    throw new Error("missing --config-path and --extensions-dir; provide the paths generated by your Claw host");
+  if (explicitConfigPath && explicitExtensionsDir) {
+    return {
+      configPath: explicitConfigPath,
+      extensionsDir: explicitExtensionsDir,
+      label: "Claw"
+    };
+  }
+  if (explicitConfigPath || explicitExtensionsDir) {
+    throw new Error("pass --config-path and --extensions-dir together, or omit both to auto-detect Claw");
+  }
+  const detected = detectInstallHosts(options.hostDefinitions ?? getDefaultHostDefinitions());
+  if (detected.length === 1) {
+    return toInstallDestination(detected[0]);
+  }
+  if (detected.length > 1) {
+    const selected = options.selectHost ? await options.selectHost(detected) : await promptForInstallHost(detected, options.ttyPath ?? "/dev/tty");
+    return toInstallDestination(selected);
+  }
+  throw new Error(
+    [
+      "could not auto-detect an installed Claw host.",
+      "Pass --config-path and --extensions-dir to install into a specific Claw.",
+      "",
+      "Supported default locations:",
+      ...formatHostList(options.hostDefinitions ?? getDefaultHostDefinitions())
+    ].join("\n")
+  );
+}
+function getDefaultHostDefinitions() {
+  const home = (0, import_node_os2.homedir)();
+  const qclawHome = (0, import_node_path6.resolve)(home, ".qclaw");
+  const openClawHome = (0, import_node_path6.resolve)(home, ".openclaw");
+  return [
+    {
+      id: "qclaw",
+      label: "QClaw",
+      configPath: (0, import_node_path6.join)(qclawHome, "openclaw.json"),
+      extensionsDir: (0, import_node_path6.resolve)(home, "Library/Application Support/QClaw/openclaw/config/extensions")
+    },
+    {
+      id: "openclaw",
+      label: "OpenClaw",
+      configPath: (0, import_node_path6.join)(openClawHome, "openclaw.json"),
+      extensionsDir: (0, import_node_path6.resolve)(openClawHome, "extensions")
+    }
+  ];
+}
+function detectInstallHosts(hosts) {
+  const seen = /* @__PURE__ */ new Set();
+  return hosts.filter((host) => {
+    const key = `${(0, import_node_path6.resolve)(host.configPath)}\0${(0, import_node_path6.resolve)(host.extensionsDir)}`;
+    if (seen.has(key) || !(0, import_node_fs4.existsSync)(host.configPath)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
+}
+async function promptForInstallHost(hosts, ttyPath) {
+  let handle;
+  try {
+    handle = await (0, import_promises5.open)(ttyPath, "r+");
+    const input = handle.createReadStream();
+    const output = handle.createWriteStream();
+    const readline = (0, import_promises4.createInterface)({ input, output });
+    try {
+      output.write("Multiple Claw installations were detected.\n");
+      output.write("Choose where to install claw-control-center:\n");
+      hosts.forEach((host, index) => {
+        output.write(`${index + 1}. ${host.label}
+`);
+        output.write(`   Config: ${host.configPath}
+`);
+        output.write(`   Extensions: ${host.extensionsDir}
+`);
+      });
+      const answer = await readline.question(`Install location [1-${hosts.length}]: `);
+      const selectedIndex = Number(answer.trim());
+      if (!Number.isInteger(selectedIndex) || selectedIndex < 1 || selectedIndex > hosts.length) {
+        throw new Error(`invalid install location: ${answer}`);
+      }
+      return hosts[selectedIndex - 1];
+    } finally {
+      readline.close();
+      input.destroy();
+      output.end();
+    }
+  } catch (error) {
+    if (error instanceof Error && error.message.startsWith("invalid install location:")) {
+      throw error;
+    }
+    throw new Error(
+      [
+        "multiple Claw installations were detected, but no interactive terminal was available.",
+        "Run the installer again with --config-path and --extensions-dir.",
+        "",
+        "Detected locations:",
+        ...formatHostList(hosts)
+      ].join("\n")
+    );
+  } finally {
+    await handle?.close().catch(() => void 0);
   }
+}
+function toInstallDestination(host) {
   return {
-    configPath: explicitConfigPath,
-    extensionsDir: explicitExtensionsDir
+    configPath: (0, import_node_path6.resolve)(host.configPath),
+    extensionsDir: (0, import_node_path6.resolve)(host.extensionsDir),
+    label: host.label
   };
 }
+function formatHostList(hosts) {
+  return hosts.flatMap((host) => [
+    `- ${host.label}`,
+    `  Config: ${host.configPath}`,
+    `  Extensions: ${host.extensionsDir}`
+  ]);
+}
 function parseArgs(argv) {
   const parsed = {};
   for (let index = 0; index < argv.length; index += 1) {
@@ -9031,12 +9191,19 @@ function parseArgs(argv) {
     if (!entry.startsWith("--")) {
       continue;
     }
+    const key = entry.slice(2);
+    if (key === "target") {
+      throw new Error("--target has been removed; omit it to auto-detect Claw or pass --config-path and --extensions-dir");
+    }
+    if (!SUPPORTED_ARGS.has(key)) {
+      throw new Error(`unknown option: --${key}`);
+    }
     const next = argv[index + 1];
     if (next && !next.startsWith("--")) {
-      parsed[entry.slice(2)] = next;
+      parsed[key] = next;
       index += 1;
     } else {
-      parsed[entry.slice(2)] = "true";
+      parsed[key] = "true";
     }
   }
   return parsed;
@@ -9051,8 +9218,8 @@ async function copyPublishablePackage(packageRoot, destination) {
       continue;
     }
     const target = (0, import_node_path6.join)(destination, relativePath);
-    await (0, import_promises4.rm)(target, { recursive: true, force: true });
-    await (0, import_promises4.cp)(source, target, { recursive: true, force: true });
+    await (0, import_promises5.rm)(target, { recursive: true, force: true });
+    await (0, import_promises5.cp)(source, target, { recursive: true, force: true });
   }
 }
 async function readPluginBuildInfo(destination) {
@@ -9060,7 +9227,7 @@ async function readPluginBuildInfo(destination) {
   const entryPath = (0, import_node_path6.join)(destination, "dist", "index.cjs");
   let version = "unknown";
   try {
-    const packageJson = JSON.parse(await (0, import_promises4.readFile)(packagePath, "utf8"));
+    const packageJson = JSON.parse(await (0, import_promises5.readFile)(packagePath, "utf8"));
     if (typeof packageJson.version === "string" && packageJson.version.trim()) {
       version = packageJson.version.trim();
     }
@@ -9068,7 +9235,7 @@ async function readPluginBuildInfo(destination) {
     version = "unknown";
   }
   try {
-    const entry = await (0, import_promises4.readFile)(entryPath);
+    const entry = await (0, import_promises5.readFile)(entryPath);
     const digest = (0, import_node_crypto4.createHash)("sha256").update(entry).digest("hex").slice(0, 12);
     return `${PLUGIN_ID}@${version} sha256:${digest}`;
   } catch {
@@ -9079,7 +9246,7 @@ async function readOpenClawConfig(configPath) {
   if (!(0, import_node_fs4.existsSync)(configPath)) {
     return {};
   }
-  return JSON.parse(await (0, import_promises4.readFile)(configPath, "utf8"));
+  return JSON.parse(await (0, import_promises5.readFile)(configPath, "utf8"));
 }
 function inferGatewaySettings(config) {
   const gateway = config.gateway ?? {};

package/dist/install-qclaw.cjs

@@ -26,12 +26,29 @@ __export(install_qclaw_exports, {
 });
 module.exports = __toCommonJS(install_qclaw_exports);
 var import_node_crypto = require("crypto");
-var import_promises = require("fs/promises");
+var import_promises = require("readline/promises");
+var import_promises2 = require("fs/promises");
 var import_node_fs = require("fs");
+var import_node_os = require("os");
 var import_node_path = require("path");
 var PLUGIN_ID = "claw-control-center";
 var LEGACY_PLUGIN_ID = "53ai-openclaw";
 var COPY_ITEMS = ["dist", "openclaw.plugin.json", "package.json", "bin", "web-dist"];
+var SUPPORTED_ARGS = /* @__PURE__ */ new Set([
+  "gateway",
+  "bot-id",
+  "secret",
+  "prefer-responses-api",
+  "gateway-model",
+  "hub-ws-url",
+  "hub-bot-id",
+  "hub-secret",
+  "hub-enabled",
+  "extensions-dir",
+  "config-path",
+  "console-host",
+  "console-port"
+]);
 async function installIntoQClaw(input) {
   return installIntoHost(input, "QClaw");
 }
@@ -39,19 +56,21 @@ async function installIntoOpenClaw(input) {
   return installIntoHost(input, "OpenClaw");
 }
 async function installIntoHost(input, hostLabel) {
-  await (0, import_promises.mkdir)(input.extensionsDir, { recursive: true });
+  await (0, import_promises2.mkdir)(input.extensionsDir, { recursive: true });
   const destination = (0, import_node_path.join)(input.extensionsDir, PLUGIN_ID);
-  await (0, import_promises.mkdir)(destination, { recursive: true });
+  await (0, import_promises2.mkdir)(destination, { recursive: true });
   await copyPublishablePackage(input.packageRoot, destination);
-  await (0, import_promises.mkdir)((0, import_node_path.dirname)(input.configPath), { recursive: true });
+  await (0, import_promises2.mkdir)((0, import_node_path.dirname)(input.configPath), { recursive: true });
   const config = await readOpenClawConfig(input.configPath);
   const inferredGateway = inferGatewaySettings(config);
   const inferredHub53AI = inferHub53AISettings(config);
-  const gatewayBaseUrl = input.gateway?.trim() || inferredGateway.baseUrl;
+  const explicitGatewayBaseUrl = input.gateway?.trim();
+  const explicitGatewaySecret = input.secret?.trim();
+  const gatewayBaseUrl = explicitGatewayBaseUrl || inferredGateway.baseUrl;
   if (!gatewayBaseUrl) {
     throw new Error(`missing gateway URL and no local ${hostLabel} gateway could be inferred`);
   }
-  const secret = input.secret?.trim() || inferredGateway.secret;
+  const secret = explicitGatewaySecret || inferredGateway.secret;
   if (!secret) {
     throw new Error(`missing gateway secret and no local ${hostLabel} gateway token could be inferred`);
   }
@@ -86,8 +105,16 @@ async function installIntoHost(input, hostLabel) {
   const previousEntry = ensureObject(entries, PLUGIN_ID);
   const previousConfig = ensureObject(previousEntry, "config");
   const previousGateway = ensureObject(previousConfig, "gateway");
-  previousGateway.baseUrl = gatewayBaseUrl;
-  previousGateway.secret = secret;
+  if (explicitGatewayBaseUrl) {
+    previousGateway.baseUrl = explicitGatewayBaseUrl;
+  } else {
+    delete previousGateway.baseUrl;
+  }
+  if (explicitGatewaySecret) {
+    previousGateway.secret = explicitGatewaySecret;
+  } else {
+    delete previousGateway.secret;
+  }
   previousGateway.preferResponsesApi = preferResponsesApi;
   if (botId) {
     previousGateway.botId = botId;
@@ -128,7 +155,7 @@ async function installIntoHost(input, hostLabel) {
     }
   }
   previousEntry.enabled = true;
-  await (0, import_promises.writeFile)(input.configPath, `${JSON.stringify(config, null, 2)}
+  await (0, import_promises2.writeFile)(input.configPath, `${JSON.stringify(config, null, 2)}
 `);
   return {
     configPath: input.configPath,
@@ -145,7 +172,11 @@ async function runInstallCommand(input) {
     throw new Error("expected subcommand: install");
   }
   const args = parseArgs(argv.slice(1));
-  const destination = resolveInstallDestination(args);
+  const destination = await resolveInstallDestination(args, {
+    hostDefinitions: input.hostDefinitions,
+    selectHost: input.selectHost,
+    ttyPath: input.ttyPath
+  });
   const result = await installIntoHost(
     {
       packageRoot: input.packageRoot,
@@ -163,34 +194,141 @@ async function runInstallCommand(input) {
       consoleHost: args["console-host"],
       consolePort: args["console-port"] ? Number(args["console-port"]) : void 0
     },
-    "Claw"
+    destination.label
   );
   process.stdout.write(
     [
-      `Installed ${PLUGIN_ID} into Claw.`,
+      `Installed ${PLUGIN_ID} into ${destination.label}.`,
       `Extensions: ${result.extensionsDir}`,
       `Config: ${result.configPath}`,
       `Gateway: ${result.gatewayBaseUrl}`,
       `53AIHub: ${result.hub53aiConfigured ? "configured" : "not configured"}`,
       `Plugin build: ${result.pluginBuild}`,
-      "Restart your Claw host to load the plugin."
+      `Restart ${destination.label} to load the plugin.`
     ].join("\n") + "\n"
   );
 }
-function resolveInstallDestination(args) {
-  if (args.target !== void 0) {
-    throw new Error("--target is no longer supported; pass --config-path and --extensions-dir from your Claw host");
-  }
+async function resolveInstallDestination(args, options = {}) {
   const explicitConfigPath = args["config-path"] ? (0, import_node_path.resolve)(args["config-path"]) : void 0;
   const explicitExtensionsDir = args["extensions-dir"] ? (0, import_node_path.resolve)(args["extensions-dir"]) : void 0;
-  if (!explicitConfigPath || !explicitExtensionsDir) {
-    throw new Error("missing --config-path and --extensions-dir; provide the paths generated by your Claw host");
+  if (explicitConfigPath && explicitExtensionsDir) {
+    return {
+      configPath: explicitConfigPath,
+      extensionsDir: explicitExtensionsDir,
+      label: "Claw"
+    };
+  }
+  if (explicitConfigPath || explicitExtensionsDir) {
+    throw new Error("pass --config-path and --extensions-dir together, or omit both to auto-detect Claw");
+  }
+  const detected = detectInstallHosts(options.hostDefinitions ?? getDefaultHostDefinitions());
+  if (detected.length === 1) {
+    return toInstallDestination(detected[0]);
+  }
+  if (detected.length > 1) {
+    const selected = options.selectHost ? await options.selectHost(detected) : await promptForInstallHost(detected, options.ttyPath ?? "/dev/tty");
+    return toInstallDestination(selected);
   }
+  throw new Error(
+    [
+      "could not auto-detect an installed Claw host.",
+      "Pass --config-path and --extensions-dir to install into a specific Claw.",
+      "",
+      "Supported default locations:",
+      ...formatHostList(options.hostDefinitions ?? getDefaultHostDefinitions())
+    ].join("\n")
+  );
+}
+function getDefaultHostDefinitions() {
+  const home = (0, import_node_os.homedir)();
+  const qclawHome = (0, import_node_path.resolve)(home, ".qclaw");
+  const openClawHome = (0, import_node_path.resolve)(home, ".openclaw");
+  return [
+    {
+      id: "qclaw",
+      label: "QClaw",
+      configPath: (0, import_node_path.join)(qclawHome, "openclaw.json"),
+      extensionsDir: (0, import_node_path.resolve)(home, "Library/Application Support/QClaw/openclaw/config/extensions")
+    },
+    {
+      id: "openclaw",
+      label: "OpenClaw",
+      configPath: (0, import_node_path.join)(openClawHome, "openclaw.json"),
+      extensionsDir: (0, import_node_path.resolve)(openClawHome, "extensions")
+    }
+  ];
+}
+function detectInstallHosts(hosts) {
+  const seen = /* @__PURE__ */ new Set();
+  return hosts.filter((host) => {
+    const key = `${(0, import_node_path.resolve)(host.configPath)}\0${(0, import_node_path.resolve)(host.extensionsDir)}`;
+    if (seen.has(key) || !(0, import_node_fs.existsSync)(host.configPath)) {
+      return false;
+    }
+    seen.add(key);
+    return true;
+  });
+}
+async function promptForInstallHost(hosts, ttyPath) {
+  let handle;
+  try {
+    handle = await (0, import_promises2.open)(ttyPath, "r+");
+    const input = handle.createReadStream();
+    const output = handle.createWriteStream();
+    const readline = (0, import_promises.createInterface)({ input, output });
+    try {
+      output.write("Multiple Claw installations were detected.\n");
+      output.write("Choose where to install claw-control-center:\n");
+      hosts.forEach((host, index) => {
+        output.write(`${index + 1}. ${host.label}
+`);
+        output.write(`   Config: ${host.configPath}
+`);
+        output.write(`   Extensions: ${host.extensionsDir}
+`);
+      });
+      const answer = await readline.question(`Install location [1-${hosts.length}]: `);
+      const selectedIndex = Number(answer.trim());
+      if (!Number.isInteger(selectedIndex) || selectedIndex < 1 || selectedIndex > hosts.length) {
+        throw new Error(`invalid install location: ${answer}`);
+      }
+      return hosts[selectedIndex - 1];
+    } finally {
+      readline.close();
+      input.destroy();
+      output.end();
+    }
+  } catch (error) {
+    if (error instanceof Error && error.message.startsWith("invalid install location:")) {
+      throw error;
+    }
+    throw new Error(
+      [
+        "multiple Claw installations were detected, but no interactive terminal was available.",
+        "Run the installer again with --config-path and --extensions-dir.",
+        "",
+        "Detected locations:",
+        ...formatHostList(hosts)
+      ].join("\n")
+    );
+  } finally {
+    await handle?.close().catch(() => void 0);
+  }
+}
+function toInstallDestination(host) {
   return {
-    configPath: explicitConfigPath,
-    extensionsDir: explicitExtensionsDir
+    configPath: (0, import_node_path.resolve)(host.configPath),
+    extensionsDir: (0, import_node_path.resolve)(host.extensionsDir),
+    label: host.label
   };
 }
+function formatHostList(hosts) {
+  return hosts.flatMap((host) => [
+    `- ${host.label}`,
+    `  Config: ${host.configPath}`,
+    `  Extensions: ${host.extensionsDir}`
+  ]);
+}
 function parseArgs(argv) {
   const parsed = {};
   for (let index = 0; index < argv.length; index += 1) {
@@ -198,12 +336,19 @@ function parseArgs(argv) {
     if (!entry.startsWith("--")) {
       continue;
     }
+    const key = entry.slice(2);
+    if (key === "target") {
+      throw new Error("--target has been removed; omit it to auto-detect Claw or pass --config-path and --extensions-dir");
+    }
+    if (!SUPPORTED_ARGS.has(key)) {
+      throw new Error(`unknown option: --${key}`);
+    }
     const next = argv[index + 1];
     if (next && !next.startsWith("--")) {
-      parsed[entry.slice(2)] = next;
+      parsed[key] = next;
       index += 1;
     } else {
-      parsed[entry.slice(2)] = "true";
+      parsed[key] = "true";
     }
   }
   return parsed;
@@ -218,8 +363,8 @@ async function copyPublishablePackage(packageRoot, destination) {
       continue;
     }
     const target = (0, import_node_path.join)(destination, relativePath);
-    await (0, import_promises.rm)(target, { recursive: true, force: true });
-    await (0, import_promises.cp)(source, target, { recursive: true, force: true });
+    await (0, import_promises2.rm)(target, { recursive: true, force: true });
+    await (0, import_promises2.cp)(source, target, { recursive: true, force: true });
   }
 }
 async function readPluginBuildInfo(destination) {
@@ -227,7 +372,7 @@ async function readPluginBuildInfo(destination) {
   const entryPath = (0, import_node_path.join)(destination, "dist", "index.cjs");
   let version = "unknown";
   try {
-    const packageJson = JSON.parse(await (0, import_promises.readFile)(packagePath, "utf8"));
+    const packageJson = JSON.parse(await (0, import_promises2.readFile)(packagePath, "utf8"));
     if (typeof packageJson.version === "string" && packageJson.version.trim()) {
       version = packageJson.version.trim();
     }
@@ -235,7 +380,7 @@ async function readPluginBuildInfo(destination) {
     version = "unknown";
   }
   try {
-    const entry = await (0, import_promises.readFile)(entryPath);
+    const entry = await (0, import_promises2.readFile)(entryPath);
     const digest = (0, import_node_crypto.createHash)("sha256").update(entry).digest("hex").slice(0, 12);
     return `${PLUGIN_ID}@${version} sha256:${digest}`;
   } catch {
@@ -246,7 +391,7 @@ async function readOpenClawConfig(configPath) {
   if (!(0, import_node_fs.existsSync)(configPath)) {
     return {};
   }
-  return JSON.parse(await (0, import_promises.readFile)(configPath, "utf8"));
+  return JSON.parse(await (0, import_promises2.readFile)(configPath, "utf8"));
 }
 function inferGatewaySettings(config) {
   const gateway = config.gateway ?? {};

package/dist/install-qclaw.d.cts

@@ -14,6 +14,13 @@ type InstallInput = {
     consoleHost?: string;
     consolePort?: number;
 };
+type InstallLabel = "Claw" | "QClaw" | "OpenClaw";
+type HostDefinition = {
+    id: string;
+    label: InstallLabel;
+    configPath: string;
+    extensionsDir: string;
+};
 declare function installIntoQClaw(input: InstallInput): Promise<{
     configPath: string;
     extensionsDir: string;
@@ -33,6 +40,9 @@ declare function installIntoOpenClaw(input: InstallInput): Promise<{
 declare function runInstallCommand(input: {
     argv?: string[];
     packageRoot: string;
+    hostDefinitions?: HostDefinition[];
+    selectHost?: (hosts: HostDefinition[]) => Promise<HostDefinition>;
+    ttyPath?: string;
 }): Promise<void>;
 
-export { installIntoOpenClaw, installIntoQClaw, runInstallCommand };
+export { type HostDefinition, installIntoOpenClaw, installIntoQClaw, runInstallCommand };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claw-control-center",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "main": "dist/index.cjs",
   "types": "dist/index.d.ts",