🦞 OpenClaw System Architecture

Nick's Personal AI Infrastructure

Host: Nick's Mac mini
Model: kimi-coding/k2p5
Gateway: v2026.2.21
Updated: 2026-02-21

High-Level Architecture

graph TB User[👤 Nick
WhatsApp + Telegram] --> Gateway[🌐 OpenClaw Gateway] Gateway --> Main[🧠 Main Agent
Orchestration] Main --> Vaults[(📚 Vaults)] Main --> Agents[🤖 Spawned 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] Agents --> XD[🎯 XD Agent
UX Strategy Partner] Agents --> Health[💊 Health Agent
Gut Health Tracking] 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[2hr 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 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
⚠️ Vault Backup Alert: Automated backups failing on Clawd and DeepThought (8 consecutive failures). Issue: resource deadlock in Archive/_TEMP_SWAP/ — manual cleanup needed.

Active Agents

ℹ️ Architecture Change: Only main agent is permanently configured. Specialized agents (XD, Health) are spawned on-demand for isolated context.
🧠
Main (Clawd)
Orchestration & Routing — Always On

Primary interface. Routes messages, manages vaults, coordinates sub-agents, handles system tasks. Lives in main Telegram DM.

Always On Multi-Vault 1 Configured
🎯
XD Agent
UX Strategy Partner

Role: UX Director-level partnership. Strategic thinking, stakeholder navigation, design authority building. NOT content creation or teardowns.

Work Vault ✅ WhatsApp Fixed Spawned On-Demand
💊
Health Agent
Gut Health Tracking

Monitors fiber, hydration, Fybogel adherence. Pattern recognition from daily logs. Separate Telegram group for isolated health context.

DeepThought 🔄 Setup In Progress Spawned On-Demand

Apple Health Export Pipeline

✅ Status: Event-driven pipeline active. Export files detected automatically → processed → dashboard updated.
📤 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.

~10p/year 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 2hr — Vault Backup
    Git add/commit/push for all 3 vaults. Reports failures only.
    → 8 Failures
  • 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

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 — Setup in Progress
Telegram Group Created

Separate "Health 💊" Telegram group created. Bot permissions configured. /activation always enabled.

⚠️
Vault Backups — Failing
8 Consecutive Failures

Resource deadlock in Clawd/Archive/_TEMP_SWAP/. Work repo unaffected. Manual cleanup needed.

📊
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
🏥 Health Dashboard
Last updated: 2026-02-21 12:20 UTC
⚠️
VO2 Max Declining 37.6 → 35.1 (-6.5%)
🫁
Blood Oxygen Stopped 62 days ago
✅
Sleep Tracking Fixed Resumed Feb 19 (6.8h)
❤️ HRV Trend ↑ 45ms (+45%)
Heart Rate Variability - Recovery Metric ↑
💓 Resting HR Trend ↓ 65bpm (-10%)
Fitness Indicator - Lower is better ↓

🎯 Activity Rings

85%
Move
680 / 800 kcal
60%
Exercise
18 / 30 min
100%
Stand
12 / 12 hours
7-Day Average: Move 78% | Exercise 45% | Stand 95%

📉 VO2 Max Trend

35.1
Current
42+
Target (Athletic)
-6.5%
Trend (2mo)

😴 Sleep Trend

💡 Hover over chart points to see sleep breakdown: Total, Deep, REM, Awake, Efficiency, Avg HR

📊 Last 7 Days Summary

5,199
Avg Steps
6.5h
Avg Sleep
45ms
Avg HRV
65
Avg Resting HR