OpenClaw Memory Resilience

Covers the two highest-impact layers of memory durability for OpenClaw agents.

The Four Memory Layers (quick reference)

Layer	What it is	Survives compaction?
Bootstrap files (SOUL.md, AGENTS.md, etc.)	Injected from disk at every session start	Yes — reloaded from disk
Session transcript (JSONL on disk)

Core rule: If it's not written to a file, it doesn't exist after compaction.

Three Failure Modes

- Failure A — Instruction only existed in conversation, never written to a file. Most common.
Failure B — Compaction summarized it away. Lossy. Nuance lost.
Failure C — Session pruning trimmed old tool results. Temporary, lossless.

Diagnostic: Forgot a preference? → Failure A. Forgot what a tool returned? → Failure C. Forgot the whole thread? → Failure B.

Layer 1: Gateway Compaction Config

Apply via gateway config.patch. This is a global default — applies to all agents:

CODEBLOCK0

See references/config-explained.md for why each value is set the way it is.

Layer 3: File Architecture

See references/file-architecture.md for the full pattern — bootstrap files, daily notes, archival, and QMD indexing.

Context Footer Standard

Add to every agent's SOUL.md. This gives you real-time visibility into context fill and compaction count — the single fastest way to know when to act before you hit the bad compaction path.

CODEBLOCK1

See references/context-footer.md for why this matters and how to tune the thresholds.

Diagnosing Problems

Run /context list in any OpenClaw session to see:

- Which bootstrap files loaded and at what size
Whether any files are TRUNCATED (over per-file limit)
Total injected chars vs raw chars

If a file shows TRUNCATED: reduce it or raise bootstrapMaxChars in config.
If a file is missing entirely: check the workspace path in agent config.

OpenClaw 记忆韧性

涵盖 OpenClaw 智能体记忆持久性中影响最大的两个层级。

四层记忆结构（快速参考）

层级	内容	压缩后是否保留？
引导文件（SOUL.md、AGENTS.md 等）	每次会话启动时从磁盘注入	是——从磁盘重新加载
会话记录（磁盘上的 JSONL）

核心规则： 如果未写入文件，压缩后即不存在。

三种故障模式

- 故障 A —— 指令仅存在于对话中，从未写入文件。最常见。
故障 B —— 压缩将其摘要化。有损。细节丢失。
故障 C —— 会话修剪删除了旧的工具结果。临时性，无损。

诊断：忘记偏好？ → 故障 A。忘记工具返回了什么？ → 故障 C。忘记整个线程？ → 故障 B。

第一层：网关压缩配置

通过 gateway config.patch 应用。这是全局默认设置——适用于所有智能体：

json
{
agents: {
defaults: {
compaction: {
mode: safeguard,
reserveTokensFloor: 40000,
memoryFlush: {
enabled: true,
softThresholdTokens: 4000,
systemPrompt: 会话即将压缩。请立即存储持久化记忆。,
prompt: 将任何需要保留的笔记写入 memory/YYYY-MM-DD.md；若无内容需存储，回复 NO_REPLY。
}
},
contextPruning: {
mode: cache-ttl,
ttl: 1h
}
}
}
}

每个值的设置原因请参见 references/config-explained.md。

第三层：文件架构

完整模式请参见 references/file-architecture.md——包括引导文件、每日笔记、归档和 QMD 索引。

上下文页脚标准

添加到每个智能体的 SOUL.md 中。这将为您提供上下文填充和压缩次数的实时可见性——这是在进入不良压缩路径前采取行动的最快方式。

markdown

上下文管理（自动应用）

每次响应： 通过 session_status 获取实时状态，附加页脚：🧠 [已用]/[总计] ([百分比]) | 🧹 [压缩次数]

- 自动清除：85% 上下文 或 6 次压缩
警告：70% 上下文 或 4 次压缩
清除前：将关键信息归档到记忆，然后重置

为何重要以及如何调整阈值，请参见 references/context-footer.md。

诊断问题

在任何 OpenClaw 会话中运行 /context list 可查看：

- 加载了哪些引导文件及其大小
是否有文件被截断（超过单文件限制）
总注入字符数与原始字符数

如果文件显示 TRUNCATED：减小文件大小或在配置中提高 bootstrapMaxChars。
如果文件完全缺失：检查智能体配置中的工作空间路径。

openclaw-memory-resilience记忆弹性配置