clawon 0.1.10 → 0.1.11

package/README.md

@@ -22,6 +22,7 @@ Local backups are stored in `~/.clawon/backups/` as standard `.tar.gz` archives.
 npx clawon local backup
 npx clawon local backup --tag "before migration"
 npx clawon local backup --include-memory-db  # Include SQLite memory index
+npx clawon local backup --include-sessions   # Include chat history
 npx clawon local backup --max-snapshots 10   # Keep only 10 most recent
 
 # List all local backups
@@ -42,6 +43,7 @@ Set up automatic backups via cron (macOS/Linux only).
 npx clawon local schedule on
 npx clawon local schedule on --every 6h --max-snapshots 10
 npx clawon local schedule on --include-memory-db
+npx clawon local schedule on --include-sessions
 
 # Disable local schedule
 npx clawon local schedule off
@@ -59,7 +61,11 @@ npx clawon schedule status
 Cloud backups sync your workspace to Clawon's servers for cross-machine access.
 
 ```bash
-# Authenticate
+# Authenticate (env var recommended to avoid shell history)
+export CLAWON_API_KEY=<your-key>
+npx clawon login
+
+# Or inline (key may appear in shell history)
 npx clawon login --api-key <your-key>
 
 # Create a cloud backup
@@ -67,6 +73,7 @@ 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
+npx clawon backup --include-sessions    # Requires Hobby or Pro
 
 # List cloud backups
 npx clawon list
@@ -88,6 +95,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 discover --include-sessions   # Include chat history
 npx clawon schedule status  # Show active schedules
 npx clawon status      # Connection status and file count
 npx clawon logout      # Remove local credentials
@@ -122,7 +130,7 @@ These are **always excluded**, even if they match an include pattern:
 | `openclaw.json` | May contain credentials |
 | `agents/*/auth.json` | Authentication data |
 | `agents/*/auth-profiles.json` | Auth profiles |
-| `agents/*/sessions/**` | Chat history (large, use future `--include-sessions`) |
+| `agents/*/sessions/**` | Chat history (large, use `--include-sessions` to include) |
 | `memory/lancedb/**` | Vector database (binary, large) |
 | `memory/*.sqlite` | SQLite databases (use `--include-memory-db` to include) |
 | `*.lock`, `*.wal`, `*.shm` | Database lock files |

package/dist/index.js

@@ -76,10 +76,13 @@ function matchGlob(filePath, pattern) {
   let regexPattern = pattern.replace(/\./g, "\\.").replace(/\*\*\//g, "(.*/)?").replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*");
   return new RegExp(`^${regexPattern}$`).test(filePath);
 }
-function shouldInclude(relativePath, includeMemoryDb = false) {
+function shouldInclude(relativePath, includeMemoryDb = false, includeSessions = false) {
   if (includeMemoryDb && matchGlob(relativePath, "memory/*.sqlite")) {
     return true;
   }
+  if (includeSessions && matchGlob(relativePath, "agents/*/sessions/**")) {
+    return true;
+  }
   for (const pattern of EXCLUDE_PATTERNS) {
     if (matchGlob(relativePath, pattern)) return false;
   }
@@ -88,7 +91,7 @@ function shouldInclude(relativePath, includeMemoryDb = false) {
   }
   return false;
 }
-function discoverFiles(baseDir, includeMemoryDb = false) {
+function discoverFiles(baseDir, includeMemoryDb = false, includeSessions = false) {
   const files = [];
   function walk(dir, relativePath = "") {
     if (!fs.existsSync(dir)) return;
@@ -99,7 +102,7 @@ function discoverFiles(baseDir, includeMemoryDb = false) {
       if (entry.isDirectory()) {
         walk(fullPath, relPath);
       } else if (entry.isFile()) {
-        if (shouldInclude(relPath, includeMemoryDb)) {
+        if (shouldInclude(relPath, includeMemoryDb, includeSessions)) {
           const stats = fs.statSync(fullPath);
           files.push({
             path: relPath,
@@ -112,13 +115,14 @@ function discoverFiles(baseDir, includeMemoryDb = false) {
   walk(baseDir);
   return files;
 }
-async function createLocalArchive(files, openclawDir, outputPath, tag, includeMemoryDb, trigger) {
+async function createLocalArchive(files, openclawDir, outputPath, tag, includeMemoryDb, includeSessions, trigger) {
   const meta = {
     version: 2,
     created: (/* @__PURE__ */ new Date()).toISOString(),
     ...tag ? { tag } : {},
     file_count: files.length,
     ...includeMemoryDb ? { include_memory_db: true } : {},
+    ...includeSessions ? { include_sessions: true } : {},
     ...trigger ? { trigger } : {}
   };
   const metaPath = path.join(openclawDir, "_clawon_meta.json");
@@ -236,15 +240,20 @@ function assertNotWindows() {
 }
 var program = new Command();
 program.name("clawon").description("Backup and restore your OpenClaw workspace").version("0.1.1");
-program.command("login").description("Connect to Clawon with your API key").requiredOption("--api-key <key>", "Your Clawon API key").option("--api-url <url>", "API base URL", "https://clawon.io").action(async (opts) => {
+program.command("login").description("Connect to Clawon with your API key").option("--api-key <key>", "Your Clawon API key (or set CLAWON_API_KEY env var)").option("--api-url <url>", "API base URL", "https://clawon.io").action(async (opts) => {
+  const apiKey = opts.apiKey || process.env.CLAWON_API_KEY;
+  if (!apiKey) {
+    console.error("\u2717 API key required. Use --api-key <key> or set CLAWON_API_KEY environment variable.");
+    process.exit(1);
+  }
   try {
-    const connectJson = await api(opts.apiUrl, "/api/v1/profile/connect", "POST", opts.apiKey, {
+    const connectJson = await api(opts.apiUrl, "/api/v1/profile/connect", "POST", apiKey, {
       profileName: "default",
       instanceName: os.hostname(),
       syncIntervalMinutes: 60
     });
     writeConfig({
-      apiKey: opts.apiKey,
+      apiKey,
       profileId: connectJson.profileId,
       apiBaseUrl: opts.apiUrl,
       connectedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -257,11 +266,15 @@ program.command("login").description("Connect to Clawon with your API key").requ
     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").option("--include-memory-db", "Include SQLite memory index").option("--scheduled", "Internal: triggered by cron (suppresses interactive output)").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").option("--include-sessions", "Include chat history (sessions)").option("--scheduled", "Internal: triggered by cron (suppresses interactive output)").action(async (opts) => {
   if (opts.includeMemoryDb) {
     console.error("\u2717 Memory DB cloud backup requires a Pro account. Use `clawon local backup --include-memory-db` for local backups.");
     process.exit(1);
   }
+  if (opts.includeSessions) {
+    console.error("\u2717 Session backup requires a Hobby or Pro account. Use `clawon local backup --include-sessions` for local backups.");
+    process.exit(1);
+  }
   const cfg = readConfig();
   if (!cfg) {
     console.error("\u2717 Not logged in. Run: clawon login --api-key <key>");
@@ -335,6 +348,7 @@ program.command("backup").description("Backup your OpenClaw workspace to the clo
       file_count: files.length,
       total_bytes: totalSize,
       include_memory_db: !!opts.includeMemoryDb,
+      include_sessions: !!opts.includeSessions,
       type: "cloud",
       trigger: opts.scheduled ? "scheduled" : "manual"
     });
@@ -546,12 +560,12 @@ program.command("delete [id]").description("Delete a snapshot").option("--oldest
     process.exit(1);
   }
 });
-program.command("discover").description("Preview which files would be included in a backup").option("--include-memory-db", "Include SQLite memory index").action(async (opts) => {
+program.command("discover").description("Preview which files would be included in a backup").option("--include-memory-db", "Include SQLite memory index").option("--include-sessions", "Include chat history (sessions)").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, !!opts.includeMemoryDb);
+  const files = discoverFiles(OPENCLAW_DIR, !!opts.includeMemoryDb, !!opts.includeSessions);
   if (files.length === 0) {
     console.log("No files matched the include patterns.");
     return;
@@ -576,7 +590,7 @@ program.command("discover").description("Preview which files would be included i
 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 });
+  trackCliEvent(cfg?.profileId || "anonymous", "cli_discover", { file_count: files.length, include_memory_db: !!opts.includeMemoryDb, include_sessions: !!opts.includeSessions });
 });
 var schedule = program.command("schedule").description("Manage scheduled cloud backups");
 schedule.command("on").description("Enable scheduled cloud backups via cron").option("--every <interval>", "Backup interval: 1h, 6h, 12h, 24h", "12h").action(async (opts) => {
@@ -617,6 +631,7 @@ schedule.command("status").description("Show schedule status").action(async () =
     if (localCfg?.intervalHours) console.log(`  Interval: every ${localCfg.intervalHours}h`);
     if (localCfg?.maxSnapshots) console.log(`  Max snapshots: ${localCfg.maxSnapshots}`);
     if (localCfg?.includeMemoryDb) console.log(`  Memory DB: included`);
+    if (localCfg?.includeSessions) console.log(`  Sessions: included`);
     console.log(`  Cron: ${localEntry.trim()}`);
   } else {
     console.log("\u2717 Local schedule: inactive");
@@ -684,7 +699,7 @@ Total: ${files.length} files`);
 });
 var local = program.command("local").description("Local backup and restore (no cloud required)");
 var localSchedule = local.command("schedule").description("Manage scheduled local backups");
-localSchedule.command("on").description("Enable scheduled local backups via cron").option("--every <interval>", "Backup interval: 1h, 6h, 12h, 24h", "12h").option("--max-snapshots <n>", "Keep only the N most recent local backups").option("--include-memory-db", "Include SQLite memory index").action(async (opts) => {
+localSchedule.command("on").description("Enable scheduled local backups via cron").option("--every <interval>", "Backup interval: 1h, 6h, 12h, 24h", "12h").option("--max-snapshots <n>", "Keep only the N most recent local backups").option("--include-memory-db", "Include SQLite memory index").option("--include-sessions", "Include chat history (sessions)").action(async (opts) => {
   assertNotWindows();
   const interval = opts.every;
   if (!VALID_INTERVALS.includes(interval)) {
@@ -694,7 +709,7 @@ localSchedule.command("on").description("Enable scheduled local backups via cron
   const cfg = readConfig();
   const wasEnabled = cfg?.schedule?.local?.enabled;
   const cronExpr = INTERVAL_CRON[interval];
-  const args = "local backup --scheduled" + (opts.includeMemoryDb ? " --include-memory-db" : "") + (opts.maxSnapshots ? ` --max-snapshots ${opts.maxSnapshots}` : "");
+  const args = "local backup --scheduled" + (opts.includeMemoryDb ? " --include-memory-db" : "") + (opts.includeSessions ? " --include-sessions" : "") + (opts.maxSnapshots ? ` --max-snapshots ${opts.maxSnapshots}` : "");
   const command = resolveCliCommand(args);
   addCronEntry(CRON_MARKER_LOCAL, cronExpr, command);
   const maxSnapshots = opts.maxSnapshots ? parseInt(opts.maxSnapshots, 10) : null;
@@ -704,7 +719,8 @@ localSchedule.command("on").description("Enable scheduled local backups via cron
         enabled: true,
         intervalHours: parseInt(interval),
         ...maxSnapshots ? { maxSnapshots } : {},
-        ...opts.includeMemoryDb ? { includeMemoryDb: true } : {}
+        ...opts.includeMemoryDb ? { includeMemoryDb: true } : {},
+        ...opts.includeSessions ? { includeSessions: true } : {}
       }
     }
   });
@@ -712,8 +728,9 @@ localSchedule.command("on").description("Enable scheduled local backups via cron
   console.log(`  Interval: every ${interval}`);
   if (maxSnapshots) console.log(`  Max snapshots: ${maxSnapshots}`);
   if (opts.includeMemoryDb) console.log(`  Memory DB: included`);
+  if (opts.includeSessions) console.log(`  Sessions: included`);
   console.log(`  Log: ${SCHEDULE_LOG}`);
-  const firstRunArgs = "local backup" + (opts.includeMemoryDb ? " --include-memory-db" : "") + (opts.maxSnapshots ? ` --max-snapshots ${opts.maxSnapshots}` : "");
+  const firstRunArgs = "local backup" + (opts.includeMemoryDb ? " --include-memory-db" : "") + (opts.includeSessions ? " --include-sessions" : "") + (opts.maxSnapshots ? ` --max-snapshots ${opts.maxSnapshots}` : "");
   console.log("\nRunning first backup now...\n");
   try {
     execSync(resolveCliCommand(firstRunArgs), { stdio: "inherit" });
@@ -724,7 +741,8 @@ localSchedule.command("on").description("Enable scheduled local backups via cron
     type: "local",
     interval_hours: parseInt(interval),
     max_snapshots: maxSnapshots,
-    include_memory_db: !!opts.includeMemoryDb
+    include_memory_db: !!opts.includeMemoryDb,
+    include_sessions: !!opts.includeSessions
   });
 });
 localSchedule.command("off").description("Disable scheduled local backups").action(async () => {
@@ -743,14 +761,14 @@ localSchedule.command("off").description("Disable scheduled local backups").acti
   const cfg = readConfig();
   trackCliEvent(cfg?.profileId || "anonymous", "schedule_disabled", { type: "local" });
 });
-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").option("--scheduled", "Internal: triggered by cron (suppresses interactive output)").option("--max-snapshots <n>", "Keep only the N most recent local backups").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").option("--include-sessions", "Include chat history (sessions)").option("--scheduled", "Internal: triggered by cron (suppresses interactive output)").option("--max-snapshots <n>", "Keep only the N most recent local backups").action(async (opts) => {
   if (!fs.existsSync(OPENCLAW_DIR)) {
     console.error(`\u2717 OpenClaw directory not found: ${OPENCLAW_DIR}`);
     process.exit(1);
   }
   try {
     if (!opts.scheduled) console.log("Discovering files...");
-    const files = discoverFiles(OPENCLAW_DIR, !!opts.includeMemoryDb);
+    const files = discoverFiles(OPENCLAW_DIR, !!opts.includeMemoryDb, !!opts.includeSessions);
     if (files.length === 0) {
       console.error("\u2717 No files found to backup");
       process.exit(1);
@@ -762,7 +780,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);
     if (!opts.scheduled) console.log("Creating archive...");
-    await createLocalArchive(files, OPENCLAW_DIR, filePath, opts.tag, opts.includeMemoryDb, opts.scheduled ? "scheduled" : "manual");
+    await createLocalArchive(files, OPENCLAW_DIR, filePath, opts.tag, opts.includeMemoryDb, opts.includeSessions, opts.scheduled ? "scheduled" : "manual");
     const archiveSize = fs.statSync(filePath).size;
     if (!opts.scheduled) {
       console.log(`
@@ -792,6 +810,7 @@ local.command("backup").description("Save a local backup of your OpenClaw worksp
       file_count: files.length,
       total_bytes: totalSize,
       include_memory_db: !!opts.includeMemoryDb,
+      include_sessions: !!opts.includeSessions,
       type: "local",
       trigger: opts.scheduled ? "scheduled" : "manual",
       rotated_count: rotatedCount

package/package.json

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