openclaw-helper 0.3.5 → 0.4.0

package/dist/{chunk-LJXPQKQB.js → chunk-UXL57WT4.js}

@@ -514,7 +514,7 @@ function scanCosts(agents) {
 }
 
 // src/dashboard/server.ts
-var _PKG_VER = true ? "0.3.5" : "0.2.1";
+var _PKG_VER = true ? "0.4.0" : "0.2.1";
 var pkgVersion = _PKG_VER;
 function readDoctorLogs(maxLines = 50) {
   if (!existsSync6(DOCTOR_LOG_DIR)) return [];
@@ -614,6 +614,11 @@ function renderShell() {
       <span class="status-dot" :style="'background:' + statusColor"></span>
       <span class="status-label" :style="'color:' + statusColor" x-text="statusText"></span>
     </div>
+    <div class="nav-actions" style="display:flex;gap:0.5rem;align-items:center;">
+      <button class="btn" style="background:#00A67E;color:#fff;padding:0.35rem 0.75rem;font-size:0.75rem;" :disabled="actionLoading" @click="doStart()">\u25B6 Start</button>
+      <button class="btn btn-blue" style="padding:0.35rem 0.75rem;font-size:0.75rem;" :disabled="actionLoading" @click="doRestart()">\u21BA Restart</button>
+      <button class="btn" style="background:#ef4444;color:#fff;padding:0.35rem 0.75rem;font-size:0.75rem;" :disabled="actionLoading" @click="doStop()">\u25A0 Stop</button>
+    </div>
     <div class="nav-right" x-text="lastCheck ? 'Updated ' + lastCheck : 'Loading...'"></div>
   </div>
 
@@ -941,6 +946,34 @@ function renderShell() {
           this.actionLoading = false;
         },
 
+        async doStart() {
+          this.actionLoading = true;
+          this.actionResult = '';
+          try {
+            const res = await fetch('/api/gateway/start', { method: 'POST' });
+            const d = await res.json();
+            this.actionResult = d.success ? 'Gateway started.' : ('Start failed: ' + (d.message ?? 'unknown'));
+            await this.refresh();
+          } catch (e) {
+            this.actionResult = 'Request failed: ' + e.message;
+          }
+          this.actionLoading = false;
+        },
+
+        async doStop() {
+          this.actionLoading = true;
+          this.actionResult = '';
+          try {
+            const res = await fetch('/api/gateway/stop', { method: 'POST' });
+            const d = await res.json();
+            this.actionResult = d.success ? 'Gateway stopped.' : ('Stop failed: ' + (d.message ?? 'unknown'));
+            await this.refresh();
+          } catch (e) {
+            this.actionResult = 'Request failed: ' + e.message;
+          }
+          this.actionLoading = false;
+        },
+
         async doDoctor() {
           this.actionLoading = true;
           this.actionResult = '';
@@ -1011,6 +1044,26 @@ async function handleApiRestart(info, res) {
     res.end(JSON.stringify({ success: false, message: String(err) }));
   }
 }
+async function handleApiGatewayStart(info, res) {
+  try {
+    const result = await startGateway(info);
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ success: result.success, message: result.output ?? result.error ?? "" }));
+  } catch (err) {
+    res.writeHead(500, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ success: false, message: String(err) }));
+  }
+}
+async function handleApiGatewayStop(info, res) {
+  try {
+    const result = await stopGateway(info);
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ success: result.success, message: result.output ?? result.error ?? "" }));
+  } catch (err) {
+    res.writeHead(500, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ success: false, message: String(err) }));
+  }
+}
 async function handleApiDoctor(info, res) {
   try {
     const output = await runOpenClawCmd(info, "doctor --non-interactive");
@@ -1055,6 +1108,10 @@ function startDashboard(options) {
       handleApiLogs(res);
     } else if (method === "POST" && url === "/api/restart") {
       await handleApiRestart(info, res);
+    } else if (method === "POST" && url === "/api/gateway/start") {
+      await handleApiGatewayStart(info, res);
+    } else if (method === "POST" && url === "/api/gateway/stop") {
+      await handleApiGatewayStop(info, res);
     } else if (method === "POST" && url === "/api/doctor") {
       await handleApiDoctor(info, res);
     } else {
@@ -1073,6 +1130,7 @@ function startDashboard(options) {
 export {
   __require,
   BINARY_NAME,
+  APP_HOME,
   DISPLAY_NAME,
   DOCTOR_LOG_DIR,
   PID_FILE,

package/dist/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  APP_HOME,
   BINARY_NAME,
   DISPLAY_NAME,
   DOCTOR_LOG_DIR,
@@ -17,7 +18,7 @@ import {
   startDashboard,
   startGateway,
   stopGateway
-} from "./chunk-LJXPQKQB.js";
+} from "./chunk-UXL57WT4.js";
 
 // src/index.ts
 import { spawnSync } from "child_process";
@@ -25,9 +26,137 @@ import { Command } from "commander";
 
 // src/commands/watch.ts
 import { spawn } from "child_process";
-import { writeFileSync, readFileSync, existsSync, unlinkSync, openSync } from "fs";
+import { writeFileSync as writeFileSync2, readFileSync as readFileSync2, existsSync as existsSync2, unlinkSync, openSync } from "fs";
 import chalk from "chalk";
+import { join as join2 } from "path";
+
+// src/telemetry.ts
+import { createHash, randomUUID } from "crypto";
+import { execSync } from "child_process";
+import { readFileSync, writeFileSync, existsSync } from "fs";
 import { join } from "path";
+var MEASUREMENT_ID = "G-B46J8RT804";
+var API_SECRET = "qkqms1nURj2S02Q3WqO7GQ";
+var ENDPOINT = `https://www.google-analytics.com/mp/collect?measurement_id=${MEASUREMENT_ID}&api_secret=${API_SECRET}`;
+var TELEMETRY_FILE = join(APP_HOME, "telemetry.json");
+function loadState() {
+  if (existsSync(TELEMETRY_FILE)) {
+    try {
+      return JSON.parse(readFileSync(TELEMETRY_FILE, "utf-8"));
+    } catch {
+    }
+  }
+  const state = {
+    client_id: resolveClientId(),
+    opt_out: false,
+    first_run_notified: false
+  };
+  saveState(state);
+  return state;
+}
+function saveState(state) {
+  try {
+    writeFileSync(TELEMETRY_FILE, JSON.stringify(state, null, 2) + "\n");
+  } catch {
+  }
+}
+function sha256(input) {
+  return createHash("sha256").update(input).digest("hex");
+}
+function tryExec(cmd) {
+  try {
+    return execSync(cmd, { stdio: ["ignore", "pipe", "ignore"], timeout: 2e3 }).toString().trim();
+  } catch {
+    return null;
+  }
+}
+function resolveClientId() {
+  const gitEmail = tryExec("git config --global user.email");
+  if (gitEmail && gitEmail.includes("@")) return "git:" + sha256(gitEmail);
+  const npmEmail = tryExec("npm config get email");
+  if (npmEmail && npmEmail.includes("@")) return "npm:" + sha256(npmEmail);
+  return "anon:" + randomUUID();
+}
+function isOptedOut() {
+  if (process.env.OPENCLAW_NO_TELEMETRY === "1") return true;
+  if (process.env.DO_NOT_TRACK === "1") return true;
+  if (process.env.CI) return true;
+  try {
+    const state = loadState();
+    return state.opt_out;
+  } catch {
+    return false;
+  }
+}
+function setOptOut(value) {
+  const state = loadState();
+  state.opt_out = value;
+  saveState(state);
+}
+function getTelemetryStatus() {
+  const state = loadState();
+  return { optOut: state.opt_out, clientId: state.client_id };
+}
+function printFirstRunNotice() {
+  const state = loadState();
+  if (state.first_run_notified || state.opt_out) return;
+  state.first_run_notified = true;
+  saveState(state);
+  process.stderr.write(
+    "\n  \u{1F4CA} OpenClaw collects anonymous usage data to improve the product.\n     To opt out: openclaw telemetry off  (or set OPENCLAW_NO_TELEMETRY=1)\n\n"
+  );
+}
+async function track(eventName, opts) {
+  if (isOptedOut()) return;
+  let state;
+  try {
+    state = loadState();
+  } catch {
+    return;
+  }
+  const params = {
+    platform: opts.platform,
+    engagement_time_msec: 1,
+    ...opts.command !== void 0 && { command: opts.command },
+    ...opts.success !== void 0 && { success: opts.success ? 1 : 0 },
+    ...opts.version !== void 0 && { app_version: opts.version },
+    ...opts.os !== void 0 && { os_type: opts.os },
+    ...opts.extra
+  };
+  const payload = {
+    client_id: state.client_id,
+    non_personalized_ads: true,
+    events: [
+      {
+        name: eventName,
+        params
+      }
+    ]
+  };
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 3e3);
+    await fetch(ENDPOINT, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload),
+      signal: controller.signal
+    });
+    clearTimeout(timer);
+  } catch {
+  }
+}
+async function trackCommand(command, success, version2) {
+  await track("cli_command", {
+    platform: "cli",
+    command,
+    success,
+    version: version2,
+    os: process.platform
+  });
+}
+
+// src/commands/watch.ts
 async function watchDaemon(options) {
   if (options.daemon) {
     return daemonize(options);
@@ -36,14 +165,16 @@ async function watchDaemon(options) {
   initLogger();
   ensureDoctorHome();
   const info = detectOpenClaw(options.profile ?? config.openclawProfile);
-  writeFileSync(PID_FILE, String(process.pid));
+  writeFileSync2(PID_FILE, String(process.pid));
+  trackCommand("watch start", true).catch(() => {
+  });
   log("info", "OpenClaw Doctor started (foreground)");
   log("info", `Gateway port: ${info.gatewayPort}`);
   log("info", `Channels: ${info.channels.join(", ") || "none detected"}`);
   log("info", `Check interval: ${config.checkInterval}s`);
   log("info", `PID: ${process.pid}`);
   if (options.dashboard) {
-    const { startDashboard: startDashboard2 } = await import("./server-BR52HPJB.js");
+    const { startDashboard: startDashboard2 } = await import("./server-GZ3MD6AH.js");
     startDashboard2({ config: options.config });
   }
   const throttle = new RestartThrottle(config.maxRestartsPerHour);
@@ -105,8 +236,8 @@ function daemonize(options) {
     (a) => a !== "-d" && a !== "--daemon"
   );
   const fullArgs = [...execArgv, ...scriptArgs];
-  const outLog = join(DOCTOR_LOG_DIR, "daemon.out.log");
-  const errLog = join(DOCTOR_LOG_DIR, "daemon.err.log");
+  const outLog = join2(DOCTOR_LOG_DIR, "daemon.out.log");
+  const errLog = join2(DOCTOR_LOG_DIR, "daemon.err.log");
   const out = openSync(outLog, "a");
   const err = openSync(errLog, "a");
   const child = spawn(process.execPath, fullArgs, {
@@ -115,7 +246,7 @@ function daemonize(options) {
     env: { ...process.env, OPENCLAW_DOCTOR_DAEMON: "1" }
   });
   const pid = child.pid;
-  writeFileSync(PID_FILE, String(pid));
+  writeFileSync2(PID_FILE, String(pid));
   child.unref();
   console.log(chalk.green(`Doctor started in background (PID ${pid})`));
   console.log(chalk.gray(`  Logs: ${outLog}`));
@@ -138,8 +269,12 @@ async function stopDaemon(options) {
   try {
     process.kill(pid, "SIGTERM");
     console.log(chalk.green(`Doctor stopped (PID ${pid})`));
+    trackCommand("watch stop", true).catch(() => {
+    });
   } catch (err) {
     console.log(chalk.red(`Failed to stop Doctor (PID ${pid}): ${err}`));
+    trackCommand("watch stop", false).catch(() => {
+    });
   }
   await new Promise((r) => setTimeout(r, 1e3));
   try {
@@ -148,8 +283,8 @@ async function stopDaemon(options) {
   }
 }
 function readDaemonPid() {
-  if (!existsSync(PID_FILE)) return null;
-  const raw = readFileSync(PID_FILE, "utf-8").trim();
+  if (!existsSync2(PID_FILE)) return null;
+  const raw = readFileSync2(PID_FILE, "utf-8").trim();
   const pid = parseInt(raw, 10);
   return isNaN(pid) ? null : pid;
 }
@@ -224,17 +359,19 @@ async function showStatus(options) {
   console.log(chalk2.gray(`  OpenClaw ${info.version ?? "unknown"}`));
   console.log(chalk2.gray(`  Config: ${info.configPath}`));
   console.log();
+  trackCommand("status", true).catch(() => {
+  });
   process.exit(result.healthy ? 0 : 1);
 }
 
 // src/commands/doctor.ts
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2 } from "fs";
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync3 } from "fs";
 import chalk3 from "chalk";
 function findConfigIssues(configPath) {
-  if (!existsSync2(configPath)) return [];
+  if (!existsSync3(configPath)) return [];
   let raw;
   try {
-    raw = JSON.parse(readFileSync2(configPath, "utf-8"));
+    raw = JSON.parse(readFileSync3(configPath, "utf-8"));
   } catch {
     return [{ path: "root", message: "Config file is not valid JSON", fix: () => {
     } }];
@@ -261,7 +398,7 @@ function findConfigIssues(configPath) {
       const origFix = originalFixes[i];
       issues[i].fix = () => {
         origFix();
-        writeFileSync2(configPath, JSON.stringify(raw, null, 2) + "\n");
+        writeFileSync3(configPath, JSON.stringify(raw, null, 2) + "\n");
       };
     }
   }
@@ -346,11 +483,13 @@ async function runDoctor(options) {
       console.log(chalk3.green("    Gateway healthy \u2014 no repair needed"));
     }
   }
+  trackCommand("doctor", true).catch(() => {
+  });
   console.log();
 }
 
 // src/commands/logs.ts
-import { readFileSync as readFileSync3, existsSync as existsSync3 } from "fs";
+import { readFileSync as readFileSync4, existsSync as existsSync4 } from "fs";
 import chalk4 from "chalk";
 function showLogs(options) {
   const config = loadConfig(options.config);
@@ -361,14 +500,14 @@ function showLogs(options) {
   }
   const info = detectOpenClaw(options.profile ?? config.openclawProfile);
   const logFile = options.error ? `${info.logDir}/gateway.err.log` : `${info.logDir}/gateway.log`;
-  if (!existsSync3(logFile)) {
+  if (!existsSync4(logFile)) {
     console.log(chalk4.yellow(`Log file not found: ${logFile}`));
     return;
   }
   console.log(chalk4.blue.bold(`
   ${logFile}
 `));
-  const content = readFileSync3(logFile, "utf-8");
+  const content = readFileSync4(logFile, "utf-8");
   const lines = content.trim().split("\n");
   const tail = lines.slice(-maxLines);
   for (const line of tail) {
@@ -384,8 +523,8 @@ function showLogs(options) {
 }
 function showDoctorLogs(maxLines) {
   const { readdirSync } = __require("fs");
-  const { join: join3 } = __require("path");
-  if (!existsSync3(DOCTOR_LOG_DIR)) {
+  const { join: join4 } = __require("path");
+  if (!existsSync4(DOCTOR_LOG_DIR)) {
     console.log(chalk4.yellow("No doctor logs found."));
     return;
   }
@@ -396,9 +535,9 @@ function showDoctorLogs(maxLines) {
   }
   const latest = files[0];
   console.log(chalk4.blue.bold(`
-  ${join3(DOCTOR_LOG_DIR, latest)}
+  ${join4(DOCTOR_LOG_DIR, latest)}
 `));
-  const content = readFileSync3(join3(DOCTOR_LOG_DIR, latest), "utf-8");
+  const content = readFileSync4(join4(DOCTOR_LOG_DIR, latest), "utf-8");
   const lines = content.trim().split("\n");
   const tail = lines.slice(-maxLines);
   for (const line of tail) {
@@ -417,6 +556,7 @@ function showDoctorLogs(maxLines) {
 
 // src/commands/gateway.ts
 import chalk5 from "chalk";
+var _VER = true ? "0.4.0" : void 0;
 async function gatewayStart(options) {
   const config = loadConfig(options.config);
   initLogger();
@@ -424,8 +564,12 @@ async function gatewayStart(options) {
   const result = await startGateway(info);
   if (result.success) {
     console.log(chalk5.green("Gateway started"));
+    trackCommand("gateway start", true, _VER).catch(() => {
+    });
   } else {
     console.log(chalk5.red(`Failed to start gateway: ${result.error}`));
+    trackCommand("gateway start", false, _VER).catch(() => {
+    });
     process.exit(1);
   }
 }
@@ -436,8 +580,12 @@ async function gatewayStop(options) {
   const result = await stopGateway(info);
   if (result.success) {
     console.log(chalk5.green("Gateway stopped"));
+    trackCommand("gateway stop", true, _VER).catch(() => {
+    });
   } else {
     console.log(chalk5.red(`Failed to stop gateway: ${result.error}`));
+    trackCommand("gateway stop", false, _VER).catch(() => {
+    });
     process.exit(1);
   }
 }
@@ -448,19 +596,23 @@ async function gatewayRestart(options) {
   const result = await restartGateway(info);
   if (result.success) {
     console.log(chalk5.green("Gateway restarted"));
+    trackCommand("gateway restart", true, _VER).catch(() => {
+    });
   } else {
     console.log(chalk5.red(`Failed to restart gateway: ${result.error}`));
+    trackCommand("gateway restart", false, _VER).catch(() => {
+    });
     process.exit(1);
   }
 }
 
 // src/commands/memory.ts
 import chalk6 from "chalk";
-import { existsSync as existsSync4, statSync } from "fs";
-import { join as join2 } from "path";
+import { existsSync as existsSync5, statSync } from "fs";
+import { join as join3 } from "path";
 import { homedir } from "os";
 function expandHome(p) {
-  return p.startsWith("~/") ? join2(homedir(), p.slice(2)) : p;
+  return p.startsWith("~/") ? join3(homedir(), p.slice(2)) : p;
 }
 async function memoryStatus(options) {
   const config = loadConfig(options.config);
@@ -470,8 +622,8 @@ async function memoryStatus(options) {
     const ws = agent.workspace;
     if (!ws) continue;
     const wsPath = expandHome(ws);
-    const memPath = join2(wsPath, "MEMORY.md");
-    const exists = existsSync4(memPath);
+    const memPath = join3(wsPath, "MEMORY.md");
+    const exists = existsSync5(memPath);
     const sizeKB = exists ? Math.round(statSync(memPath).size / 1024) : 0;
     const warn = sizeKB > 50;
     const indicator = warn ? chalk6.yellow("\u26A0") : chalk6.green("\u2713");
@@ -510,9 +662,30 @@ async function memoryCompact(options) {
   console.log();
 }
 
+// src/commands/telemetry.ts
+import chalk7 from "chalk";
+function telemetryOn() {
+  setOptOut(false);
+  console.log(chalk7.green("\u2713 Telemetry enabled. Thanks for helping improve OpenClaw!"));
+}
+function telemetryOff() {
+  setOptOut(true);
+  console.log(chalk7.yellow("\u2713 Telemetry disabled. Set OPENCLAW_NO_TELEMETRY=1 to suppress permanently."));
+}
+function telemetryStatus() {
+  const { optOut, clientId } = getTelemetryStatus();
+  const status = optOut ? chalk7.red("disabled") : chalk7.green("enabled");
+  console.log(`Telemetry: ${status}`);
+  console.log(`Client ID: ${chalk7.dim(clientId)}`);
+  console.log();
+  console.log(chalk7.dim("Toggle: openclaw telemetry on/off"));
+  console.log(chalk7.dim("Env:    OPENCLAW_NO_TELEMETRY=1"));
+}
+
 // src/index.ts
-var _PKG_VER = true ? "0.3.5" : "0.2.1";
+var _PKG_VER = true ? "0.4.0" : "0.2.1";
 var version = _PKG_VER;
+printFirstRunNotice();
 var program = new Command();
 program.name(BINARY_NAME).description(`${DISPLAY_NAME} \u2014 health monitor and management for OpenClaw services`).version(version);
 var addGlobalOpts = (cmd) => cmd.option("-c, --config <path>", "Path to config file").option("--profile <name>", "OpenClaw profile (default, dev, ...)", "default");
@@ -535,6 +708,10 @@ var gw = program.command("gateway").description("Manage the OpenClaw gateway ser
 addGlobalOpts(gw.command("start").description("Start the gateway")).action(gatewayStart);
 addGlobalOpts(gw.command("stop").description("Stop the gateway")).action(gatewayStop);
 addGlobalOpts(gw.command("restart").description("Restart the gateway")).action(gatewayRestart);
+var tele = program.command("telemetry").description("Manage anonymous usage telemetry");
+tele.command("on").description("Enable telemetry").action(telemetryOn);
+tele.command("off").description("Disable telemetry").action(telemetryOff);
+tele.command("status").description("Show telemetry status").action(telemetryStatus);
 var mem = program.command("memory").description("Memory file health and management");
 addGlobalOpts(mem.command("status").description("Show MEMORY.md size and health per agent")).action(memoryStatus);
 addGlobalOpts(

package/dist/{server-BR52HPJB.js → server-GZ3MD6AH.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   startDashboard
-} from "./chunk-LJXPQKQB.js";
+} from "./chunk-UXL57WT4.js";
 export {
   startDashboard
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-helper",
-  "version": "0.3.5",
+  "version": "0.4.0",
   "description": "AI assistant gateway watchdog — alias for openclaw-cli. Visit https://openclaw-cli.app",
   "type": "module",
   "bin": {