refactor: generalize OpenClaw state persistence and add browser warm-up sequence

start.sh

@@ -169,25 +169,19 @@ fi
 
 # ── Restore persisted OpenClaw state (if present) ──
 STATE_BACKUP_ROOT="/home/node/.openclaw/workspace/.huggingclaw-state/openclaw"
-restore_state_dir() {
-  local name="$1"
-  local source_dir="${STATE_BACKUP_ROOT}/${name}"
-  local target_dir="/home/node/.openclaw/${name}"
-
-  if [ ! -d "$source_dir" ]; then
-    return
-  fi
-
-  echo "🧠 Restoring OpenClaw ${name} state..."
-  rm -rf "$target_dir"
-  mkdir -p "$(dirname "$target_dir")"
-  cp -R "$source_dir" "$target_dir"
-  echo "  ✅ ${name} restored"
-}
-
-restore_state_dir "agents"
-restore_state_dir "memory"
-restore_state_dir "extensions"
+if [ -d "$STATE_BACKUP_ROOT" ]; then
+  echo "🧠 Restoring OpenClaw state..."
+  for source_path in "$STATE_BACKUP_ROOT"/*; do
+    [ -e "$source_path" ] || continue
+    name="$(basename "$source_path")"
+    target_path="/home/node/.openclaw/${name}"
+
+    rm -rf "$target_path"
+    mkdir -p "$(dirname "$target_path")"
+    cp -R "$source_path" "$target_path"
+  done
+  echo "  ✅ OpenClaw state restored"
+fi
 
 # ── Restore persisted WhatsApp credentials (if present) ──
 WA_BACKUP_DIR="/home/node/.openclaw/workspace/.huggingclaw-state/credentials/whatsapp/default"
@@ -414,23 +408,9 @@ graceful_shutdown() {
   echo "🛑 Shutting down gracefully..."
 
   if [ -f "/home/node/app/workspace-sync.py" ]; then
-    echo "🧠 Snapshotting OpenClaw state before exit..."
-    python3 /home/node/app/workspace-sync.py --snapshot-once 2>/dev/null || \
-      echo "  ⚠️ Could not snapshot OpenClaw state before shutdown"
-  fi
-  
-  # Commit any unsaved workspace changes
-  if [ -d "/home/node/.openclaw/workspace/.git" ]; then
-    echo "💾 Saving workspace before exit..."
-    cd /home/node/.openclaw/workspace
-    git add -A 2>/dev/null
-    if ! git diff --cached --quiet 2>/dev/null; then
-      TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-      git commit -m "Shutdown sync ${TIMESTAMP}" 2>/dev/null
-      git push origin main 2>/dev/null && echo "  ✅ Workspace saved!" || echo "  ⚠️ Push failed"
-    else
-      echo "  ✅ No unsaved changes"
-    fi
+    echo "💾 Saving OpenClaw state before exit..."
+    python3 /home/node/app/workspace-sync.py --sync-once || \
+      echo "  ⚠️ Could not complete shutdown sync"
   fi
   
   # Kill background processes
@@ -440,6 +420,26 @@ graceful_shutdown() {
 }
 trap graceful_shutdown SIGTERM SIGINT
 
+warmup_browser() {
+  [ "$BROWSER_SHOULD_ENABLE" = "true" ] || return 0
+
+  (
+    sleep 5
+
+    local attempt
+    for attempt in 1 2 3 4 5; do
+      if openclaw browser --browser-profile openclaw start >/dev/null 2>&1; then
+        openclaw browser --browser-profile openclaw open about:blank >/dev/null 2>&1 || true
+        echo "  ✅ Managed browser ready"
+        return 0
+      fi
+      sleep 2
+    done
+
+    echo "  ⚠️ Managed browser warm-up did not complete; first browser action may need a retry"
+  ) &
+}
+
 # ── Start background services ──
 export LLM_MODEL="$LLM_MODEL"
 # 10. Start Health Server & Dashboard
@@ -476,6 +476,9 @@ if [ "$WHATSAPP_ENABLED_NORMALIZED" = "true" ]; then
   echo "🛡️ WhatsApp Guardian started (PID: $GUARDIAN_PID)"
 fi
 
+# 11.5 Warm up the managed browser so first browser actions have a live tab
+warmup_browser
+
 # 12. Start Workspace Sync after startup settles
 python3 -u /home/node/app/workspace-sync.py &
 

workspace-sync.py

@@ -19,10 +19,11 @@ OPENCLAW_HOME = Path("/home/node/.openclaw")
 WORKSPACE = OPENCLAW_HOME / "workspace"
 STATE_DIR = WORKSPACE / ".huggingclaw-state"
 OPENCLAW_STATE_BACKUP_DIR = STATE_DIR / "openclaw"
-PERSISTED_STATE_PATHS = {
-    "agents": OPENCLAW_HOME / "agents",
-    "memory": OPENCLAW_HOME / "memory",
-    "extensions": OPENCLAW_HOME / "extensions",
+EXCLUDED_STATE_NAMES = {
+    "workspace",
+    "openclaw-app",
+    "gateway.log",
+    "browser",
 }
 WHATSAPP_CREDS_DIR = Path("/home/node/.openclaw/credentials/whatsapp/default")
 WHATSAPP_BACKUP_DIR = STATE_DIR / "credentials" / "whatsapp" / "default"
@@ -61,16 +62,19 @@ def snapshot_state_into_workspace() -> None:
     """
     try:
         STATE_DIR.mkdir(parents=True, exist_ok=True)
+        if OPENCLAW_STATE_BACKUP_DIR.exists():
+            shutil.rmtree(OPENCLAW_STATE_BACKUP_DIR, ignore_errors=True)
+        OPENCLAW_STATE_BACKUP_DIR.mkdir(parents=True, exist_ok=True)
 
-        for name, source_path in PERSISTED_STATE_PATHS.items():
-            if not source_path.exists():
+        for source_path in OPENCLAW_HOME.iterdir():
+            if source_path.name in EXCLUDED_STATE_NAMES:
                 continue
 
-            backup_path = OPENCLAW_STATE_BACKUP_DIR / name
-            backup_path.parent.mkdir(parents=True, exist_ok=True)
-            if backup_path.exists():
-                shutil.rmtree(backup_path, ignore_errors=True)
-            shutil.copytree(source_path, backup_path)
+            backup_path = OPENCLAW_STATE_BACKUP_DIR / source_path.name
+            if source_path.is_dir():
+                shutil.copytree(source_path, backup_path)
+            elif source_path.is_file():
+                shutil.copy2(source_path, backup_path)
     except Exception as e:
         print(f"  ⚠️ Could not snapshot OpenClaw state: {e}")
 
@@ -211,6 +215,50 @@ def main():
         write_sync_status("configured", "State snapshot refreshed during shutdown.")
         return
 
+    if "--sync-once" in sys.argv:
+        if not WORKSPACE.exists():
+            print("📁 Workspace sync: workspace not found, exiting.")
+            return
+
+        use_hf_hub = bool(HF_TOKEN and HF_USERNAME)
+        git_dir = WORKSPACE / ".git"
+
+        if not use_hf_hub and not git_dir.exists():
+            print("📁 Workspace sync: no git repo and no HF credentials, skipping.")
+            return
+
+        snapshot_state_into_workspace()
+
+        if not has_changes():
+            print("📁 Workspace sync: no changes to persist.")
+            write_sync_status("configured", "No new state changes to sync.")
+            return
+
+        ts = time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
+        write_sync_status("syncing", f"Shutdown sync started at {ts}")
+
+        if use_hf_hub:
+            if sync_with_hf_hub():
+                print(f"🔄 Workspace sync (hf_hub): pushed changes ({ts})")
+                write_sync_status("success", "Shutdown sync pushed to HF Hub")
+                return
+            if sync_with_git():
+                print(f"🔄 Workspace sync (git fallback): pushed changes ({ts})")
+                write_sync_status("success", "Shutdown sync pushed via git fallback")
+                return
+            write_sync_status("error", "Shutdown sync failed")
+            print("📁 Workspace sync: shutdown sync failed.")
+            return
+
+        if sync_with_git():
+            print(f"🔄 Workspace sync (git): pushed changes ({ts})")
+            write_sync_status("success", "Shutdown sync pushed via git")
+            return
+
+        write_sync_status("error", "Shutdown sync failed")
+        print("📁 Workspace sync: shutdown sync failed.")
+        return
+
     if not WORKSPACE.exists():
         print("📁 Workspace sync: workspace not found, exiting.")
         return