Function cmdSetup

src/cli.ts:540–610

* `clawrouter setup` — finish OpenClaw integration after `npm install -g`. * * Bare `npm install -g @blockrun/clawrouter` puts the package on disk and * adds the `clawrouter` binary to PATH, but performs ZERO OpenClaw plugin * registration: no entry in openclaw.json's `plugins.entries`, no provi

()

 * complete setup, or after a stuck partial install to repair config.
 */
async function cmdSetup(): Promise<void> {
  const { execFileSync, execSync } = await import("node:child_process");
  const { injectModelsConfig, injectAuthProfile } = await import("./index.js");

  console.log("🦞 ClawRouter setup\n");

  // Step 1: detect OpenClaw on PATH
  let openclawPath: string;
  try {
    openclawPath = execSync("command -v openclaw", {
      encoding: "utf8",
      stdio: ["ignore", "pipe", "ignore"],
    }).trim();
    if (!openclawPath) throw new Error("not found");
    console.log(`  ✓ Found openclaw at ${openclawPath}`);
  } catch {
    console.error("  ✗ openclaw not found on PATH");
    console.error("    Install OpenClaw first: npm install -g openclaw");
    console.error("    Then re-run: clawrouter setup");
    process.exit(1);
  }

  // Step 2: register as an OpenClaw plugin (writes plugins.entries.clawrouter).
  // OpenClaw 2026.5.2 added strict validation that may reject our config writes
  // during install (e.g. unknown web_search provider blockrun-exa before the
  // gateway is running). If that happens, OpenClaw rolls back its own install
  // record but our injectModelsConfig step below will still populate the user's
  // openclaw.json correctly — they'll just need to re-run `openclaw plugins
  // install --force @blockrun/clawrouter` after the gateway has started.
  console.log("\n→ Registering ClawRouter with OpenClaw...");
  let installOk = false;
  try {
    execFileSync(openclawPath, ["plugins", "install", "--force", "@blockrun/clawrouter"], {
      stdio: "inherit",
    });
    installOk = true;
  } catch (err) {
    console.warn(
      `  ⚠ openclaw plugins install reported a problem: ${err instanceof Error ? err.message : String(err)}`,
    );
    console.warn("    Continuing with manual config sync — if validation rejected the install,");
    console.warn(
      "    re-run `openclaw plugins install --force @blockrun/clawrouter` after gateway start.",
    );
  }

  // Step 3: sync the models allowlist + provider config + auth profile directly.
  // forceWrite: true bypasses the gateway-mode guard added in v0.12.184 since
  // this is an explicit user command, not a plugin-activation hook inside an
  // install transaction.
  console.log("\n→ Syncing models allowlist + auth profile...");
  const setupLogger = {
    info: (msg: string) => console.log(`  ${msg}`),
  };
  try {
    injectModelsConfig(setupLogger, { forceWrite: true });
    injectAuthProfile(setupLogger);
  } catch (err) {