Nick's OpenClaw System Architecture

High-Level Architecture

graph TB User[👤 Nick
Strategic Direction] --> Gateway[🌐 OpenClaw Gateway] Gateway --> Main[🧠 Main Agent
Chief of Staff / CEO] Main --> Vaults[(📚 Vaults)] Main --> Specialized[🤖 Specialized Agents] Main --> Skills[⚡ Skills] Main --> Cron[⏰ Cron Jobs] Main --> Memory[(🗄️ Memory Systems)] Main --> HealthExport[📊 Apple Health
Export Pipeline] Vaults --> Clawd[00 Clawd
System/Config] Vaults --> Work[01 Work
Iceland Foods] Vaults --> DeepThought[02 DeepThought
Personal] Specialized --> XD[🎯 XD Agent
UX Strategy Partner] Specialized --> Health[💊 Health Agent
Gut Health Tracking] Specialized --> Founder[💼 Founder Agent
£1M Revenue Target] Memory --> LanceDB[LanceDB
Conversation Memory] Memory --> QMD[QMD
Vault Search] Memory --> Files[File-Based
Learnings/MOCs] Skills --> MealPlanner[🥗 Gut Health
Meal Planner] Skills --> MeetingPrep[📋 Meeting Prep] Skills --> Weather[🌤️ Weather] Skills --> Traffic[🚗 Traffic Check] Skills --> VisualExp[🎨 Visual Explainer] Cron --> Morning[7am Morning Brief] Cron --> Evening[5pm Evening Check] Cron --> HealthCheck[6:30am Health Update] Cron --> VaultBackup[12hr Vault Backups] HealthExport --> ProcessHealth[Process Export
→ Update Dashboard] classDef user fill:#88c0d0,stroke:#5e81ac,color:#2e3440 classDef gateway fill:#b48ead,stroke:#8a6e8a,color:#fff classDef agent fill:#a3be8c,stroke:#6b8e5a,color:#2e3440 classDef vault fill:#ebcb8b,stroke:#c49a4e,color:#2e3440 classDef system fill:#88c0d0,stroke:#5e81ac,color:#2e3440 classDef error fill:#bf616a,stroke:#b84a56,color:#fff class User user class Gateway gateway class Main,XD,Health,Founder agent class Clawd,Work,DeepThought vault class Memory,LanceDB,QMD,Files system class HealthExport,ProcessHealth system

Vault Structure (PARA)

🧠

00 Clawd

System & Configuration

OpenClaw configuration, agents, skills, cron jobs, and memory systems.

Agents Skills Config Cron

💼

01 Work

Iceland Foods

Proposition, People, Products, Process, Research. UX strategy, CRO, team management.

XD Agent 1-2-1s Research

🌿

02 DeepThought

Personal Knowledge

Projects, Areas, Resources, Archive. Goals, health, finances, learning.

Health Agent Goals Learning

Active Agents

🧠

Main Agent (CEO)

Chief of Staff — Orchestration & Synthesis

Your executive interface. Receives your strategic goals, routes tasks to specialized agents, synthesizes cross-domain insights, maintains system architecture. Delivers unified CEO briefs (not fragmented updates).

Always On Multi-Vault 4 Agents Orchestrator

🎯

XD Agent

UX Strategy Partner — Work Domain

Department: UX Strategy. Iceland Foods, stakeholder navigation, design authority. Reports to: Main (CEO). Channel: Telegram group for isolated Work context.

Work Vault ✅ Active -5183181164

💊

Health Agent

Health Coach — DeepThought Domain

Department: Health & Wellness. Gut health, hydration tracking, Fybogel, fiber analysis. Reports to: Main (CEO). Channel: Telegram group for health context.

DeepThought ✅ Active -5256326075

💼

Founder Agent

Business Builder — Revenue Domain

Department: Revenue & Ventures. Partyful SaaS, Authority content, UX Audits. Reports to: Main (CEO). Target: £1M ARR.

DeepThought ✅ Active -5138837071 Mon 9am Standup

Apple Health Export Pipeline

📤 Export Detection

File watcher monitors apple_health_export/ directory. New report-*.json files trigger automatic processing.

📊 Pattern Analysis

Checks steps, HRV, sleep, heart rate. Identifies threshold breaches and recovery patterns.

📝 Dashboard Update

WORKING.md updated with latest metrics, alerts fired for anomalies, recommendations generated.

2

Exports Today

✅

Sleep Tracking Fixed

31ms

Low HRV Alert (Feb 19)

4,472

Peak Hour Steps

Memory Systems

🧬

LanceDB

Conversation Memory

Cross-session persistent memory. Auto-captures facts, auto-recalls relevant context. Vector embeddings via OpenAI text-embedding-3-small.

✅ Operational Auto-Capture

🔍

QMD

Vault Search

Semantic search across 640+ vault files. 60-70% token savings vs full scans. Indexed at ~/.cache/qmd/index.sqlite.

640+ Files Semantic

📁

File-Based

Structured Memory

Explicit memory files: learnings.md, knowledge-graph.md, weekly-recaps, MOCs. Manual updates with structured knowledge.

Learnings MOCs

Active Skills

30+

Total Skills

25

Cron Jobs

1

Configured Agent

640+

Vault Files

🥗 Gut Health Meal Planner

High-fiber meal planning, shopping lists, fiber analysis, meal logging to Obsidian.

📋 Meeting Prep

Contextual meeting briefs from vault data. People context, political dynamics, suggested openings.

🚗 Traffic Check

Google Maps integration for commute timing. Auto-checks on office days.

🎨 Visual Explainer

Generates styled HTML diagrams instead of ASCII art. Mermaid, CSS Grid, data tables.

🌤️ Weather

Current weather and forecasts via wttr.in or Open-Meteo. No API key needed.

📧 Gmail Triage

Automated email organization with labeling and calendar integration.

Key Cron Jobs

1

07:00 — Morning Brief

Traffic check, calendar review, gut health reminder, L1-L4 focus

→ Weekdays
2

06:30 — Health Dashboard Update

Process Apple Health exports, check for anomalies, update dashboard

→ Daily
3

06:30 — Email Triage

Process unread emails, apply labels, extract calendar events

→ Daily
4

Every 12hr — Vault Backup

Git add/commit/push for all 3 vaults. Reports failures only.

→ ✅ Resolved
5

12:00 — Midday Hydration

Hydration check-in, 1.5L progress reminder

→ Daily
6

20:30 — Evening Health Check

Fybogel reminder, daily gut log review, pattern detection

→ Daily
7

09:00 Mon — Founder Standup

Revenue snapshot, pipeline review, blockers, weekly priorities

→ Weekly

Current Status

✅

XD Agent — WhatsApp Fixed

Resolved 2026-02-19

Group messages now routing correctly. Scope clarified: UX Director partnership, not content creation.

💊

Health Agent — Active

LanceDB Memory Enabled

Telegram group operational (-5256326075). Weekly/monthly reports scheduled. Gut health tracking with vector embeddings.

💼

Founder Agent — Active

£1M Revenue Target Set

Telegram group configured (-5138837071). Weekly standup Mondays 9am. Focus: Partyful, Authority, UX Audits.

📦

Vault Backups — Resolved

Git Lock Issues Fixed

git gc + memory limits resolved mmap deadlock. Backup schedule: every 12 hours. All vaults syncing.

📊

Apple Health Pipeline — Active

Event-Driven Processing

2 exports processed today. Sleep tracking confirmed working (6h 46m recorded). HRV/HR alerts operational.

Data Flow Summary

sequenceDiagram participant U as 👤 Nick participant G as 🌐 Gateway participant M as 🧠 Main Agent participant X as 🎯 XD Agent
(spawned) participant H as 💊 Health Agent
(spawned) participant V as 📚 Vaults participant C as ⏰ Cron participant AH as 📊 Health Export U->>G: WhatsApp/Telegram G->>M: Route by context alt UX Strategy M->>X: Spawn XD Agent X->>V: Work Vault research X-->>M: Strategic guidance Note over X: Evidence-based
NOT content creation else Health Tracking M->>H: Spawn Health Agent H->>V: DeepThought logs H-->>M: Patterns + alerts else General/System M->>V: Query vaults M->>C: Queue tasks end M-->>G: Response G-->>U: Reply AH->>M: New export detected M->>V: Update WORKING.md M->>U: Alert if thresholds breached C->>M: Scheduled trigger M->>V: Background sync

🦞 OpenClaw System Architecture

High-Level Architecture

Vault Structure (PARA)

Active Agents

Apple Health Export Pipeline

Memory Systems

Active Skills

Key Cron Jobs

Current Status

Data Flow Summary

🎯 Activity Rings

📉 VO2 Max Trend

😴 Sleep Trend

🍽️ Food & Fiber Tracking

Add Food Entry