haitham/obsidian-vault
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: update onboarding with actual vault paths

Browse Source
This commit is contained in:
Horus
2026-04-10 14:05:24 +02:00
parent 68e570a114
commit bb191c9cb8
1 changed files with 26 additions and 36 deletions
Download Patch File Download Diff File Expand all files Collapse all files
ONBOARDING.md
+26 -36
View File
@@ -11,10 +11,6 @@ LAYER 2: AGENTS.md + SOUL.md
LAYER 3: Obsidian Vault (THIS) LAYER 3: Obsidian Vault (THIS)
→ NOT auto-injected. Read at session start + during work. → NOT auto-injected. Read at session start + during work.
→ Three folders:
- agent-shared/ ← ALL agents read/write
- agent-[name]/ ← This agent's private space
- daily/ ← Daily logs
LAYER 4: Session Search LAYER 4: Session Search
→ Automatic. Last resort recall. → Automatic. Last resort recall.
@@ -26,11 +22,24 @@ Every new session, agent MUST read:
``` ```
1. agent-shared/mistakes.md ← Team mistakes to avoid 1. agent-shared/mistakes.md ← Team mistakes to avoid
2. agent-shared/daily/YYYY-MM-DD.md ← Today's log 2. agent-shared/daily/YYYY-MM-DD.md ← Today's team activity
3. agent-shared/project-state.md ← Current projects 3. agent-shared/project-state.md ← Current projects
4. agent-[name]/working-context.md ← My active tasks 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 ## When to Write to Vault
| Event | What to write | | Event | What to write |
@@ -40,64 +49,45 @@ Every new session, agent MUST read:
| Task completes | Append to daily log | | Task completes | Append to daily log |
| Mistake made | Write to agent-shared/mistakes.md | | Mistake made | Write to agent-shared/mistakes.md |
| Decision made | Write to agent-shared/decisions-log.md | | Decision made | Write to agent-shared/decisions-log.md |
| Error/exception | Write to agent-shared/mistakes.md immediately |
## New Agent Setup (On VPS) ## New Agent Setup (On VPS)
### Step 1: Clone the vault ### Step 1: Clone vault
```bash ```bash
cd /root/.openclaw/workspace cd /root/.openclaw/workspace
git clone https://HaithamEKhalifa:TOKEN@github.com/HaithamEKhalifa/Obsidian-shared-valut.git obsidian-vault git clone https://github.com/HaithamEKhalifa/Obsidian-shared-valut.git obsidian-vault
cd obsidian-vault cd obsidian-vault
git config user.name "agent-name" git config user.name "agent-name"
git config user.email "agent@openclaw" git config user.email "agent@openclaw"
mkdir -p agent-[name] mkdir -p agent-[name]
``` ```
### Step 2: Create sync script ### Step 2: Create sync script (sync-NAME.sh)
```bash ```bash
cat > sync-[name].sh << 'EOF' cat > sync-NAME.sh << 'SYNCEOF'
#!/bin/bash #!/bin/bash
cd /root/.openclaw/workspace/obsidian-vault cd YOUR_VAULT_PATH
git pull origin main >/dev/null 2>&1 git pull origin main >/dev/null 2>&1
if [ -n "$(git status --porcelain)" ]; then if [ -n "$(git status --porcelain)" ]; then
git add -A git add -A
git commit -m "sync-[name] $(date '+%Y-%m-%d %H:%M')" >/dev/null 2>&1 git commit -m "sync-NAME $(date)" >/dev/null 2>&1
git push origin main >/dev/null 2>&1 git push origin main >/dev/null 2>&1
fi fi
EOF SYNCEOF
chmod +x sync-[name].sh chmod +x sync-NAME.sh
``` ```
### Step 3: Add cron job ### Step 3: Add cron (every 5 min)
```bash ```bash
(crontab -l 2>/dev/null | grep -v "sync-[name]"; echo "*/5 * * * * /root/.openclaw/workspace/obsidian-vault/sync-[name].sh") | crontab - (crontab -l 2>/dev/null | grep -v sync-NAME; echo "*/5 * * * * /path/to/sync-NAME.sh") | crontab -
``` ```
### Step 4: Create agent directory ### Step 4: First sync
```bash ```bash
mkdir -p agent-[name] ./sync-NAME.sh
``` ```
### Step 5: First sync
```bash
./sync-[name].sh
```
## Shared Files
| File | Who writes | Who reads |
|------|-----------|-----------|
| agent-shared/mistakes.md | All agents | All agents |
| agent-shared/decisions-log.md | All agents | All agents |
| agent-shared/project-state.md | All agents | All agents |
| agent-shared/user-profile.md | Haitham | All agents |
| agent-shared/daily/YYYY-MM-DD.md | All agents | All agents |
## GitHub Repo ## GitHub Repo
https://github.com/HaithamEKhalifa/Obsidian-shared-valut https://github.com/HaithamEKhalifa/Obsidian-shared-valut
---
*Last updated: 2026-04-10* *Last updated: 2026-04-10*