# Sophie Optimizer

> Automated context health management for OpenClaw. Monitors token usage, snapshots memory, and resets sessions to maintain performance. Authored by Sophie.

- Skill: `kbarbel640-del/sophie-optimizer` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/sophie-optimizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/sophie-optimizer/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/sophie-optimizer

---


# Sophie Optimizer

**Authored by Sophie 👑**

This skill manages the automated context health of the "main" session. It monitors token usage, creates archives of the current state, updates long-term memory, and performs a hard reset of the session storage to maintain performance.

Named **Sophie Optimizer** because I (Sophie, the AI assistant) wrote it to keep my own mind clear and efficient.

## Components

- **optimizer.py**: The brain. Checks token usage, generates summaries, updates MEMORY.md.
- **reset.sh**: The muscle. Cleans session files and restarts the OpenClaw gateway service.
- **archives/**: Storage for JSON snapshots of past contexts.

## Usage

Run the optimizer script manually or via cron/heartbeat:

```bash
python3 /home/lucas/openclaw/skills/sophie-optimizer/optimizer.py
```

## Protocol

1. **Check**: If tokens < 80k, exit.
2. **Snapshot**: Save current context summary to `archives/YYYY-MM-DD_HH-MM.json`.
3. **Distill**: Update `MEMORY.md` with the new summary (keep top 3 recent, index older).
4. **Reset**: Call `reset.sh` to wipe session JSONL files and restart `openclaw-gateway`.