clawon 0.1.6 → 0.1.8

package/README.md

@@ -132,6 +132,22 @@ Each archive contains:
 
 Config is stored at `~/.clawon/config.json` after running `clawon login`. Contains your API key, profile ID, and API URL. Run `clawon logout` to remove it.
 
+## Telemetry
+
+Clawon collects anonymous usage events (e.g. "backup created", "restore completed") to understand which features are used. No file contents, filenames, or personal data are sent.
+
+**To opt out**, set either environment variable:
+
+```bash
+# Standard convention (https://consoledonottrack.com)
+export DO_NOT_TRACK=1
+
+# Or Clawon-specific
+export CLAWON_NO_TELEMETRY=1
+```
+
+Telemetry is powered by [PostHog](https://posthog.com). The public project key is visible in the source code.
+
 ## Requirements
 
 - Node.js 18+

package/dist/index.js

@@ -136,7 +136,11 @@ async function extractLocalArchive(archivePath, targetDir) {
   return meta;
 }
 var POSTHOG_KEY = "phc_LGJC4ZrED6EiK0sC1fusErOhR6gHlFCS5Qs7ou93SmV";
+function telemetryDisabled() {
+  return process.env.DO_NOT_TRACK === "1" || process.env.CLAWON_NO_TELEMETRY === "1";
+}
 function trackCliEvent(distinctId, event, properties = {}) {
+  if (telemetryDisabled()) return;
   fetch("https://us.i.posthog.com/capture/", {
     method: "POST",
     headers: { "content-type": "application/json" },
@@ -166,6 +170,7 @@ program.command("login").description("Connect to Clawon with your API key").requ
     });
     console.log("\u2713 Logged in");
     console.log(`  Profile ID: ${connectJson.profileId}`);
+    trackCliEvent(connectJson.profileId, "cli_login");
   } catch (e) {
     console.error(`\u2717 Login failed: ${e.message}`);
     process.exit(1);
@@ -346,6 +351,7 @@ program.command("list").description("List your backups").option("--limit <n>", "
     }
     console.log(`
 Total: ${snapshots.length} backup(s)`);
+    trackCliEvent(cfg.profileId, "cli_list_viewed", { count: snapshots.length });
   } catch (e) {
     console.error(`\u2717 Failed to list backups: ${e.message}`);
     process.exit(1);
@@ -403,6 +409,7 @@ program.command("activity").description("Show recent activity").option("--limit
       const details = formatEventDetails(ev.payload);
       console.log(`${date.padEnd(20)} | ${label.padEnd(18)} | ${details}`);
     }
+    trackCliEvent(cfg.profileId, "cli_activity_viewed");
   } catch (e) {
     console.error(`\u2717 Failed to load activity: ${e.message}`);
     process.exit(1);
@@ -442,6 +449,7 @@ program.command("delete [id]").description("Delete a snapshot").option("--oldest
       snapshotId
     });
     console.log(`\u2713 Deleted snapshot ${snapshotId}`);
+    trackCliEvent(cfg.profileId, "cloud_backup_deleted");
   } catch (e) {
     console.error(`\u2717 Delete failed: ${e.message}`);
     process.exit(1);
@@ -476,6 +484,8 @@ program.command("discover").description("Preview which files would be included i
   console.log(`
 Total: ${files.length} files (${(totalSize / 1024).toFixed(1)} KB)`);
   console.log(`Source: ${OPENCLAW_DIR}`);
+  const cfg = readConfig();
+  trackCliEvent(cfg?.profileId || "anonymous", "cli_discover", { file_count: files.length });
 });
 program.command("files").description("List files in a backup").option("--snapshot <id>", "Snapshot ID (default: latest)").action(async (opts) => {
   const cfg = readConfig();
@@ -512,6 +522,7 @@ program.command("files").description("List files in a backup").option("--snapsho
     }
     console.log(`
 Total: ${files.length} files`);
+    trackCliEvent(cfg.profileId, "cli_files_viewed", { file_count: files.length });
   } catch (e) {
     console.error(`\u2717 Failed to list files: ${e.message}`);
     process.exit(1);
@@ -580,6 +591,8 @@ local.command("list").description("List local backups").action(async () => {
   }
   console.log(`
 Total: ${entries.length} backup(s)`);
+  const cfg = readConfig();
+  trackCliEvent(cfg?.profileId || "anonymous", "local_list_viewed", { count: entries.length });
   console.log(`
 Restore a backup:`);
   console.log(`  clawon local restore              Restore the latest backup (#1)`);
@@ -658,11 +671,14 @@ program.command("status").description("Show current status").action(async () =>
   } else {
     console.log(`\u2717 OpenClaw not found: ${OPENCLAW_DIR}`);
   }
+  trackCliEvent(cfg?.profileId || "anonymous", "cli_status_viewed");
 });
 program.command("logout").description("Remove local credentials").action(() => {
+  const cfg = readConfig();
   if (fs.existsSync(CONFIG_PATH)) {
     fs.unlinkSync(CONFIG_PATH);
     console.log("\u2713 Logged out");
+    trackCliEvent(cfg?.profileId || "anonymous", "cli_logout");
   } else {
     console.log("Already logged out");
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawon",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Backup and restore your OpenClaw workspace",
   "type": "module",
   "bin": {