Horus
104 lines
2.7 KiB
Markdown
104 lines
2.7 KiB
Markdown
# 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.
|
|
→ Three folders:
|
|
- agent-shared/ ← ALL agents read/write
|
|
- agent-[name]/ ← This agent's private space
|
|
- daily/ ← Daily logs
|
|
|
|
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 log
|
|
3. agent-shared/project-state.md ← Current projects
|
|
4. agent-[name]/working-context.md ← My active tasks
|
|
```
|
|
|
|
## 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 |
|
|
| Error/exception | Write to agent-shared/mistakes.md immediately |
|
|
|
|
## New Agent Setup (On VPS)
|
|
|
|
### Step 1: Clone the vault
|
|
```bash
|
|
cd /root/.openclaw/workspace
|
|
git clone https://HaithamEKhalifa:TOKEN@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
|
|
```bash
|
|
cat > sync-[name].sh << 'EOF'
|
|
#!/bin/bash
|
|
cd /root/.openclaw/workspace/obsidian-vault
|
|
git pull origin main >/dev/null 2>&1
|
|
if [ -n "$(git status --porcelain)" ]; then
|
|
git add -A
|
|
git commit -m "sync-[name] $(date '+%Y-%m-%d %H:%M')" >/dev/null 2>&1
|
|
git push origin main >/dev/null 2>&1
|
|
fi
|
|
EOF
|
|
chmod +x sync-[name].sh
|
|
```
|
|
|
|
### Step 3: Add cron job
|
|
```bash
|
|
(crontab -l 2>/dev/null | grep -v "sync-[name]"; echo "*/5 * * * * /root/.openclaw/workspace/obsidian-vault/sync-[name].sh") | crontab -
|
|
```
|
|
|
|
### Step 4: Create agent directory
|
|
```bash
|
|
mkdir -p agent-[name]
|
|
```
|
|
|
|
### 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
|
|
|
|
https://github.com/HaithamEKhalifa/Obsidian-shared-valut
|
|
|
|
---
|
|
|
|
*Last updated: 2026-04-10*
|