mirror of
https://github.com/openclaw/openclaw.git
synced 2026-04-12 09:41:11 +00:00
fix(memory): standardize DREAMS trail path
This commit is contained in:
@@ -93,14 +93,14 @@ Full options:
|
||||
## Dreaming (experimental)
|
||||
|
||||
Dreaming is the background memory consolidation system with three cooperative
|
||||
phases: **light** (organize into `dreams.md` in inline mode), **deep**
|
||||
phases: **light** (organize into `DREAMS.md` in inline mode), **deep**
|
||||
(promote into `MEMORY.md`), and **REM** (reflect and find patterns in
|
||||
`dreams.md` in inline mode).
|
||||
`DREAMS.md` in inline mode).
|
||||
|
||||
- Enable with `plugins.entries.memory-core.config.dreaming.enabled: true`.
|
||||
- Toggle from chat with `/dreaming on|off` or `/dreaming enable|disable light|deep|rem`.
|
||||
- Each phase runs on its own cron schedule, managed automatically by `memory-core`.
|
||||
- Only the deep phase writes durable memory to `MEMORY.md`. With default inline storage, Light and REM write to `dreams.md`.
|
||||
- Only the deep phase writes durable memory to `MEMORY.md`. With default inline storage, Light and REM write to `DREAMS.md`.
|
||||
- Ranking uses weighted signals: recall frequency, retrieval relevance, query diversity, temporal recency, cross-day consolidation, and derived concept richness.
|
||||
- Promotion re-reads the live daily note before writing to `MEMORY.md`, so edited or deleted short-term snippets do not get promoted from stale recall-store snapshots.
|
||||
- Scheduled and manual `memory promote` runs share the same deep phase defaults unless you pass CLI threshold overrides.
|
||||
|
||||
@@ -22,7 +22,7 @@ a distinct job, writes to a distinct target, and runs on its own schedule.
|
||||
|
||||
Light dreaming sorts the recent mess. It scans recent memory traces, dedupes
|
||||
them by Jaccard similarity, clusters related entries, and stages candidate
|
||||
memories into the shared dreaming trail file (`dreams.md`) when inline storage
|
||||
memories into the shared dreaming trail file (`DREAMS.md`) when inline storage
|
||||
is enabled.
|
||||
|
||||
Light does **not** write anything into `MEMORY.md`. It only organizes and
|
||||
@@ -42,19 +42,19 @@ threshold). Think: "what is true enough to keep?"
|
||||
|
||||
REM dreaming looks for patterns and reflection. It examines recent material,
|
||||
identifies recurring themes through concept tag clustering, and writes
|
||||
higher-order notes and reflections into `dreams.md` when inline storage is
|
||||
higher-order notes and reflections into `DREAMS.md` when inline storage is
|
||||
enabled.
|
||||
|
||||
REM writes to `dreams.md` in inline mode, **not** `MEMORY.md`.
|
||||
REM writes to `DREAMS.md` in inline mode, **not** `MEMORY.md`.
|
||||
Its output is interpretive, not canonical. Think: "what pattern am I noticing?"
|
||||
|
||||
## Hard boundaries
|
||||
|
||||
| Phase | Job | Writes to | Does NOT write to |
|
||||
| ----- | --------- | ------------------------- | ----------------- |
|
||||
| Light | Organize | `dreams.md` (inline mode) | MEMORY.md |
|
||||
| Light | Organize | `DREAMS.md` (inline mode) | MEMORY.md |
|
||||
| Deep | Preserve | MEMORY.md | -- |
|
||||
| REM | Interpret | `dreams.md` (inline mode) | MEMORY.md |
|
||||
| REM | Interpret | `DREAMS.md` (inline mode) | MEMORY.md |
|
||||
|
||||
## Quick start
|
||||
|
||||
@@ -112,7 +112,7 @@ for the full key list.
|
||||
| `enabled` | `boolean` | `true` | Master switch for all phases |
|
||||
| `timezone` | `string` | unset | Timezone for schedule evaluation and dreaming date bucketing |
|
||||
| `verboseLogging` | `boolean` | `false` | Emit detailed per-run dreaming logs |
|
||||
| `storage.mode` | `string` | `"inline"` | Inline `dreams.md`, separate reports, or both |
|
||||
| `storage.mode` | `string` | `"inline"` | Inline `DREAMS.md`, separate reports, or both |
|
||||
|
||||
### Light phase config
|
||||
|
||||
@@ -233,7 +233,7 @@ See [memory CLI](/cli/memory) for the full flag reference.
|
||||
2. Filter entries within `lookbackDays` of the current time.
|
||||
3. Deduplicate by Jaccard similarity (configurable threshold).
|
||||
4. Sort by average recall score, take up to `limit` entries.
|
||||
5. Write staged candidates into `dreams.md` under a `## Light Sleep` block when
|
||||
5. Write staged candidates into `DREAMS.md` under a `## Light Sleep` block when
|
||||
inline storage is enabled.
|
||||
|
||||
### Deep phase pipeline
|
||||
@@ -252,7 +252,7 @@ See [memory CLI](/cli/memory) for the full flag reference.
|
||||
1. Read recent memory traces within `lookbackDays`.
|
||||
2. Cluster concept tags by co-occurrence.
|
||||
3. Filter patterns by `minPatternStrength`.
|
||||
4. Write themes and reflections into `dreams.md` under a `## REM Sleep` block
|
||||
4. Write themes and reflections into `DREAMS.md` under a `## REM Sleep` block
|
||||
when inline storage is enabled.
|
||||
|
||||
## Scheduling
|
||||
|
||||
@@ -387,12 +387,12 @@ conceptual details and chat commands, see [Dreaming](/concepts/dreaming).
|
||||
| `enabled` | `boolean` | `true` | Master switch for all phases |
|
||||
| `timezone` | `string` | unset | Timezone for schedule evaluation and dreaming date bucketing |
|
||||
| `verboseLogging` | `boolean` | `false` | Emit detailed per-run dreaming logs |
|
||||
| `storage.mode` | `string` | `"inline"` | Inline `dreams.md`, separate reports, or both |
|
||||
| `storage.mode` | `string` | `"inline"` | Inline `DREAMS.md`, separate reports, or both |
|
||||
| `storage.separateReports` | `boolean` | `false` | Write separate report files per phase |
|
||||
|
||||
### Light phase (`phases.light`)
|
||||
|
||||
Scans recent traces, dedupes, and stages candidates into `dreams.md` when
|
||||
Scans recent traces, dedupes, and stages candidates into `DREAMS.md` when
|
||||
inline storage is enabled.
|
||||
Does **not** write to `MEMORY.md`.
|
||||
|
||||
@@ -435,7 +435,7 @@ writes durable facts. Also owns recovery when memory is thin.
|
||||
|
||||
### REM phase (`phases.rem`)
|
||||
|
||||
Writes themes, reflections, and pattern notes into `dreams.md` when inline
|
||||
Writes themes, reflections, and pattern notes into `DREAMS.md` when inline
|
||||
storage is enabled.
|
||||
Does **not** write to `MEMORY.md`.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user