obsidian-vault/ONBOARDING.md

Agent Onboarding — Obsidian Shared Vault

The 4-Layer Memory System

LAYER 1: Built-in Memory (~2,200 chars)
  → Injected every prompt. Tiny facts + pointers.

LAYER 2: AGENTS.md + SOUL.md
  → Operating instructions + personality. Always present.

LAYER 3: Obsidian Vault (THIS)
  → NOT auto-injected. Read at session start + during work.

LAYER 4: Session Search
  → Automatic. Last resort recall.

Startup Routine (MANDATORY)

Every new session, agent MUST read:

1. agent-shared/mistakes.md          ← Team mistakes to avoid
2. agent-shared/daily/YYYY-MM-DD.md  ← Today's team activity
3. agent-shared/project-state.md      ← Current projects
4. agent-[name]/working-context.md    ← My active tasks

Vault Paths (per VPS)

VPS	Agent	Vault Path
horus	OpenClaw	/root/.openclaw/workspace/obsidian-vault
horus	Hermes	Same vault (shared)
amun	OpenClaw	/root/.openclaw/workspace/obsidian-vault
amun	Hermes	Same vault (shared)
cleopatra	OpenClaw	/root/obsidian-vault
cleopatra	Hermes	Same vault (shared)

Find your vault: find /root -name obsidian-vault -type d

When to Write to Vault

Event	What to write
Task starts	Update working-context.md
Every 3-5 tool calls	Checkpoint progress
Task completes	Append to daily log
Mistake made	Write to agent-shared/mistakes.md
Decision made	Write to agent-shared/decisions-log.md

New Agent Setup (On VPS)

Step 1: Clone vault

cd /root/.openclaw/workspace
git clone https://github.com/HaithamEKhalifa/Obsidian-shared-valut.git obsidian-vault
cd obsidian-vault
git config user.name "agent-name"
git config user.email "agent@openclaw"
mkdir -p agent-[name]

Step 2: Create sync script (sync-NAME.sh)

cat > sync-NAME.sh << 'SYNCEOF'
#!/bin/bash
cd YOUR_VAULT_PATH
git pull origin main >/dev/null 2>&1
if [ -n "$(git status --porcelain)" ]; then
    git add -A
    git commit -m "sync-NAME $(date)" >/dev/null 2>&1
    git push origin main >/dev/null 2>&1
fi
SYNCEOF
chmod +x sync-NAME.sh

Step 3: Add cron (every 5 min)

(crontab -l 2>/dev/null | grep -v sync-NAME; echo "*/5 * * * * /path/to/sync-NAME.sh") | crontab -

Step 4: First sync

./sync-NAME.sh

GitHub Repo

https://github.com/HaithamEKhalifa/Obsidian-shared-valut

Last updated: 2026-04-10