traderclaw-cli 1.0.93-beta.0 → 1.0.93

package/bin/installer-step-engine.mjs

@@ -530,6 +530,42 @@ async function installOpenClawPlatform() {
   };
 }
 
+/**
+ * Check whether the OpenClaw CLI has any devices stuck in a pending-approval or
+ * repair state.  This can happen when the gateway version >= 1.0.93-beta.0 starts
+ * treating every CLI invocation as a "device" that must be explicitly approved
+ * before it gets operator-write scope.  Without that scope all trading RPCs fail
+ * silently (read-only).
+ *
+ * Returns:
+ *   { ran: false }                        – openclaw not on PATH or devices subcommand not supported
+ *   { ran: true, pendingIds: string[],    – list ran OK; ids needing approval
+ *     repairDetected: boolean,            – current device is in repair/read-only state
+ *     envTokenSet: boolean }              – OPENCLAW_GATEWAY_TOKEN env var already present (fallback)
+ */
+function checkOpenClawDeviceApproval() {
+  if (!commandExists("openclaw")) return { ran: false };
+  const raw = getCommandOutput("openclaw devices list");
+  if (!raw) return { ran: false };
+
+  const lower = raw.toLowerCase();
+  const envTokenSet = !!process.env.OPENCLAW_GATEWAY_TOKEN;
+
+  // Detect devices that are waiting for approval ("pending" requestId lines).
+  const pendingIds = [];
+  for (const line of raw.split("\n")) {
+    // Lines typically look like:  d4fcdbe8-5176-422b-...   pending
+    const m = line.match(/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/i);
+    if (m && (line.toLowerCase().includes("pending") || line.toLowerCase().includes("repair"))) {
+      pendingIds.push(m[1]);
+    }
+  }
+
+  const repairDetected = lower.includes("repair");
+
+  return { ran: true, pendingIds, repairDetected, envTokenSet, raw };
+}
+
 function isNpmGlobalBinConflict(err, cliName) {
   const text = `${err?.message || ""}\n${err?.stderr || ""}\n${err?.stdout || ""}`.toLowerCase();
   return (
@@ -1135,39 +1171,6 @@ function configureGatewayScheduling(modeConfig, configPath = CONFIG_FILE) {
   }
   config.agents.defaults.heartbeat = { ...defaultHeartbeat };
 
-  if (!config.agents.defaults.memorySearch || typeof config.agents.defaults.memorySearch !== "object") {
-    config.agents.defaults.memorySearch = {
-      provider: "openai",
-      model: "text-embedding-3-small",
-      query: {
-        hybrid: true,
-        mmr: { enabled: true, lambda: 0.5 },
-        temporalDecay: { enabled: true, halfLifeDays: 14 },
-      },
-    };
-  }
-
-  if (!config.agents.defaults.contextPruning || typeof config.agents.defaults.contextPruning !== "object") {
-    config.agents.defaults.contextPruning = { cacheTtl: "1h" };
-  }
-
-  if (!config.env || typeof config.env !== "object") config.env = {};
-  if (process.env.OPENAI_API_KEY && !config.env.OPENAI_API_KEY) {
-    // Literal env reference (not the value). The gateway expands ${OPENAI_API_KEY}
-    // at runtime from its process environment. Keeps the secret out of the
-    // config file on disk.
-    config.env.OPENAI_API_KEY = "${OPENAI_API_KEY}";
-  } else if (!process.env.OPENAI_API_KEY && !config.env.OPENAI_API_KEY && typeof console !== "undefined") {
-    console.warn(
-      "[traderclaw] OPENAI_API_KEY not detected in the installer shell. " +
-      "Memory embeddings require it for vector search (text-embedding-3-small, ~$0.02/M tokens).\n" +
-      "Set it and re-run the installer, or add the env ref manually:\n" +
-      "  1) export OPENAI_API_KEY=sk-...\n" +
-      "  2) edit ~/.openclaw/openclaw.json and set env.OPENAI_API_KEY to \"${OPENAI_API_KEY}\"\n" +
-      "  3) openclaw gateway restart"
-    );
-  }
-
   ensureAgentsDefaultsSchemaCompat(config);
   mkdirSync(CONFIG_DIR, { recursive: true });
   writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
@@ -1175,6 +1178,21 @@ function configureGatewayScheduling(modeConfig, configPath = CONFIG_FILE) {
   const cronStorePath = resolveCronJobsStorePath(config);
   const cronMerge = mergeTraderCronJobsIntoStore(cronStorePath, targetJobs);
 
+  let qmdAvailable = false;
+  let qmdVersion = null;
+  try { qmdAvailable = commandExists("qmd"); } catch {}
+  if (qmdAvailable) {
+    qmdVersion = getCommandOutput("qmd --version");
+  } else {
+    if (typeof console !== "undefined") {
+      console.warn(
+        "[traderclaw] QMD binary not found. Memory engine will fall back to SQLite (no vector search, no temporal decay, no MMR).\n" +
+        "Install QMD:  npm install -g @tobilu/qmd\n" +
+        "Then restart the gateway:  openclaw gateway restart"
+      );
+    }
+  }
+
   return {
     configPath,
     agentsConfigured: targetAgents.length,
@@ -1186,6 +1204,8 @@ function configureGatewayScheduling(modeConfig, configPath = CONFIG_FILE) {
     cronJobsStoreError: cronMerge.error,
     removedLegacyCronJobs,
     hooksConfigured: config.hooks.mappings.length,
+    qmdAvailable,
+    qmdVersion,
     isV2,
   };
 }
@@ -1877,9 +1897,9 @@ function verifyInstallation(modeConfig, apiKey) {
       note: heartbeatInWorkspace ? workspaceRoot : `expected ${join(workspaceRoot, "HEARTBEAT.md")}`,
     },
     {
-      label: "Memory engine (builtin, vector + FTS)",
-      ok: true,
-      note: "run `openclaw memory status --deep` to verify index",
+      label: "QMD memory engine (vector search)",
+      ok: commandExists("qmd"),
+      note: "not installed — memory uses keyword search only. Install: npm install -g @tobilu/qmd",
     },
   ];
 }
@@ -2363,6 +2383,40 @@ export class InstallerStepEngine {
       if (!this.options.skipInstallOpenClaw) {
         await this.runStep("install_openclaw", "Installing or upgrading OpenClaw platform", async () => installOpenClawPlatform());
       }
+
+      // Non-fatal: warn when the CLI has devices in pending-approval or repair state.
+      // Gateway >= 1.0.93-beta.0 requires explicit device approval for operator-write scope;
+      // without it, agent trading RPCs silently fail (device gets read-only "repair" state).
+      await this.runStep("device_approval_check", "Checking OpenClaw device approval status", async () => {
+        const check = checkOpenClawDeviceApproval();
+        if (!check.ran) {
+          this.emitLog("device_approval_check", "info", "Device approval check skipped (openclaw CLI not available or devices subcommand not supported).");
+          return { ran: false };
+        }
+        const needsAction = check.pendingIds.length > 0 || check.repairDetected;
+        if (!needsAction) {
+          this.emitLog("device_approval_check", "info", "No pending or repair-state devices found. Device approval OK.");
+          return { ran: true, ok: true };
+        }
+        const lines = [
+          "ACTION REQUIRED — OpenClaw device approval needed.",
+          "The gateway requires explicit device approval for operator-write scope.",
+          "Without it, trading RPCs will fail silently (read-only / repair state).",
+          "",
+          "Run in your VPS shell:",
+          "  openclaw devices list",
+          ...(check.pendingIds.length > 0
+            ? check.pendingIds.map((id) => `  openclaw devices approve ${id}`)
+            : ["  openclaw devices approve <requestId>   # use the id shown above"]),
+          "",
+          check.envTokenSet
+            ? "OPENCLAW_GATEWAY_TOKEN env var is already set — env-first auth will work as a fallback."
+            : "Optionally set: export OPENCLAW_GATEWAY_TOKEN=\"<token>\"   # bypasses device auth entirely",
+        ];
+        this.emitLog("device_approval_check", "warn", lines.join("\n"));
+        return { ran: true, ok: false, pendingIds: check.pendingIds, repairDetected: check.repairDetected, envTokenSet: check.envTokenSet };
+      });
+
       await this.runStep("configure_llm", "Configuring required OpenClaw LLM provider", async () => this.configureLlmStep());
       if (!this.options.skipInstallPlugin) {
         await this.runStep("install_plugin_package", "Installing TraderClaw CLI package", async () =>
@@ -2373,6 +2427,32 @@ export class InstallerStepEngine {
         await this.runStep("openclaw_global_deps", "Ensuring OpenClaw global package dependencies", async () =>
           ensureOpenClawGlobalPackageDependencies(),
         );
+        await this.runStep("install_qmd", "Installing QMD memory engine (vector search)", async () => {
+          if (commandExists("qmd")) {
+            const ver = getCommandOutput("qmd --version");
+            this.emitLog("install_qmd", "info", `QMD already installed: ${ver}`);
+            return { alreadyInstalled: true, version: ver };
+          }
+          this.emitLog("install_qmd", "info", "Installing @tobilu/qmd globally for vector search memory...");
+          try {
+            await runCommandWithEvents("npm", ["install", "-g", "--ignore-scripts", "--registry", "https://registry.npmjs.org/", "@tobilu/qmd"], {
+              onEvent: (evt) => this.emitLog("install_qmd", evt.type === "stderr" ? "warn" : "info", evt.text, evt.urls || []),
+            });
+          } catch (err) {
+            this.emitLog(
+              "install_qmd",
+              "warn",
+              `QMD install failed (non-fatal): ${err?.message || err}. Memory will use keyword search only. You can install manually later: npm install -g @tobilu/qmd`,
+            );
+            return { installed: false, error: err?.message || String(err) };
+          }
+          const available = commandExists("qmd");
+          const ver = available ? getCommandOutput("qmd --version") : null;
+          if (!available) {
+            this.emitLog("install_qmd", "warn", "QMD installed but not on PATH. Memory will use keyword search only.");
+          }
+          return { installed: available, version: ver };
+        });
         await this.runStep(
           "activate_openclaw_plugin",
           "Installing and enabling TraderClaw inside OpenClaw",
@@ -2480,6 +2560,17 @@ export class InstallerStepEngine {
           this.emitLog("gateway_scheduling", "warn", "Removed legacy 'cron.jobs' from openclaw.json to keep config validation compatible.");
         }
         this.emitLog("gateway_scheduling", "info", `Webhook hooks: ${result.hooksConfigured}`);
+        if (!result.qmdAvailable) {
+          this.emitLog(
+            "gateway_scheduling",
+            "warn",
+            "QMD binary not found — memory will use SQLite keyword search only (no vector search, no temporal decay, no MMR). " +
+            "Vector search makes the agent's memory significantly more effective. " +
+            "Install: npm install -g @tobilu/qmd — then restart the gateway: openclaw gateway restart",
+          );
+        } else {
+          this.emitLog("gateway_scheduling", "info", `QMD memory engine: ${result.qmdVersion || "installed"}`);
+        }
         const restart = await restartGateway();
         return { ...result, restart };
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "traderclaw-cli",
-  "version": "1.0.93-beta.0",
+  "version": "1.0.93",
   "description": "Global TraderClaw CLI (install --wizard, setup, precheck). Installs solana-traderclaw as a dependency for OpenClaw plugin files.",
   "type": "module",
   "bin": {
@@ -17,7 +17,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "solana-traderclaw": "^1.0.93-beta.0"
+    "solana-traderclaw": "^1.0.93"
   },
   "keywords": [
     "traderclaw",