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

package/bin/clanker.mjs

@@ -26,6 +26,8 @@ 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";
@@ -615,18 +617,30 @@ async function main() {
         keyPath: result.key_path,
       });
       if (hasFlag(flags, "--json")) {
-        printJson({ ...result, openclaw: wire });
+        printJson({
+          ...result,
+          openclaw: wire,
+          bot_identity: botIdentityJson({
+            botId: botLabel,
+            keyPath: result.key_path,
+            openclawConfigPath: wire.path,
+          }),
+        });
       } 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(
-          wire.created
-            ? c.green(`Wrote ${wire.path}`)
-            : c.green(`Updated channels.mqtt in ${wire.path}`),
-        );
+        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);
+        }
         nextHint(
           hubConnectChecklist({
             botId: botLabel,

package/lib/openclaw-wire.mjs

@@ -94,6 +94,7 @@ 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)",
@@ -102,3 +103,43 @@ 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/package.json

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