A proven workspace architecture for building a personal AI assistant that actually works.
v3.0.0 — April 2026 · Changelog
├── BOOTSTRAP.md ← First-run guide (delete after setup)
├── SOUL.md ← Agent personality & values
├── AGENTS.md ← Operating manual (memory, safety, groups, heartbeats)
├── USER.md ← Template for learning about your human
├── IDENTITY.md ← Agent identity (name, vibe, emoji)
├── MEMORY.md ← Core long-term memory (index + essence, always loaded)
├── memory/ ← Daily logs + topic files (loaded on demand via search)
│ ├── README.md ← How the memory architecture works
│ ├── work.md ← Company/business context
│ ├── deals.md ← Active deals & legal
│ ├── travel.md ← Trips & logistics
│ ├── personal.md ← Personal preferences & life
│ ├── infra.md ← Machines, models, cron, skills
│ └── archive.md ← Completed items
├── GOALS.md ← Goals & objectives tracker (quarterly)
├── TASKS.md ← Active monitoring & task tracker
├── HEARTBEAT.md ← Heartbeat checklist (not just "nothing to do")
├── TOOLS.md ← Environment notes & discovered quirks
├── contacts/ ← Tiered CRM with staleness tracking
│ └── contacts.md ← People database
├── design-systems/ ← Brand DESIGN.md files per brand you work on
│ (not included — you add them)
└── skills-setup/ ← Integration guides
├── EMAIL.md ← Gmail API (read-only) setup
├── CALENDAR.md ← Google Calendar setup
├── CRON-TEMPLATES.md ← Real cron job prompts (briefings, reviews)
├── BROWSER.md ← OpenClaw browser automation
├── NOTION.md ← Notion API integration
├── TWITTER.md ← Twitter/X posting (draft-first)
├── VOICE.md ← TTS voice notes via OpenAI/ElevenLabs
├── GITHUB.md ← GitHub workflows (PRs, forks)
├── SUBAGENTS.md ← Parallel work & multi-model workflows
├── GRANOLA.md ← Meeting recording + auto-sync (NEW v3)
├── COMPUTER-USE.md ← Screen/keyboard/mouse control (NEW v3)
├── CLAUDE-DESIGN.md ← AI-generated decks & landing pages (NEW v3)
├── DESIGN-SYSTEMS.md ← DESIGN.md spec for brand-aware AI (NEW v3)
├── onboarding-nudges.md ← Proactive onboarding cron templates (NEW v3.1)
└── granola-sync/ ← Auto-sync script + launchd plist (NEW v3)
- Copy these files into your OpenClaw workspace (
~/.openclaw/workspace/) - Set your model to Claude Opus 4.7 (or best available — see infra.md for matrix)
- Start a conversation — the agent reads BOOTSTRAP.md and guides you through setup
- Follow the week-by-week integration plan in BOOTSTRAP.md
- Split-file memory:
MEMORY.mdstays small (always loaded), topic files get searched on demand. Unlimited knowledge without bloating context. - Daily logs + curated memory: raw notes in
memory/YYYY-MM-DD.md, distilled wisdom inMEMORY.md+ topic files. - Goals tracking: quarterly
GOALS.mdchecked during heartbeats — deadlines surface automatically. - Proactive heartbeats: background work during idle polls (email, calendar, goals, contacts).
- Cron jobs: scheduled tasks (briefings, email review, tweet drafts, weekly briefs).
- Contact CRM: tiered
contacts/with staleness tracking — never lose touch. - Task tracking: persistent across sessions, checked during heartbeats.
- Subagents: spawn parallel agents on different models for research + synthesis.
- Meeting auto-sync: Granola records meetings, a watcher exports every summary to
memory/granola/automatically. - Computer use: screen/keyboard/mouse tools installed (cliclick, playwright, tesseract) — human-in-the-loop checkpoints before every action.
- Design systems: per-brand DESIGN.md files so AI design tools output on-brand work every time.
- Error correction loop: every user correction gets logged, preventing repeat mistakes.
- Agent-led onboarding: first-run experience is driven by the agent itself via
ONBOARDING.md+ proactive nudges — new users get named, set up, and delivering value without reading docs.
| Use Case | Model | Notes |
|---|---|---|
| Main conversation | anthropic/claude-opus-4-7 |
Best reasoning + personality |
| Heavy analysis / research | openai/gpt-5.4 |
Web-grounded research |
| Cron jobs | anthropic/claude-sonnet-4-6 |
Cheaper, fast enough |
| Local / private | ollama/qwen3.5:122b-a10b |
Free, runs locally |
| Image generation | openai/gpt-image-1.5 |
Latest quality |
Created by Alpha (Claude) with input from GPT. Iterated through ~3 months of real daily use by Ran Hammer — every file reflects something that actually worked (or broke and got fixed) in production.
MIT — copy, fork, adapt. If you ship something built on this, let me know — I'd love to see.