openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh zh-CN translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-22 01:53:47 +00:00
parent 71caa53207
commit b375739be0
1 changed files with 86 additions and 60 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

146
docs/zh-CN/concepts/dreaming.md
View File

@ -1,25 +1,26 @@
---
read_when:
- 你希望记忆提升自动运行
- 你希望记忆提升能够自动运行
- 你想了解每个 Dreaming 阶段的作用
- 你想在不污染 `MEMORY.md` 的情况下调整巩固过程
summary: 通过浅层、深层和 REM 阶段进行后台记忆巩固，并配有梦境日记
- 你想在不污染 `MEMORY.md` 的情况下调整整合过程
summary: 通过轻度、深度和 REM 阶段进行后台记忆整合，并附带 Dream Diary
title: Dreaming
x-i18n:
generated_at: "2026-04-15T10:48:13Z"
generated_at: "2026-04-22T01:53:20Z"
model: gpt-5.4
provider: openai
source_hash: a5bcaec80f62e7611ed533094ef1917bd72c885f57252824db910e1f0496adc6
source_hash: 050e99bd2b3a18d7d2f02747e3010a7679515098369af5061d0a97b5703fc581
source_path: concepts/dreaming.md
workflow: 15
---
# Dreaming
Dreaming 是 `memory-core` 中的后台记忆巩固系统。
它帮助 OpenClaw 将强烈的短期信号转入持久记忆，同时让整个过程保持可解释和可审查。
Dreaming 是 `memory-core` 中的后台记忆整合系统。
它帮助 OpenClaw 将强烈的短期信号转移到持久记忆中，同时
保持整个过程可解释且可审查。
Dreaming 是**可选启用**功能，默认处于禁用状态。
Dreaming 是**可选启用**的，默认禁用。
## Dreaming 会写入什么
@ -32,22 +33,23 @@ Dreaming 会保留两类输出：
## 阶段模型
Dreaming 使用三个协同阶段：
Dreaming 使用三个协同工作的阶段：
| 阶段 | 目的 | 持久写入 |
| ----- | ----------------------------------------- | ----------------- |
| Light | 对近期短期材料进行整理和暂存 | 否 |
| Deep | 对持久候选项进行评分并提升 | 是（`MEMORY.md`） |
| Light | 整理并暂存近期短期材料 | 否 |
| Deep | 评分并提升持久候选项 | 是（`MEMORY.md`） |
| REM | 反思主题和反复出现的想法 | 否 |
这些阶段是内部实现细节，并不是单独的用户可配置“模式”。
这些阶段是内部实现细节，不是单独的用户可配置“模式”。
### Light 阶段
Light 阶段会摄取近期的每日记忆信号和召回轨迹，对其去重，并暂存候选条目。
Light 阶段会摄取近期的每日记忆信号和召回轨迹，对其去重，
并暂存候选条目。
- 在可用时，从短期召回状态、近期每日记忆文件以及已脱敏的会话转录中读取内容。
- 当存储包含内联输出时，会写入一个受管理的 `## Light Sleep` 区块。
- 从短期召回状态、近期每日记忆文件，以及可用时已脱敏的会话转录中读取。
- 当存储包含内联输出时，写入一个受管的 `## Light Sleep` 区块。
- 记录强化信号，供后续 Deep 排名使用。
- 绝不会写入 `MEMORY.md`。
@ -56,61 +58,70 @@ Light 阶段会摄取近期的每日记忆信号和召回轨迹，对其去重
Deep 阶段决定哪些内容会成为长期记忆。
- 使用加权评分和阈值门槛对候选项进行排序。
- 要求通过 `minScore`、`minRecallCount` 和 `minUniqueQueries`。
- 在写入前，会从实时的每日文件中重新提取片段，因此过时或已删除的片段会被跳过。
- 将提升后的条目追加到 `MEMORY.md`。
- 将 `## Deep Sleep` 摘要写入 `DREAMS.md`，并可选写入 `memory/dreaming/deep/YYYY-MM-DD.md`。
- 需要通过 `minScore`、`minRecallCount` 和 `minUniqueQueries`。
- 在写入前会从实时每日文件中重新提取片段，因此过时或已删除的片段会被跳过。
- 将已提升的条目追加到 `MEMORY.md`。
- 将 `## Deep Sleep` 摘要写入 `DREAMS.md`，并可选择写入 `memory/dreaming/deep/YYYY-MM-DD.md`。
### REM 阶段
REM 阶段会提取模式和反思信号。
REM 阶段提取模式和反思信号。
- 从近期短期轨迹中构建主题和反思摘要。
- 当存储包含内联输出时，会写入一个受管理的 `## REM Sleep` 区块。
- 根据近期短期轨迹构建主题和反思摘要。
- 当存储包含内联输出时，写入一个受管的 `## REM Sleep` 区块。
- 记录供 Deep 排名使用的 REM 强化信号。
- 绝不会写入 `MEMORY.md`。
## 会话转录摄取
Dreaming 可以将已脱敏的会话转录摄取到 dreaming 语料中。
当转录可用时，它们会与每日记忆信号和召回轨迹一起输入到 Light 阶段。在摄取之前，个人内容和敏感内容会被脱敏。
Dreaming 可以将已脱敏的会话转录摄取到 Dreaming 语料中。当
转录可用时，它们会与每日记忆信号和召回轨迹一起被送入 Light 阶段。个人和敏感内容会在摄取前被脱敏。
## 梦境日记
## Dream Diary
Dreaming 还会在 `DREAMS.md` 中保留一份叙事性的**梦境日记**。
在每个阶段积累了足够材料后，`memory-core` 会以尽力而为的方式运行一次后台子智能体轮次（使用默认运行时模型），并追加一条简短的日记条目。
Dreaming 还会在 `DREAMS.md` 中保留一份叙事性的 **Dream Diary**。
当每个阶段积累了足够的材料后，`memory-core` 会尽力运行一次后台
子智能体轮次（使用默认运行时模型），并追加一条简短的日记条目。
这份日记是供人类在 Dreams UI 中阅读的，不是提升来源。
由 Dreaming 生成的日记/报告工件会从短期提升中排除。只有有依据的记忆片段才有资格被提升到 `MEMORY.md`。
这份日记用于在 Dreams UI 中供人阅读，而不是作为提升来源。
由 Dreaming 生成的日记/报告产物会从短期
提升中排除。只有有依据的记忆片段才有资格被提升到
`MEMORY.md` 中。
此外，还有一条基于事实依据的历史回填通道，用于审查和恢复工作：
此外，还有一条有依据的历史回填通道，用于审查和恢复工作：
- `memory rem-harness --path ... --grounded` 会从历史 `YYYY-MM-DD.md` 笔记中预览有依据的日记输出。
- `memory rem-backfill --path ...` 会将可逆的有依据日记条目写入 `DREAMS.md`。
- `memory rem-backfill --path ... --stage-short-term` 会将有依据的持久候选项暂存到与正常 Deep 阶段已使用的同一短期证据存储中。
- `memory rem-backfill --rollback` 和 `--rollback-short-term` 会移除这些已暂存的回填工件，而不会触碰普通日记条目或实时短期召回。
- `memory rem-harness --path ... --grounded` 可从历史 `YYYY-MM-DD.md` 记录中预览有依据的日记输出。
- `memory rem-backfill --path ...` 会将可逆的、有依据的日记条目写入 `DREAMS.md`。
- `memory rem-backfill --path ... --stage-short-term` 会将有依据的持久候选项暂存到与常规 Deep 阶段已使用的同一短期证据存储中。
- `memory rem-backfill --rollback` 和 `--rollback-short-term` 会移除这些已暂存的回填产物，而不会触及普通日记条目或实时短期召回。
Control UI 公开了相同的日记回填/重置流程，因此你可以先在 Dreams 场景中检查结果，再决定这些有依据的候选项是否值得提升。该场景还会显示一条独立的有依据通道，这样你就能看到哪些已暂存的短期条目来自历史回放、哪些已提升条目由 grounded 流程引导生成，并且可以只清除仅限 grounded 的已暂存条目，而不影响普通的实时短期状态。
Control UI 也暴露了相同的日记回填/重置流程，这样你就可以先在 Dreams 场景中检查
结果，再决定这些有依据的候选项
是否值得提升。该场景还会显示一条独立的有依据通道，以便你查看
哪些已暂存的短期条目来自历史回放、哪些已提升
项目由 grounded 流程引导，以及只清除仅基于 grounded 的已暂存条目，而不
触及普通的实时短期状态。
## Deep 排名信号
Deep 排名使用六个带权重的基础信号，再加上阶段强化：
Deep 排名使用六个加权基础信号，再加上阶段强化：
| 信号 | 权重 | 说明 |
| ------------------- | ------ | ------------------------------------------------- |
| 频率 | 0.24 | 该条目累积了多少短期信号 |
| 相关性 | 0.30 | 该条目的平均检索质量 |
| 查询多样性 | 0.15 | 使其出现的不同查询/日期上下文 |
| 时新性 | 0.15 | 经过时间衰减的新鲜度分数 |
| 巩固度 | 0.10 | 跨多日重复出现的强度 |
| 概念丰富度 | 0.06 | 来自片段/路径的概念标签密度 |
| 频率 | 0.24 | 该条目累积了多少短期信号 |
| 相关性 | 0.30 | 该条目的平均检索质量 |
| 查询多样性 | 0.15 | 让它浮现出来的不同查询/日期上下文 |
| 近期性 | 0.15 | 基于时间衰减的新鲜度分数 |
| 整合度 | 0.10 | 跨日重复出现的强度 |
| 概念丰富度 | 0.06 | 来自片段/路径的概念标签密度 |
Light 和 REM 阶段命中会从 `memory/.dreams/phase-signals.json` 增加一个小幅的、按时新性衰减的提升。
来自 Light 和 REM 阶段的命中会基于
`memory/.dreams/phase-signals.json` 增加一个小幅的、按近期性衰减的提升。
## 调度
启用后，`memory-core` 会自动管理一个 cron 任务，用于执行完整的 dreaming 扫描。
每次扫描都会按顺序运行各阶段：light -> REM -> deep。
启用后，`memory-core` 会自动管理一个用于完整 Dreaming
扫描的 cron 任务。每次扫描会按顺序运行各阶段：light -> REM -> deep。
默认频率行为：
@ -120,7 +131,7 @@ Light 和 REM 阶段命中会从 `memory/.dreams/phase-signals.json` 增加一
## 快速开始
启用 dreaming：
启用 Dreaming：
```json
{
@ -138,7 +149,7 @@ Light 和 REM 阶段命中会从 `memory/.dreams/phase-signals.json` 增加一
}
```
使用自定义扫描频率启用 dreaming：
使用自定义扫描频率启用 Dreaming：
```json
{
@ -178,16 +189,18 @@ openclaw memory promote --limit 5
openclaw memory status --deep
```
手动执行 `memory promote` 时，默认会使用 Deep 阶段阈值，除非你通过 CLI 标志覆盖。
手动 `memory promote` 默认使用 Deep 阶段阈值，除非通过
CLI 标志覆盖。
说明某个特定候选项为什么会或不会被提升：
解释某个特定候选项为什么会或不会被提升：
```bash
openclaw memory promote-explain "router vlan"
openclaw memory promote-explain "router vlan" --json
```
在不写入任何内容的情况下，预览 REM 反思、候选事实和 Deep 提升输出：
预览 REM 反思、候选事实以及 Deep 提升输出，而不
写入任何内容：
```bash
openclaw memory rem-harness
@ -198,29 +211,42 @@ openclaw memory rem-harness --json
所有设置都位于 `plugins.entries.memory-core.config.dreaming` 下。
| 键 | 默认值 |
| 键名 | 默认值 |
| ----------- | ----------- |
| `enabled` | `false` |
| `frequency` | `0 3 * * *` |
阶段策略、阈值和存储行为都属于内部实现细节（不是面向用户的配置）。
阶段策略、阈值和存储行为都是内部实现
细节（不是面向用户的配置）。
完整键名列表请参阅 [记忆配置参考](/zh-CN/reference/memory-config#dreaming)。
完整键名列表请参见 [记忆配置参考](/zh-CN/reference/memory-config#dreaming)。
## Dreams UI
启用后，Gateway 网关的 **Dreams** 选项卡会显示：
启用后，Gateway 网关中的 **Dreams** 选项卡会显示：
- 当前 dreaming 启用状态
- 阶段级状态和受管理扫描的存在情况
- 短期、有依据、信号以及当日已提升计数
- 当前 Dreaming 启用状态
- 阶段级状态和受管扫描是否存在
- 短期、有依据、信号以及今日已提升数量
- 下一次计划运行时间
- 一条用于暂存历史回放条目的独立 grounded 场景通道
- 由 `doctor.memory.dreamDiary` 支持的可展开梦境日记阅读器
- 用于已暂存历史回放条目的独立 grounded 场景通道
- 由 `doctor.memory.dreamDiary` 提供支持的可展开 Dream Diary 阅读器
## 故障排除
### Dreaming 从不运行（状态显示为 blocked）
受管 Dreaming cron 依赖默认智能体的 heartbeat。如果该智能体的 heartbeat 没有触发，cron 就会排入一个无人消费的系统事件，而 Dreaming 就会静默地不运行。在这种情况下，`openclaw memory status` 和 `/dreaming status` 都会报告 `blocked`，并指出哪个智能体的 heartbeat 是阻塞源。
两个常见原因：
- 另一个智能体声明了显式的 `heartbeat:` 区块。当 `agents.list` 中任一条目拥有自己的 `heartbeat` 区块时，只有那些智能体会发送 heartbeat —— 默认设置将不再应用于所有智能体，因此默认智能体可能会静默。请将 heartbeat 设置移动到 `agents.defaults.heartbeat`，或在默认智能体上添加显式的 `heartbeat` 区块。参见 [作用域与优先级](/zh-CN/gateway/heartbeat#scope-and-precedence)。
- `heartbeat.every` 为 `0`、为空，或无法解析。cron 没有可用于调度的间隔，因此 heartbeat 实际上已被禁用。请将 `every` 设置为一个正时长，例如 `30m`。参见 [默认值](/zh-CN/gateway/heartbeat#defaults)。
## 相关内容
- [Heartbeat](/zh-CN/gateway/heartbeat)
- [记忆](/zh-CN/concepts/memory)
- [记忆搜索](/zh-CN/concepts/memory-search)
- [Memory Search](/zh-CN/concepts/memory-search)
- [memory CLI](/cli/memory)
- [记忆配置参考](/zh-CN/reference/memory-config)