traderclaw-cli 1.0.66 → 1.0.69

package/bin/installer-step-engine.mjs

@@ -199,6 +199,38 @@ const NO_COLOR_ENV = { ...process.env, NO_COLOR: "1", FORCE_COLOR: "0" };
  * every gateway restart and group messages are dropped. Wizard onboarding targets DMs first; set
  * explicit "open" unless the user already configured sender allowlists.
  */
+/**
+ * Write Telegram bot token directly to openclaw.json.
+ *
+ * `openclaw channels add --channel telegram` was removed — the Telegram plugin
+ * no longer exports register/activate, so the CLI rejects that call with
+ * "telegram missing register/activate export / Channel telegram does not support add."
+ *
+ * The current OpenClaw approach (docs.openclaw.ai/channels/telegram):
+ *   channels.telegram.botToken = "<token>"   → token source
+ *   channels.telegram.enabled  = true        → enable the channel
+ *   channels.telegram.dmPolicy = "pairing"   → safe default (user approves first DM)
+ */
+function writeTelegramChannelConfig(botToken, configPath = CONFIG_FILE) {
+  let config = {};
+  try {
+    config = JSON.parse(readFileSync(configPath, "utf-8"));
+  } catch {
+    config = {};
+  }
+  if (!config.channels || typeof config.channels !== "object") config.channels = {};
+  if (!config.channels.telegram || typeof config.channels.telegram !== "object") config.channels.telegram = {};
+  config.channels.telegram.enabled = true;
+  config.channels.telegram.botToken = botToken;
+  // Only set dmPolicy if not already configured (preserve existing policy on re-installs).
+  if (!config.channels.telegram.dmPolicy) {
+    config.channels.telegram.dmPolicy = "pairing";
+  }
+  ensureAgentsDefaultsSchemaCompat(config);
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+
 function ensureTelegramGroupPolicyOpenForWizard(configPath = CONFIG_FILE) {
   if (!existsSync(configPath)) return { changed: false };
   let config = {};
@@ -1340,6 +1372,58 @@ function ensureAgentsDefaultsSchemaCompat(config) {
 }
 
 /** Re-read config from disk and re-apply defaults shape before gateway/plugin commands that validate the file. */
+/**
+ * Proactively writes the minimum gateway fields required for OpenClaw to start.
+ *
+ * OpenClaw (post-2025) requires `gateway.mode` to be explicitly set to "local"
+ * before `openclaw gateway install` / `gateway restart` are called — the service
+ * crashes immediately at launch when the field is absent, producing
+ * "service stayed stopped / health checks never came up".
+ *
+ * We write these proactively rather than waiting for the first failure and
+ * hoping auto-recovery catches it, because newer OpenClaw validates the config
+ * during `gateway install` itself, before the process even starts.
+ */
+function ensureGatewayBootstrapDefaults(configPath = CONFIG_FILE, log = () => {}) {
+  let config = {};
+  try {
+    config = JSON.parse(readFileSync(configPath, "utf-8"));
+  } catch {
+    config = {};
+  }
+
+  if (!config.gateway || typeof config.gateway !== "object") {
+    config.gateway = {};
+  }
+
+  const changed = [];
+  if (!config.gateway.mode) {
+    config.gateway.mode = "local";
+    changed.push("gateway.mode=local");
+  }
+  if (!config.gateway.bind) {
+    config.gateway.bind = "loopback";
+    changed.push("gateway.bind=loopback");
+  }
+  if (!Number.isInteger(config.gateway.port)) {
+    config.gateway.port = 18789;
+    changed.push("gateway.port=18789");
+  }
+
+  ensureAgentsDefaultsSchemaCompat(config);
+
+  if (changed.length > 0) {
+    log(`Gateway bootstrap: pre-writing required config fields: ${changed.join(", ")}`);
+  }
+
+  try {
+    mkdirSync(dirname(configPath), { recursive: true });
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  } catch (err) {
+    log(`Gateway bootstrap: could not write config defaults (${err?.message || err}) — will proceed anyway`);
+  }
+}
+
 function normalizeOpenClawConfigFileShape(configPath = CONFIG_FILE) {
   let config = {};
   try {
@@ -1738,9 +1822,15 @@ export class InstallerStepEngine {
         "Telegram token is required for this installer flow. Add your bot token in the wizard and start again.",
       );
     }
-    await runCommandWithEvents("openclaw", ["plugins", "enable", "telegram"]);
-    await runCommandWithEvents("openclaw", ["channels", "add", "--channel", "telegram", "--token", this.options.telegramToken]);
-    await runCommandWithEvents("openclaw", ["channels", "status", "--probe"]);
+
+    // OpenClaw no longer supports `openclaw channels add --channel telegram`.
+    // The Telegram plugin does not export register/activate, so that command
+    // fails with "telegram missing register/activate export / Channel telegram
+    // does not support add."  The current documented approach is to write the
+    // bot token directly to openclaw.json — see docs.openclaw.ai/channels/telegram.
+    writeTelegramChannelConfig(this.options.telegramToken, CONFIG_FILE);
+    this.emitLog("telegram_required", "info", "Telegram bot token written to openclaw.json (channels.telegram.botToken).");
+
     const policy = ensureTelegramGroupPolicyOpenForWizard();
     if (policy.changed) {
       this.emitLog(
@@ -1749,6 +1839,14 @@ export class InstallerStepEngine {
         "Set channels.telegram.groupPolicy=open (no sender allowlist yet) to avoid Doctor allowlist warnings on gateway restart. Tighten groupAllowFrom later if you use groups.",
       );
     }
+
+    // Probe channel status for visibility — best-effort, don't fail the step.
+    try {
+      await runCommandWithEvents("openclaw", ["channels", "status", "--probe"]);
+    } catch {
+      this.emitLog("telegram_required", "warn", "channels status --probe did not complete (gateway may not be fully up yet). Token is written and will be active after gateway restart.");
+    }
+
     return { configured: true };
   }
 
@@ -1876,7 +1974,12 @@ export class InstallerStepEngine {
         });
         await this.runStep("gateway_bootstrap", "Starting OpenClaw gateway and Funnel", async () => {
           try {
-            normalizeOpenClawConfigFileShape(CONFIG_FILE);
+            // Ensure required gateway fields are present BEFORE install/restart.
+            // OpenClaw now requires gateway.mode="local" to be explicitly set;
+            // without it the service crashes immediately at startup.
+            ensureGatewayBootstrapDefaults(CONFIG_FILE, (msg) =>
+              this.emitLog("gateway_bootstrap", "info", msg),
+            );
             await this.runWithPrivilegeGuidance("gateway_bootstrap", "openclaw", ["gateway", "install"]);
             await this.runWithPrivilegeGuidance("gateway_bootstrap", "openclaw", ["gateway", "restart"]);
             return this.runFunnel();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "traderclaw-cli",
-  "version": "1.0.66",
+  "version": "1.0.69",
   "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.66"
+    "solana-traderclaw": "^1.0.69"
   },
   "keywords": [
     "traderclaw",