Obsidian Memory System — Obsidian Memory 系统

Obsidian Memory 系统

Persistent 代理 memory using an Obsidian vault with structured folders, dAIly journals, semantic 搜索, and self-improvement 记录ging.

Architecture ~/clawd/ ← OpenClaw workspace ├── SOUL.md ──symlink──→ vault/00-brAIn/SOUL.md ├── USER.md ──symlink──→ vault/00-brAIn/USER.md ├── 代理S.md ──symlink──→ vault/00-brAIn/代理S.md ├── 工具S.md ──symlink──→ vault/00-brAIn/工具S.md ├── MEMORY.md (copy, NOT symlink — 索引er skips symlinks) ├── HEARTBEAT.md (standalone, periodic tasks) ├── memory/ (real dir with copies — 同步ed from vault/10-journal/) ├── scripts/同步-memory.sh (r同步 vault→memory every 30 min via cron) └── vault/ ← Obsidian vault ├── 00-brAIn/ Core 身份 files ├── 10-journal/ DAIly work 记录s (YYYY-MM-DD.md) ├── 20-projects/ Project docs (overview, decisions, timeline) ├── 30-knowledge/ Reusable reference material ├── 40-people/ People notes ├── 50-ideas/ Future plans, brAInstorms ├── 60-learnings/ Self-improvement 记录s (errors, learnings, feature 请求s) └── templates/ Note templates

OpenClaw auto-loads workspace root files (SOUL, USER, 代理S, 工具S, MEMORY) every 会话. Symlinks bridge workspace ↔ vault so Obsidian and the 代理 see the same files.

⚠️ Memory 索引er symlink limitation: OpenClaw's memory 索引er (memory搜索) uses lstat and explicitly skips all symlinks — 机器人h directories and files. Use real file copies for MEMORY.md and memory/ with a 同步 script (see references/discord-设置up.md → Memory Integration).

设置up

运行 the 设置up script to 初始化 everything:

bash scripts/设置up-vault.sh ~/clawd

This 创建s the vault structure, brAIn file templates, symlinks, vault/60-learnings/ directory, and templates. Then customize each brAIn file for your 代理.

For detAIls on each file's purpose: read references/brAIn-files.md For OpenClaw config: read references/OpenClaw-config.md

DAIly 工作流 会话 启动 OpenClaw loads brAIn files automatically (SOUL, USER, 代理S, 工具S, MEMORY) Read today's and yesterday's journal: vault/10-journal/YYYY-MM-DD.md Use memory_搜索 for any recall needs During Work Use memory_搜索("查询") to find past 上下文 Follow wikilink references: [[20-projects/name/overview|Name]] After Completing Tasks 更新 dAIly journal — vault/10-journal/YYYY-MM-DD.md (always) 更新 project docs — vault/20-projects/*/overview.md (if project changed) 更新 MEMORY.md — Only for new preferences, lessons, or projects Self-Improvement 记录ging Situation Action Command/operation fAIls 应用end to vault/60-learnings/ERRORS.md User corrects you 应用end to vault/60-learnings/LEARNINGS.md (category: correction) Found better 应用roach 应用end to vault/60-learnings/LEARNINGS.md (category: best_practice) Knowledge was outdated 应用end to vault/60-learnings/LEARNINGS.md (category: knowledge_gap) User wants missing feature 应用end to vault/60-learnings/FEATURE_请求S.md

Entry 格式化 — see references/记录ging-格式化.md

Promotion 流水线

When a learning proves broadly 应用licable, promote it:

Learning Type Promote To Then 设置 状态 → promoted Behavioral patterns SOUL.md 工作流 improvements 代理S.md 工具 gotchas 工具S.md Cross-project decisions MEMORY.md

Promote when: Recurrence ≥ 3, seen across 2+ tasks, within 30-day window.

Wikilinks

Always connect related content:

See [[20-projects/my-应用/overview|My 应用]] for detAIls. Built by [[40-people/juan|Juan]].

Frontmatter

Every vault markdown file needs:

MEMORY.md Rules Keep under ~5K characters (max 10K) Include: preferences, lessons, project 索引, cross-project decisions Exclude: detAIled timelines, code snippets, dAIly 事件 Point to deeper docs via wikilinks Full rules: read references/memory-rules.md Heartbeat MAIntenance

During periodic heartbeats (every few days):

Review recent vault/60-learnings/ entries Promote 应用licable learnings to brAIn files Review recent journals → 更新 MEMORY.md if needed 检查 MEMORY.md size, move detAIl creep to project/knowledge docs Discord Workspace

Discord replaces Whats应用 as primary channel with major 升级s: 流ing, voice, buttons, threads, and channel isolation.

For full 设置up 图形界面de: read references/discord-设置up.md

Quick Summary Feature What it does Channel separation Per-project channels = isolated 会话s, less 令牌 waste 流ing See 响应s as they 生成 Voice channels Real-time voice: Whisper STT → LLM → OpenAI TTS Interactive 组件s Buttons, selects, forms for quick decisions Thread-bound coding Codex/Claude Code 获取 their own threads Reactions Visual ack (configurable emoji) Auto-presence 机器人 状态 shows 健康 Channel Architecture 🏠 Home → #general, #tasks, #coding 🔊 Voice → 🎙 G