clawon 0.1.7 → 0.1.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clawon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -21,6 +21,7 @@ Local backups are stored in `~/.clawon/backups/` as standard `.tar.gz` archives.
 # Create a backup
 npx clawon local backup
 npx clawon local backup --tag "before migration"
+npx clawon local backup --include-memory-db  # Include SQLite memory index
 
 # List all local backups
 npx clawon local list
@@ -43,6 +44,7 @@ npx clawon login --api-key <your-key>
 npx clawon backup
 npx clawon backup --tag "stable config"
 npx clawon backup --dry-run             # Preview without uploading
+npx clawon backup --include-memory-db   # Requires Pro account
 
 # List cloud backups
 npx clawon list
@@ -63,6 +65,7 @@ npx clawon activity                     # Recent events
 
 ```bash
 npx clawon discover    # Show exactly which files would be backed up
+npx clawon discover --include-memory-db  # Include SQLite memory index
 npx clawon status      # Connection status and file count
 npx clawon logout      # Remove local credentials
 ```
@@ -93,7 +96,7 @@ These are **always excluded**, even if they match an include pattern:
 | `openclaw.json` | May contain credentials |
 | `agents/*/sessions/**` | Ephemeral session data |
 | `memory/lancedb/**` | Vector database (binary, large) |
-| `memory/*.sqlite` | SQLite databases |
+| `memory/*.sqlite` | SQLite databases (use `--include-memory-db` to include) |
 | `*.lock`, `*.wal`, `*.shm` | Database lock files |
 | `node_modules/**` | Dependencies |
 

package/dist/index.js

@@ -61,7 +61,10 @@ function matchGlob(filePath, pattern) {
   let regexPattern = pattern.replace(/\./g, "\\.").replace(/\*\*\//g, "(.*/)?").replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*");
   return new RegExp(`^${regexPattern}$`).test(filePath);
 }
-function shouldInclude(relativePath) {
+function shouldInclude(relativePath, includeMemoryDb = false) {
+  if (includeMemoryDb && matchGlob(relativePath, "memory/*.sqlite")) {
+    return true;
+  }
   for (const pattern of EXCLUDE_PATTERNS) {
     if (matchGlob(relativePath, pattern)) return false;
   }
@@ -70,7 +73,7 @@ function shouldInclude(relativePath) {
   }
   return false;
 }
-function discoverFiles(baseDir) {
+function discoverFiles(baseDir, includeMemoryDb = false) {
   const files = [];
   function walk(dir, relativePath = "") {
     if (!fs.existsSync(dir)) return;
@@ -81,7 +84,7 @@ function discoverFiles(baseDir) {
       if (entry.isDirectory()) {
         walk(fullPath, relPath);
       } else if (entry.isFile()) {
-        if (shouldInclude(relPath)) {
+        if (shouldInclude(relPath, includeMemoryDb)) {
           const stats = fs.statSync(fullPath);
           files.push({
             path: relPath,
@@ -94,12 +97,13 @@ function discoverFiles(baseDir) {
   walk(baseDir);
   return files;
 }
-async function createLocalArchive(files, openclawDir, outputPath, tag) {
+async function createLocalArchive(files, openclawDir, outputPath, tag, includeMemoryDb) {
   const meta = {
     version: 2,
     created: (/* @__PURE__ */ new Date()).toISOString(),
     ...tag ? { tag } : {},
-    file_count: files.length
+    file_count: files.length,
+    ...includeMemoryDb ? { include_memory_db: true } : {}
   };
   const metaPath = path.join(openclawDir, "_clawon_meta.json");
   fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2));
@@ -170,12 +174,17 @@ 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);
   }
 });
-program.command("backup").description("Backup your OpenClaw workspace to the cloud").option("--dry-run", "Show what would be backed up without uploading").option("--tag <label>", "Add a label to this backup").action(async (opts) => {
+program.command("backup").description("Backup your OpenClaw workspace to the cloud").option("--dry-run", "Show what would be backed up without uploading").option("--tag <label>", "Add a label to this backup").option("--include-memory-db", "Include SQLite memory index").action(async (opts) => {
+  if (opts.includeMemoryDb) {
+    console.error("\u2717 Memory DB backup requires a Pro account. Use `clawon local backup --include-memory-db` for local backups.");
+    process.exit(1);
+  }
   const cfg = readConfig();
   if (!cfg) {
     console.error("\u2717 Not logged in. Run: clawon login --api-key <key>");
@@ -247,7 +256,8 @@ program.command("backup").description("Backup your OpenClaw workspace to the clo
     console.log(`  Size: ${(totalSize / 1024).toFixed(1)} KB`);
     trackCliEvent(cfg.profileId, "cloud_backup_created", {
       file_count: files.length,
-      total_bytes: totalSize
+      total_bytes: totalSize,
+      include_memory_db: !!opts.includeMemoryDb
     });
   } catch (e) {
     const msg = e.message;
@@ -350,6 +360,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);
@@ -407,6 +418,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);
@@ -446,17 +458,18 @@ 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);
   }
 });
-program.command("discover").description("Preview which files would be included in a backup").action(async () => {
+program.command("discover").description("Preview which files would be included in a backup").option("--include-memory-db", "Include SQLite memory index").action(async (opts) => {
   if (!fs.existsSync(OPENCLAW_DIR)) {
     console.error(`\u2717 OpenClaw directory not found: ${OPENCLAW_DIR}`);
     process.exit(1);
   }
-  const files = discoverFiles(OPENCLAW_DIR);
+  const files = discoverFiles(OPENCLAW_DIR, !!opts.includeMemoryDb);
   if (files.length === 0) {
     console.log("No files matched the include patterns.");
     return;
@@ -480,6 +493,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, include_memory_db: !!opts.includeMemoryDb });
 });
 program.command("files").description("List files in a backup").option("--snapshot <id>", "Snapshot ID (default: latest)").action(async (opts) => {
   const cfg = readConfig();
@@ -516,19 +531,20 @@ 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);
   }
 });
 var local = program.command("local").description("Local backup and restore (no cloud required)");
-local.command("backup").description("Save a local backup of your OpenClaw workspace").option("--tag <label>", "Add a label to this backup").action(async (opts) => {
+local.command("backup").description("Save a local backup of your OpenClaw workspace").option("--tag <label>", "Add a label to this backup").option("--include-memory-db", "Include SQLite memory index").action(async (opts) => {
   if (!fs.existsSync(OPENCLAW_DIR)) {
     console.error(`\u2717 OpenClaw directory not found: ${OPENCLAW_DIR}`);
     process.exit(1);
   }
   console.log("Discovering files...");
-  const files = discoverFiles(OPENCLAW_DIR);
+  const files = discoverFiles(OPENCLAW_DIR, !!opts.includeMemoryDb);
   if (files.length === 0) {
     console.error("\u2717 No files found to backup");
     process.exit(1);
@@ -540,7 +556,7 @@ local.command("backup").description("Save a local backup of your OpenClaw worksp
   const filename = `backup-${timestamp}.tar.gz`;
   const filePath = path.join(BACKUPS_DIR, filename);
   console.log("Creating archive...");
-  await createLocalArchive(files, OPENCLAW_DIR, filePath, opts.tag);
+  await createLocalArchive(files, OPENCLAW_DIR, filePath, opts.tag, opts.includeMemoryDb);
   const archiveSize = fs.statSync(filePath).size;
   console.log(`
 \u2713 Local backup saved!`);
@@ -551,7 +567,8 @@ local.command("backup").description("Save a local backup of your OpenClaw worksp
   const cfg = readConfig();
   trackCliEvent(cfg?.profileId || "anonymous", "local_backup_created", {
     file_count: files.length,
-    total_bytes: totalSize
+    total_bytes: totalSize,
+    include_memory_db: !!opts.includeMemoryDb
   });
 });
 local.command("list").description("List local backups").action(async () => {
@@ -584,6 +601,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)`);
@@ -662,11 +681,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.7",
+  "version": "0.1.9",
   "description": "Backup and restore your OpenClaw workspace",
   "type": "module",
   "bin": {