test-repo/docs/SESSION-CONTINUITY-GUARANTEE.md

Session Continuity Guarantee

Created: Tuesday, February 24, 2026
Purpose: Document how all configurations persist across reboots

---

✅ GUARANTEED: What Survives Reboots

Every session (after PC restart, OpenClaw restart, or new chat) automatically loads:

1. Boot Sequence (SESSION_STARTUP.md)

Location: /Users/mattbruce/.openclaw/workspace/SESSION_STARTUP.md
Purpose: Tells me what to read and in what order
Backed up: ✅ Yes (Gitea)

2. My Identity (SOUL.md)

Location: /Users/mattbruce/.openclaw/workspace/SOUL.md
Content: Who I am (Max), personality, boundaries, mission
Backed up: ✅ Yes (Gitea)

3. Your Profile (USER.md)

Location: /Users/mattbruce/.openclaw/workspace/USER.md
Content: Your preferences, goals, routines
Backed up: ✅ Yes (Gitea)

4. Tools & Workflows (TOOLS.md)

Location: /Users/mattbruce/.openclaw/workspace/TOOLS.md
Content: All tools, APIs, credentials, workflows including:

• Gantt Board CLI access
• Subagent team (Alice, Bob, Charlie)
• 24/7 automated task worker
• Supabase credentials
• Tavily API
• Gitea backup rule Backed up: ✅ Yes (Gitea)

5. Active Projects (BRAIN.md)

Location: /Users/mattbruce/.openclaw/workspace/BRAIN.md
Content: Project statuses, patterns, gotchas
Backed up: ✅ Yes (Gitea)

6. Recent Context (memory/YYYY-MM-DD.md)

Location: /Users/mattbruce/.openclaw/workspace/memory/
Content: Daily logs, decisions, task progress
Backed up: ✅ Yes (Gitea)

7. Subagent Team

Location: /Users/mattbruce/.openclaw/workspace/agents/
Content:

• TEAM-REGISTRY.md - Master registry
• alice-researcher/SOUL.md - Alice's personality
• alice-researcher/AGENTS.md - Alice's role
• bob-implementer/SOUL.md - Bob's personality
• bob-implementer/AGENTS.md - Bob's role
• charlie-tester/SOUL.md - Charlie's personality
• charlie-tester/AGENTS.md - Charlie's role Backed up: ✅ Yes (Gitea)

8. Cron Jobs & Automation

Stored in: OpenClaw cron scheduler (persistent)
Active jobs:

• Gantt Board Task Worker (24/7) - Job ID: b9f3bbe6-bcb5-4483-8816-d044fd91c58a
• Daily Digest (7am CST) - Job ID: 69fb35d3-f3be-4ed2-ade0-3ab77b4369a9 Backed up: ✅ Stored in OpenClaw config (survives restarts)

---

🔒 Protection Mechanisms

Git Repository

• Local: ~/.openclaw/workspace/.git/
• Remote: http://192.168.1.128:3000/TopDogLabs/test-repo.git
• Commits: Every significant change
• Pushes: After every major update

Gitea Remote Backup

• Server: 192.168.1.128:3000
• Organization: TopDogLabs
• Repo: test-repo.git
• Access: ai-agent / !7883Gitea
• Contains: Full git history, all files

File Locations (All Persistent)

All files stored in:

/Users/mattbruce/.openclaw/workspace/
├── SESSION_STARTUP.md
├── SOUL.md
├── USER.md
├── TOOLS.md
├── BRAIN.md
├── AGENTS.md
├── agents/
│   ├── TEAM-REGISTRY.md
│   ├── alice-researcher/
│   ├── bob-implementer/
│   └── charlie-tester/
├── memory/
│   └── 2026-02-24.md
└── .git/ (repository)

---

⚠️ What Could Break (And Fixes)

Scenario 1: Workspace Folder Deleted

Problem: Someone deletes ~/.openclaw/workspace/
Fix:

cd /Users/mattbruce/.openclaw
git clone http://192.168.1.128:3000/TopDogLabs/test-repo.git workspace
cd workspace
# All files restored

Scenario 2: OpenClaw Reinstalled

Problem: OpenClaw app deleted and reinstalled
Fix: Files are on disk, not in app. Just restart OpenClaw.

Scenario 3: Gitea Server Down

Problem: 192.168.1.128 unavailable
Impact: Can't push new changes, but local files still work
Fix: Local files remain functional; restore Gitea when possible

Scenario 4: File Corruption

Problem: Files become unreadable
Fix:

cd /Users/mattbruce/.openclaw/workspace
git checkout HEAD -- filename.md
# File restored from last commit

---

✅ Verification

To verify everything is working after reboot:

1. Check files exist:

   ls /Users/mattbruce/.openclaw/workspace/TOOLS.md
   ls /Users/mattbruce/.openclaw/workspace/agents/TEAM-REGISTRY.md
   

2. Check git status:

   cd /Users/mattbruce/.openclaw/workspace
   git log --oneline -3
   

3. Check cron jobs:

   openclaw cron list
   

4. Ask me: "Verify your memory" - I should know about:

   • Alice, Bob, Charlie subagents
   • 24/7 task worker
   • Gantt Board CLI access
   • Recent tasks created

---

📋 Backup Checklist (After Major Changes)

• New subagent created
• TOOLS.md updated
• New cron job added
• Significant memory updates
• New project scaffolding
• AGENTS.md or SOUL.md changed

Command:

cd /Users/mattbruce/.openclaw/workspace
git add -A
git commit -m "Description"
git push origin master

---

🎯 The Guarantee

YES - Everything persists across reboots because:

1. ✅ Files are on disk (not in memory)
2. ✅ Boot sequence is deterministic (same files, same order)
3. ✅ Everything is git tracked (full history)
4. ✅ Remote backup exists (Gitea)
5. ✅ Cron jobs stored in OpenClaw config (survives restarts)
6. ✅ Mandatory push rule added to TOOLS.md

Unless: The entire hard drive fails (then restore from Gitea on new machine)

---

Last updated: 2026-02-24