OpenClaw 記憶體解釋：架構、設定及其忘記原因

完整的 OpenClaw 記憶體架構（3 層解釋）

OpenClaw 記憶體跨三個不同的層運行，每個層都有不同的持久性特徵和故障模式。

完整的記憶體生命週期：

Write → Embed/Index → Search → Compact → Recover
  ↓          ↓           ↓         ↓         ↓
.md file   sqlite-vec  semantic  summary   MEMORY.md
created    indexes it  query     replaces  re-read at
           on save     returns   context   session start
                       chunks    window

該鏈中的每個階段都可能獨立失敗。大多數遺忘問題都可以追溯到一個破碎的階段。

第 1 層 — 活動上下文視窗

這是模型的工作記憶：目前載入到活動對話情境視窗中的所有內容。它包括您的系統提示、對話歷史記錄以及搜尋工具檢索到的任何記憶體區塊。

裡面裝的是什麼：

• 系統提示符號（通常很大）
• 檢索記憶摘錄
• 工具呼叫歷史記錄
• 話鋒一轉

實際限制：假設在系統提示和記憶體開銷之後，您有大約 60-70% 的模型廣告上下文視窗可用於實際對話。

第 2 層 — 每日筆記（滾動兩天視窗）

每日筆記是以 YYYY-MM-DD 格式命名的僅附加 Markdown 文件，儲存在 memory/ 目錄中。 OpenClaw 載入 今天和昨天的 在每個會話開始時自動產生文件。

• 有關今天工作、做出的決定和活動任務的事實附加在此處
• 它們不應該被編輯——將它們視為日誌
• 兩天后，它們超出了自動加載窗口，只能通過語義搜索進行搜索

第 3 層 — 持久記憶體（MEMORY.md 和 memory-wiki）

跨會話應保留的長期事實（您的姓名、專案情境、編碼偏好、架構決策）屬於 MEMORY.md 或結構化 memory-wiki 外掛程式庫。

壓縮問題－為什麼你的指令在任務中消失

壓縮是 OpenClaw 中記錄最多的故障模式。大多數文章都涉及會話後遺忘。幾乎沒有地址 長時間運作的自主工作流程中的中期任務壓縮 — 當代理執行多步驟任務時，壓縮會在 12 步驟中的第 7 步靜默觸發，而第 1 步驟中的行為指令消失。

壓縮的作用是什麼：

1. 檢測上下文視窗接近容量
2. 將目前對話總結為壓縮區塊
3. 用摘要取代原始上下文
4. 繼續執行

當它觸發時： 預設 memory-core 插件中沒有可設定的閾值。它根據令牌計數而不是任務階段觸發。在 2 小時的自主運作中，您預計會有 3-5 個壓實週期。

如何建構抗壓縮檔案架構

將行為指令固定在 MEMORY.md 中，而不是對話中。 任何必須在多個壓縮週期中生存的內容都需要保存在持久性檔案中，該檔案在每次壓縮後都會重新讀取。

建議的固定模式：

## Agent Behavioral Rules (always active)
- Never overwrite files without showing a diff first
- Write tests before implementation (TDD mode: on)
- Use TypeScript strict mode in all new files

## Project Context
- Stack: Node.js 22, Fastify, PostgreSQL 16
- Repo root: /home/user/project
- Active sprint goal: migrate auth to Clerk

壓縮後的命名約定：

• 使用 ## [PINNED] 為關鍵部分添加前綴 - 摘要器將大寫標頭視為高優先級
• 盡可能將每個固定事實保留在一行中 - 總結密集的段落，單行事實往往會逐字保留
• 在 MEMORY.md 和今天的每日筆記中重複 3-5 個最關鍵的行為規則 - 冗餘是你的壓縮對沖

10 分鐘內從零到記憶體設定（完整檔案支架）

這是其他地方不存在的設定指南。複製這個結構，填寫你的上下文，然後你就可以運作了。

目錄樹：

memory/
├── MEMORY.md
├── 2026-04-27.md          ← today's daily note (create manually)
└── wiki/                  ← only if using memory-wiki plugin
    ├── index.md
    ├── project-context.md
    └── decisions.md

啟動器MEMORY.md：

# Persistent Memory

## Identity & Preferences
- Name: [your name]
- Role: [your role]
- Preferred response style: concise, no preamble

## Project: [Project Name]
- Stack: [your stack]
- Key constraints: [e.g., no external APIs, TypeScript only]
- Current focus: [active task or sprint goal]

## Behavioral Rules
- [Rule 1]
- [Rule 2]

## Decisions Made
- [YYYY-MM-DD] Decided to use X because Y

入門每日筆記 (2026-04-27.md)：

# 2026-04-27

## Session Goals
- [ ] Task 1
- [ ] Task 2

## Notes

插件槽配置（2026語法）：

{
  "plugins": {
    "slots": {
      "memory": "memory-core"
    }
  }
}

要完全禁用記憶體：

{
  "plugins": {
    "slots": {
      "memory": false
    }
  }
}

驗證步驟：

1. 執行一次會話並要求客服人員回憶您在上一次會話中告訴過的內容
2. 檢查 memory/YYYY-MM-DD.md 是否已寫入（它應該有新內容）
3. 直接問經紀人：「你對我了解多少？」— 它應該從 MEMORY.md 中提取

為生產知識庫配置記憶體維基

透過交換插件插槽來啟用它：

{
  "plugins": {
    "slots": {
      "memory": "memory-wiki"
    }
  }
}

memory-wiki 在 memory/wiki/ 下產生一個結構化保管庫。每個主題都有自己的頁面。該插件編譯一個 digest.md ，它聚合了高可信度、無矛盾的事實，以便代理在會話開始時加載。

生產代理的實用保險庫結構：

memory/wiki/
├── index.md              ← vault table of contents
├── digest.md             ← auto-generated; agent reads this
├── project-context.md    ← stack, goals, constraints
├── decisions.md          ← architectural decisions log
├── team.md               ← stakeholders, contacts
└── domain-knowledge.md   ← business rules, glossary

語意搜尋與嵌入－SQLite、sqlite-vec 和 JS Fallback

OpenClaw 使用以下方式索引您的記憶體文件 SQLite with the sqlite-vec extension 用於向量相似性搜尋。當您或代理程式發出記憶體搜尋時，它會嵌入查詢並檢索語義上最相關的區塊。

驗證您的向量儲存是否正常：

# Check that the memory index exists
ls memory/.index/

# Reset a corrupted index (safe to run — it rebuilds from .md files)
rm -rf memory/.index/ && OpenClaw reindex

如果 sqlite-vec 不可用（在 ARM Linux 和某些 Windows 配置上常見），OpenClaw 將回退到純 JS 向量擴充。明確強制回退：

{
  "memory": {
    "vectorBackend": "js"
  }
}

特定於段的記憶體策略

獨立開發人員 - 最小的開銷，最大的召回率

建議設定：memory-core 外掛程式、MEMORY.md + 僅每日筆記，無 wiki 庫。

• 將 MEMORY.md 保持在 200 行以下 - 較長的檔案會減慢會話啟動速度
• 積極地添加日常筆記；不要試圖保持它們乾淨
• 每週審查和修剪 MEMORY.md — 過時的事實會降低搜尋質量

多代理管道－跨代理共享內存

當多個代理程式讀取和寫入相同 memory/ 目錄時，您需要明確的所有權規則。

• One agent owns writes to each file — 並發寫入同一個 .md 檔案會產生衝突
• 每個代理程式使用子目錄：memory/agent-a/、memory/agent-b/，以及共享的 memory/shared/MEMORY.md
• 使用記憶體維基作為共享庫 - 它的摘要編譯比原始文件更好地處理多個編寫者之間的新鮮度

長時間運作的自主任務－存活執行時間

對於運行以小時為單位的任務的代理：

• Force memory writes at checkpoints — 在每個主要任務階段之後，指示代理將其當前狀態附加到今天的每日筆記中
• Pre-load compaction-resistant context — 在執行開始之前將完整的任務規格放入 MEMORY.md 中，而不僅僅是在初始訊息中
• Set explicit continuation markers 在日常筆記中：<!-- RESUME POINT: completed steps 1-4, next: step 5 -->，以便代理人可以在壓實週期後自我定向

OpenClaw 記憶體故障排除 — 在 2 分鐘內診斷任何遺忘問題

按順序完成這些步驟：

常見問題

最終結論——實際有效的記憶體設置

Recommended baseline 針對大多數使用者： memory-core 插件，在第一次會話之前建立的 memory/ 目錄，MEMORY.md 在明確標記的固定部分中包含行為規則，在每個會話中附加每日註釋。

您的行動清單：

• 在專案根目錄中建立 memory/ 目錄
• 複製上面的起始 MEMORY.md 範本並填寫您的上下文
• 驗證 plugins.slots.memory 設定為 "memory-core" （或您選擇的插件）
• 在 MEMORY.md 中的 ## [PINNED] 下新增 3–5 個最關鍵的行為規則
• 第一次會議後，確認已寫下註明日期的每日筆記
• 如果語意搜尋感覺不太好，請執行 OpenClaw reindex 來重建向量索引

一旦你了解它，這個架構就是合理的。大多數遺忘問題會在遵循此清單後 10 分鐘內解決。