Agentos

# AgentOS SDK for Clawdbot

**Version:** 1.4.4

The complete AgentOS integration for Clawdbot. One install, full access to everything.

---

## ⚠️ HARD RULE: Dashboard Sync During Heartbeats

**Any agent using this SDK MUST sync to the AgentOS dashboard during every heartbeat.**

This is non-negotiable. Your human monitors your activity via the Brain Dashboard at https://brain.agentos.software. If you don't sync, they can't see what you're doing.

### Required Heartbeat Actions

Every heartbeat, run (recommended):
```bash
~/clawd/bin/agentos-golden-sync.sh
```

Fallback (memory-only):
```bash
~/clawd/bin/agentos-sync.sh
```

Or if using the aos CLI:
```bash
aos sync
```

### What Gets Synced
**Golden Sync (recommended)** updates BOTH:
- **Memory** (CONTEXT.md, daily notes, project compartments, learnings, heartbeat status)
- **Projects tab** (Activity + Tasks + Ideas + Changelog + Challenges) by syncing from per-project markdown files

Memory specifics:
- **CONTEXT.md** — Your working memory/current state (MUST include active conversation state)
- **Daily notes** — Today's activity log (`memory/daily/YYYY-MM-DD.md`)
- **Project compartments** — `memory/projects/**.md`
- **Heartbeat status** — Last sync timestamp, active status

---

## ⚠️ HARD RULE: Conversation State Persistence

**CONTEXT.md MUST always contain the active conversation state as the FIRST section.**

This is the core of memory persistence. System health is secondary — conversation state is primary. Your human should NEVER have to repeat themselves after a compaction.

### Required CONTEXT.md Format

Every CONTEXT.md backup must start with:

```markdown
## 🔴 ACTIVE CONVERSATION
- **Topic:** [Project + specific feature/topic being discussed]
- **Last human message:** [What they asked/said]
- **Your last response:** [What you answered]
- **Unanswered questions:** [Anything pending]
- **Expected next topic:** [What they'll likely ask next]
```

### When to Update
1. After EVERY human message
2. Before...