diff --git a/README.md b/README.md index 0f1506927..e3274e1d1 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ I was setting up my [OpenClaw](https://openclaw.com) agent and started a markdow - **500+ media pages** (video transcripts, books, articles) - Company profiles, food guides, travel logs -This is what I actually use day to day. The agent runs while I sleep... literally. OpenClaw's dream cycle (DREAMS.md) scans every conversation from the day, enriches missing entities, fixes broken citations, and consolidates memory. I wake up and the brain is smarter than when I went to sleep. +This is what I actually use day to day. The agent runs while I sleep... literally. The dream cycle scans every conversation from the day, enriches missing entities, fixes broken citations, and consolidates memory. I wake up and the brain is smarter than when I went to sleep. OpenClaw ships this as DREAMS.md. Hermes Agent can do the same with a nightly cron job (see the [SKILLPACK](docs/GBRAIN_SKILLPACK.md#the-dream-cycle) for setup). **You don't need Postgres to start.** The knowledge model is just markdown files in a git repo. The [skills](docs/GBRAIN_SKILLPACK.md) and [schema](docs/GBRAIN_RECOMMENDED_SCHEMA.md) work with any AI agent that can read and write files. Start there. diff --git a/docs/GBRAIN_SKILLPACK.md b/docs/GBRAIN_SKILLPACK.md index 8dde528f1..9096bc89e 100644 --- a/docs/GBRAIN_SKILLPACK.md +++ b/docs/GBRAIN_SKILLPACK.md @@ -488,10 +488,10 @@ missed signals, zero 3 AM pings. Every cron job includes: quiet hours check, location/timezone awareness, sub-agent spawning for heavy work. -### The Dream Cycle (DREAMS.md) +### The Dream Cycle -The most important cron job runs while you sleep. OpenClaw/Hermes ships with DREAMS.md -as a default skill. When quiet hours start, the dream cycle kicks off: +The most important cron job runs while you sleep. When quiet hours start, the dream +cycle kicks off: 1. **Entity sweep.** Scan today's conversations for every person, company, concept, or idea you mentioned. Check each against the brain. @@ -513,6 +513,35 @@ This is the difference between an agent that forgets and one that remembers. The cycle is not optional for a production brain. Without it, signal leaks out of every conversation. With it, nothing is lost. +#### OpenClaw + +Ships with DREAMS.md as a default skill. Three phases (light, deep, REM) run +automatically during quiet hours. Entity sweeps, memory promotion, and a narrative +dream diary are built in. + +#### Hermes Agent + +Hermes has all the pieces but doesn't bundle a dream cycle by default. Set one up +with the cron scheduler: + +``` +/cron add "0 2 * * *" "Dream cycle: search today's sessions for + entities I mentioned. For each person, company, or idea: check + if a brain page exists (gbrain search), create or update it if + thin. Fix any broken citations. Then consolidate: read MEMORY.md, + promote important signals, remove stale entries." + --name "nightly-dream-cycle" +``` + +The scheduled job spawns an isolated agent session that can call `session_search()` +to scan recent conversations (FTS5 over SQLite), `gbrain search` / `gbrain get` to +check the brain, and `memory(action="replace")` to consolidate. Enable Honcho +(`plugins/memory/honcho`) for automatic dialectic reasoning on top. + +Key Hermes files for reference: `tools/memory_tool.py` (MEMORY.md/USER.md ops), +`tools/session_search_tool.py` (past conversation retrieval), +`cron/scheduler.py` (gateway tick loop). + --- ## 10. Content and Media Ingestion