@clanker-chain/clanker-cli 2026.9.8-2 → 2026.9.8

package/bin/clanker.mjs

@@ -26,8 +26,6 @@ import { resolveForRead, resolveOperatorKey, resolveReadIdentity } from "../lib/
 import { runSetup } from "../lib/setup.mjs";
 import { runDoctor } from "../lib/doctor.mjs";
 import {
-  botIdentityCard,
-  botIdentityJson,
   hubConnectChecklist,
   wireOpenClawMqtt,
 } from "../lib/openclaw-wire.mjs";
@@ -617,30 +615,18 @@ async function main() {
         keyPath: result.key_path,
       });
       if (hasFlag(flags, "--json")) {
-        printJson({
-          ...result,
-          openclaw: wire,
-          bot_identity: botIdentityJson({
-            botId: botLabel,
-            keyPath: result.key_path,
-            openclawConfigPath: wire.path,
-          }),
-        });
+        printJson({ ...result, openclaw: wire });
       } else {
         console.log(c.green(`Minted bot ${botLabel} under ${operatorLabel}`));
         console.log(`botKey:   ${result.bot_key}`);
+        console.log(`key file: ${result.key_path}`);
+        console.log(`also:     ${result.clanker_key_path}`);
         console.log(`tx:       ${result.tx}`);
-        console.log(c.dim(`also:     ${result.clanker_key_path}`));
-        console.log("");
-        for (const line of botIdentityCard({
-          botId: botLabel,
-          operatorId: operatorLabel,
-          keyPath: result.key_path,
-          openclawPath: wire.path,
-          created: wire.created,
-        })) {
-          console.log(line);
-        }
+        console.log(
+          wire.created
+            ? c.green(`Wrote ${wire.path}`)
+            : c.green(`Updated channels.mqtt in ${wire.path}`),
+        );
         nextHint(
           hubConnectChecklist({
             botId: botLabel,

package/lib/openclaw-wire.mjs

@@ -94,7 +94,6 @@ export function wireOpenClawMqtt(opts) {
 export function hubConnectChecklist(opts) {
   const pin = opts.pluginPin ?? OPENCLAW_PLUGIN_PIN;
   return [
-    "Your bot login is already wired — install plugins and restart OpenClaw.",
     `openclaw plugins install @clanker-chain/mqtt-channel-plugin@${pin}`,
     `openclaw plugins install @clanker-chain/mqtt-tools@${pin}`,
     "Enable plugin ids mqtt + mqtt-tools (already set in openclaw.json if we wired it)",
@@ -103,43 +102,3 @@ export function hubConnectChecklist(opts) {
     "DM openclaw.france.prod-1 to smoke the mesh",
   ];
 }
-
-/**
- * Plain-language card: what the bot uses vs operator mint key.
- * @param {{
- *   botId: string,
- *   operatorId: string,
- *   keyPath: string,
- *   openclawPath: string,
- *   created?: boolean,
- * }} opts
- * @returns {string[]}
- */
-export function botIdentityCard(opts) {
-  const openclawState = opts.created
-    ? `${opts.openclawPath} (channels.mqtt created)`
-    : `${opts.openclawPath} (channels.mqtt updated)`;
-  return [
-    "Bot identity (what OpenClaw uses to CONNECT):",
-    `bot id:     ${opts.botId}`,
-    `operator:   ${opts.operatorId}`,
-    `bot key:    ${opts.keyPath}`,
-    `openclaw:   ${openclawState}`,
-    "Do not give the bot ~/.clanker/op.key — that key is only for mint/transfer.",
-  ];
-}
-
-/**
- * Structured bot_identity for --json mint output.
- * @param {{ botId: string, keyPath: string, openclawConfigPath: string }} opts
- */
-export function botIdentityJson(opts) {
-  return {
-    botId: opts.botId,
-    keyPath: opts.keyPath,
-    openclawConfigPath: opts.openclawConfigPath,
-    warnOperatorKey:
-      "Do not give the bot ~/.clanker/op.key — that key is only for mint/transfer.",
-  };
-}
-

package/lib/setup.mjs

@@ -33,11 +33,6 @@ import {
   exportFoundryKey,
   resolveFoundryAddress,
 } from "./foundry.mjs";
-import {
-  BASE_SEPOLIA_FAUCET_URL,
-  consumerFundHints,
-  generateOperatorKeyFile,
-} from "./operator-key.mjs";
 import { c, nextHint } from "./ui.mjs";
 import { join } from "node:path";
 
@@ -57,7 +52,6 @@ export function parseSetupFlags(argv) {
   let skipChainCheck = false;
   let foundryAccount = null;
   let exportKey = false;
-  let generateKey = false;
 
   for (let i = 0; i < argv.length; i += 1) {
     const a = argv[i];
@@ -69,7 +63,6 @@ export function parseSetupFlags(argv) {
     else if (a === "--from-block" && argv[i + 1]) fromBlock = BigInt(argv[++i]);
     else if (a === "--foundry-account" && argv[i + 1]) foundryAccount = argv[++i];
     else if (a === "--export-key") exportKey = true;
-    else if (a === "--generate-key") generateKey = true;
     else if (a === "--force") force = true;
     else if (a === "--yes" || a === "-y") yes = true;
     else if (a === "--skip-key") skipKey = true;
@@ -89,7 +82,6 @@ export function parseSetupFlags(argv) {
     skipChainCheck,
     foundryAccount,
     exportKey,
-    generateKey,
   };
 }
 
@@ -211,7 +203,7 @@ export async function runSetupNonInteractive(argv, opts = {}) {
   if (!flags.preset || !PRESETS[flags.preset]) {
     throw new Error(
       "Non-interactive setup requires --preset sepolia|local (stdin is not a TTY). " +
-        "Also pass --operator <label> and --generate-key (or --address / --key-file)",
+        "Also pass --operator <label> and --address 0x…",
     );
   }
   if (!flags.operator) {
@@ -226,23 +218,6 @@ export async function runSetupNonInteractive(argv, opts = {}) {
     inheritStdio: false,
   };
 
-  if (flags.generateKey) {
-    if (flags.skipKey) {
-      throw new Error("Cannot combine --generate-key with --skip-key");
-    }
-    const dest = keyFile || defaultOperatorKeyPath(home);
-    const created = generateOperatorKeyFile(dest, {
-      force: flags.force,
-    });
-    keyFile = created.path;
-    if (address && getAddress(address) !== getAddress(created.address)) {
-      throw new Error(
-        `Generated key address ${created.address} does not match --address ${getAddress(address)}`,
-      );
-    }
-    address = created.address;
-  }
-
   if (flags.foundryAccount) {
     if (!address) {
       address = resolveFoundryAddress(flags.foundryAccount, castOpts);
@@ -263,7 +238,7 @@ export async function runSetupNonInteractive(argv, opts = {}) {
   if (!address && env.OPERATOR_PRIVATE_KEY) address = addressFromEnv(env);
   if (!address) {
     throw new Error(
-      "Non-interactive setup requires --generate-key, --address 0x…, --key-file, OPERATOR_PRIVATE_KEY, or --foundry-account",
+      "Non-interactive setup requires --address 0x…, --key-file, OPERATOR_PRIVATE_KEY, or --foundry-account",
     );
   }
 
@@ -330,13 +305,9 @@ export async function runSetupInteractive(argv, opts = {}) {
   });
 
   clack.intro(c.bold("clanker setup"));
-  clack.log.step(
-    "Sets up your operator identity (org account) and network for OpenClaw bots.",
-  );
+  clack.log.step("Creates ~/.clanker/config.json (network) and operator.json (identity).");
   clack.log.message(
-    c.dim(
-      "New here? Create a key file — no wallet app or Foundry required. Mint needs a little test ETH later.",
-    ),
+    c.dim("whoami works from owner without a key; mint/revoke need a key pointer later."),
   );
   clack.log.message(c.dim(`Profile: ${home}`));
   console.log("");
@@ -395,28 +366,6 @@ export async function runSetupInteractive(argv, opts = {}) {
 
   let address = flags.address ?? null;
   let foundryAccountUsed = null;
-  let generatedKeyFile = null;
-  if (!address && flags.generateKey) {
-    const dest = flags.keyFile || defaultOperatorKeyPath(home);
-    let forceGen = flags.force;
-    if (existsSync(dest) && !forceGen) {
-      forceGen = cancelIf(
-        await clack.confirm({
-          message: `Overwrite existing ${dest}?`,
-          initialValue: false,
-        }),
-      );
-      if (!forceGen) {
-        clack.cancel("Aborted.");
-        process.exit(0);
-      }
-    }
-    const created = generateOperatorKeyFile(dest, { force: true });
-    generatedKeyFile = created.path;
-    address = created.address;
-    clack.log.success(`Created operator key at ${created.path}`);
-    clack.log.info(`Your operator address: ${created.address}`);
-  }
   if (!address && flags.keyFile) {
     address = addressFromKeyFile(flags.keyFile);
     clack.log.info(`Address from --key-file: ${address}`);
@@ -439,95 +388,23 @@ export async function runSetupInteractive(argv, opts = {}) {
     );
     if (useOp) address = hints.operator.owner;
   }
-  if (!address) {
+  if (!address && hints.foundryAccounts.length) {
     const options = [
-      {
-        value: "__generate__",
-        label: "Create a new operator key for me",
-        hint: "writes ~/.clanker/op.key (recommended)",
-      },
-      {
-        value: "__keyfile__",
-        label: "Use an existing key file…",
-        hint: "path to a 0x private key file",
-      },
+      ...hints.foundryAccounts.map((n) => ({
+        value: n,
+        label: n,
+        hint: "resolve via cast wallet address",
+      })),
+      { value: "__paste__", label: "Paste an address…", hint: "0x…" },
     ];
-    if (hints.foundryAccounts.length) {
-      for (const n of hints.foundryAccounts) {
-        options.push({
-          value: n,
-          label: `Foundry: ${n}`,
-          hint: "advanced — cast wallet",
-        });
-      }
-    } else {
-      options.push({
-        value: "__foundry_missing__",
-        label: "Foundry account…",
-        hint: "advanced — install Foundry first",
-      });
-    }
-    options.push({
-      value: "__paste__",
-      label: "Paste an address…",
-      hint: "read-only unless you add a key later",
-    });
-
     const pick = cancelIf(
       await clack.select({
-        message: "How do you want to set your operator identity?",
+        message: "Operator owner source",
         options,
-        initialValue: "__generate__",
+        initialValue: hints.foundryAccounts[0],
       }),
     );
-
-    if (pick === "__generate__") {
-      const dest = defaultOperatorKeyPath(home);
-      let forceGen = flags.force;
-      if (existsSync(dest) && !forceGen) {
-        forceGen = cancelIf(
-          await clack.confirm({
-            message: `Overwrite existing ${dest}?`,
-            initialValue: false,
-          }),
-        );
-        if (!forceGen) {
-          clack.cancel("Aborted.");
-          process.exit(0);
-        }
-      }
-      const created = generateOperatorKeyFile(dest, { force: true });
-      generatedKeyFile = created.path;
-      address = created.address;
-      clack.log.success(`Created operator key at ${created.path}`);
-      clack.log.info(`Your operator address: ${created.address}`);
-    } else if (pick === "__keyfile__") {
-      const path = cancelIf(
-        await clack.text({
-          message: "Path to operator key file",
-          placeholder: join(home, "op.key"),
-          validate: (v) =>
-            v && String(v).trim() && existsSync(String(v).trim())
-              ? undefined
-              : "File not found",
-        }),
-      );
-      generatedKeyFile = String(path).trim();
-      address = addressFromKeyFile(generatedKeyFile);
-      clack.log.info(`Address from key file: ${address}`);
-    } else if (pick === "__foundry_missing__") {
-      clack.log.warn(
-        "Foundry (cast) is not available. Install https://book.getfoundry.sh/ or choose Create a new operator key.",
-      );
-      address = cancelIf(
-        await clack.text({
-          message: "Operator owner address",
-          placeholder: "0x…",
-          validate: (v) =>
-            /^0x[0-9a-fA-F]{40}$/.test(v || "") ? undefined : "Need 0x + 40 hex",
-        }),
-      );
-    } else if (pick === "__paste__") {
+    if (pick === "__paste__") {
       address = cancelIf(
         await clack.text({
           message: "Operator owner address",
@@ -559,6 +436,16 @@ export async function runSetupInteractive(argv, opts = {}) {
       }
     }
   }
+  if (!address) {
+    address = cancelIf(
+      await clack.text({
+        message: "Operator owner address",
+        placeholder: "0x…",
+        validate: (v) =>
+          /^0x[0-9a-fA-F]{40}$/.test(v || "") ? undefined : "Need 0x + 40 hex",
+      }),
+    );
+  }
   address = getAddress(address);
 
   let label = flags.operator || hints.operator?.label || null;
@@ -596,7 +483,7 @@ export async function runSetupInteractive(argv, opts = {}) {
     throw err;
   }
 
-  let keyFile = flags.keyFile || generatedKeyFile;
+  let keyFile = flags.keyFile;
   let keyEnv = flags.keyEnv;
   let skipKey = flags.skipKey;
   if (!skipKey && !keyFile && !keyEnv) {
@@ -692,16 +579,7 @@ export async function runSetupInteractive(argv, opts = {}) {
   if (!key) {
     nextHint([
       "clanker whoami",
-      "clanker setup — choose Create a new operator key when you need mint",
-    ]);
-  } else if (preset === "sepolia" && generatedKeyFile) {
-    nextHint(consumerFundHints({ address, label }));
-  } else if (preset === "sepolia") {
-    nextHint([
-      `If this address needs test ETH: ${BASE_SEPOLIA_FAUCET_URL}`,
-      "clanker doctor",
-      "clanker whoami",
-      `clanker bot mint <label>`,
+      "clanker setup --key-file ~/.clanker/op.key --force   # when you need mint",
     ]);
   } else {
     nextHint(["clanker whoami", `clanker bot mint <label>`]);
@@ -715,20 +593,23 @@ export async function runSetupInteractive(argv, opts = {}) {
 export async function runSetup(argv, opts = {}) {
   const flags = parseSetupFlags(argv);
   const isTTY = opts.isTTY ?? Boolean(input.isTTY);
-  const hasIdentitySource = Boolean(
-    flags.address ||
-      flags.keyFile ||
-      flags.generateKey ||
-      flags.foundryAccount ||
-      opts.env?.OPERATOR_PRIVATE_KEY ||
-      process.env.OPERATOR_PRIVATE_KEY,
-  );
 
-  if (!isTTY || (flags.yes && flags.preset && flags.operator && hasIdentitySource)) {
+  if (
+    !isTTY ||
+    (flags.yes && flags.preset && flags.operator && (flags.address || flags.keyFile))
+  ) {
     if (!isTTY && !(flags.preset && flags.operator)) {
       return runSetupNonInteractive(argv, opts);
     }
-    if (flags.yes && flags.preset && flags.operator && hasIdentitySource) {
+    if (
+      flags.yes &&
+      flags.preset &&
+      flags.operator &&
+      (flags.address ||
+        flags.keyFile ||
+        opts.env?.OPERATOR_PRIVATE_KEY ||
+        process.env.OPERATOR_PRIVATE_KEY)
+    ) {
       return runSetupNonInteractive(argv, opts);
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clanker-chain/clanker-cli",
-  "version": "2026.9.8-2",
+  "version": "2026.9.8",
   "description": "CLI for wiring clanker-chain identity and MQTT into OpenClaw and other agentic stacks.",
   "type": "module",
   "bin": {

package/lib/operator-key.mjs

@@ -1,50 +0,0 @@
-/**
- * Consumer-path operator key helpers (generate local op.key).
- * Never logs private keys.
- */
-
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { dirname } from "node:path";
-import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
-import { defaultOperatorKeyPath } from "./foundry.mjs";
-
-export { defaultOperatorKeyPath };
-
-/** Coinbase Developer Platform faucet UI (Base Sepolia). */
-export const BASE_SEPOLIA_FAUCET_URL =
-  "https://portal.cdp.coinbase.com/products/faucet";
-
-/**
- * Generate a new secp256k1 key and write it to destPath (mode 0o600).
- * Does not print the key.
- *
- * @param {string} destPath
- * @param {{ force?: boolean }} [opts]
- * @returns {{ path: string, address: string }}
- */
-export function generateOperatorKeyFile(destPath, opts = {}) {
-  if (existsSync(destPath) && !opts.force) {
-    throw new Error(
-      `Key file already exists: ${destPath} (pass --force to overwrite)`,
-    );
-  }
-  const key = generatePrivateKey();
-  const address = privateKeyToAccount(key).address;
-  mkdirSync(dirname(destPath), { recursive: true });
-  writeFileSync(destPath, `${key}\n`, { mode: 0o600 });
-  return { path: destPath, address };
-}
-
-/**
- * Plain-language next steps after creating an operator key on Sepolia.
- * @param {{ address: string, label?: string }} opts
- */
-export function consumerFundHints(opts) {
-  const mintLabel = opts.label ? ` ${opts.label}` : "";
-  return [
-    `Your operator address is ${opts.address} — fund it with Base Sepolia ETH: ${BASE_SEPOLIA_FAUCET_URL}`,
-    "clanker doctor",
-    `clanker operator mint${mintLabel} --yes`,
-    "clanker bot mint <bot_label> --yes",
-  ];
-}