Tổng quan về bộ nhớ

OpenClaw ghi nhớ mọi thứ bằng cách ghi các tệp Markdown thuần túy trong workspace của agent. Mô hình chỉ “nhớ” những gì được lưu vào ổ đĩa — không có trạng thái ẩn.

Cách hoạt động

Agent của bạn có ba tệp liên quan đến bộ nhớ:

MEMORY.md — bộ nhớ dài hạn. Các sự kiện, tùy chọn và quyết định bền vững. Được tải khi bắt đầu mỗi phiên DM.
memory/YYYY-MM-DD.md — ghi chú hằng ngày. Ngữ cảnh và quan sát đang diễn ra. Ghi chú hôm nay và hôm qua được tải tự động.
DREAMS.md (tùy chọn) — nhật ký Dreaming và tóm tắt lượt quét dreaming để con người xem xét, bao gồm các mục bổ sung lịch sử có căn cứ.

Các tệp này nằm trong workspace của agent (mặc định ~/.openclaw/workspace).

Nội dung nào đặt ở đâu

MEMORY.md là lớp được tuyển chọn, gọn nhẹ. Dùng tệp này cho các sự kiện bền vững, tùy chọn, quyết định thường trực và tóm tắt ngắn cần có sẵn khi bắt đầu một phiên riêng tư chính. Tệp này không dành để làm bản ghi thô, nhật ký hằng ngày, hoặc kho lưu trữ đầy đủ. Các tệp memory/YYYY-MM-DD.md là lớp làm việc. Dùng chúng cho ghi chú hằng ngày chi tiết, quan sát, tóm tắt phiên và ngữ cảnh thô có thể vẫn hữu ích về sau. Các tệp này được lập chỉ mục cho memory_search và memory_get, nhưng chúng không được chèn vào prompt khởi động bình thường ở mọi lượt. Theo thời gian, agent được kỳ vọng sẽ chắt lọc nội dung hữu ích từ ghi chú hằng ngày vào MEMORY.md và loại bỏ các mục dài hạn đã lỗi thời. Các hướng dẫn workspace được tạo và luồng Heartbeat có thể làm việc đó định kỳ; bạn không cần chỉnh sửa MEMORY.md thủ công cho mọi chi tiết được ghi nhớ. Nếu MEMORY.md vượt quá ngân sách tệp khởi động, OpenClaw vẫn giữ nguyên tệp trên ổ đĩa nhưng cắt ngắn bản sao được chèn vào ngữ cảnh mô hình. Hãy xem đó là tín hiệu để chuyển nội dung chi tiết trở lại memory/*.md, chỉ giữ phần tóm tắt bền vững trong MEMORY.md, hoặc tăng giới hạn khởi động nếu bạn rõ ràng muốn dùng thêm ngân sách prompt. Dùng /context list, /context detail, hoặc openclaw doctor để xem kích thước thô so với kích thước được chèn và trạng thái cắt ngắn.

Nếu bạn muốn agent ghi nhớ điều gì, chỉ cần yêu cầu nó: “Hãy nhớ rằng tôi thích TypeScript.” Nó sẽ ghi điều đó vào tệp phù hợp.

Cam kết được suy luận

Một số lượt theo dõi trong tương lai không phải là sự kiện bền vững. Nếu bạn nhắc đến một buổi phỏng vấn vào ngày mai, ký ức hữu ích có thể là “hỏi thăm sau buổi phỏng vấn,” chứ không phải “lưu điều này mãi mãi trong MEMORY.md.” Commitments là các ký ức theo dõi ngắn hạn, phải bật tường minh, dành cho trường hợp đó. OpenClaw suy luận chúng trong một lượt nền ẩn, giới hạn phạm vi chúng vào cùng agent và kênh, rồi gửi các lượt hỏi thăm đến hạn thông qua Heartbeat. Các lời nhắc tường minh vẫn dùng tác vụ đã lên lịch.

Công cụ bộ nhớ

Agent có hai công cụ để làm việc với bộ nhớ:

memory_search — tìm ghi chú liên quan bằng tìm kiếm ngữ nghĩa, ngay cả khi cách diễn đạt khác với bản gốc.
memory_get — đọc một tệp bộ nhớ hoặc phạm vi dòng cụ thể.

Cả hai công cụ đều do Plugin active memory cung cấp (mặc định: memory-core).

Plugin đồng hành Memory Wiki

Nếu bạn muốn bộ nhớ bền vững hoạt động giống một cơ sở tri thức được duy trì hơn là chỉ các ghi chú thô, hãy dùng Plugin memory-wiki được đóng gói sẵn. memory-wiki biên dịch tri thức bền vững vào một kho wiki với:

cấu trúc trang xác định
các khẳng định và bằng chứng có cấu trúc
theo dõi mâu thuẫn và độ mới
dashboard được tạo
digest đã biên dịch cho người tiêu dùng agent/runtime
các công cụ gốc wiki như wiki_search, wiki_get, wiki_apply, và wiki_lint

Nó không thay thế Plugin active memory. Plugin active memory vẫn sở hữu recall, promotion và Dreaming. memory-wiki thêm một lớp tri thức giàu nguồn gốc bên cạnh. Xem Memory Wiki.

Tìm kiếm bộ nhớ

Khi nhà cung cấp embedding được cấu hình, memory_search dùng tìm kiếm lai — kết hợp độ tương đồng vector (ý nghĩa ngữ nghĩa) với khớp từ khóa (các thuật ngữ chính xác như ID và ký hiệu mã). Tính năng này hoạt động ngay sau khi bạn có API key cho bất kỳ nhà cung cấp được hỗ trợ nào.

OpenClaw tự động phát hiện nhà cung cấp embedding của bạn từ các API key có sẵn. Nếu bạn đã cấu hình khóa OpenAI, Gemini, Voyage hoặc Mistral, tìm kiếm bộ nhớ sẽ được bật tự động.

Để biết chi tiết về cách tìm kiếm hoạt động, tùy chọn tinh chỉnh và thiết lập nhà cung cấp, xem Tìm kiếm bộ nhớ.

Backend bộ nhớ

Tích hợp sẵn (mặc định)

Dựa trên SQLite. Hoạt động ngay với tìm kiếm từ khóa, độ tương đồng vector và tìm kiếm lai. Không cần phụ thuộc bổ sung.

QMD

Sidecar ưu tiên cục bộ với reranking, mở rộng truy vấn và khả năng lập chỉ mục các thư mục bên ngoài workspace.

Honcho

Bộ nhớ xuyên phiên theo hướng AI-native với mô hình hóa người dùng, tìm kiếm ngữ nghĩa và nhận thức đa agent. Cài đặt Plugin.

LanceDB

Bộ nhớ được đóng gói sẵn, hậu thuẫn bởi LanceDB, với embedding tương thích OpenAI, auto-recall, auto-capture và hỗ trợ embedding Ollama cục bộ.

Lớp wiki tri thức

Memory Wiki

Biên dịch bộ nhớ bền vững vào một kho wiki giàu nguồn gốc với các khẳng định, dashboard, chế độ bridge và quy trình làm việc thân thiện với Obsidian.

Tự động flush bộ nhớ

Trước khi Compaction tóm tắt cuộc trò chuyện của bạn, OpenClaw chạy một lượt im lặng nhắc agent lưu ngữ cảnh quan trọng vào các tệp bộ nhớ. Tính năng này được bật mặc định — bạn không cần cấu hình gì. Để giữ lượt dọn dẹp đó trên một mô hình cục bộ, đặt override chính xác cho mô hình flush bộ nhớ:

{
  "agents": {
    "defaults": {
      "compaction": {
        "memoryFlush": {
          "model": "ollama/qwen3:8b"
        }
      }
    }
  }
}

Override chỉ áp dụng cho lượt flush bộ nhớ và không kế thừa chuỗi fallback của phiên đang hoạt động.

Flush bộ nhớ ngăn mất ngữ cảnh trong quá trình Compaction. Nếu agent của bạn có các sự kiện quan trọng trong cuộc trò chuyện chưa được ghi vào tệp, chúng sẽ được lưu tự động trước khi phần tóm tắt diễn ra.

Dreaming

Dreaming là một lượt hợp nhất bộ nhớ chạy nền tùy chọn. Nó thu thập các tín hiệu ngắn hạn, chấm điểm ứng viên và chỉ promotion các mục đủ điều kiện vào bộ nhớ dài hạn (MEMORY.md). Nó được thiết kế để giữ bộ nhớ dài hạn có tín hiệu cao:

Bật tùy chọn: tắt theo mặc định.
Được lên lịch: khi bật, memory-core tự động quản lý một cron job lặp lại cho một lượt quét Dreaming đầy đủ.
Có ngưỡng: promotion phải vượt qua các cổng về điểm số, tần suất recall và độ đa dạng truy vấn.
Có thể xem xét: tóm tắt pha và mục nhật ký được ghi vào DREAMS.md để con người xem xét.

Để biết hành vi pha, tín hiệu chấm điểm và chi tiết Dream Diary, xem Dreaming.

Backfill có căn cứ và promotion trực tiếp

Hệ thống Dreaming hiện có hai làn xem xét liên quan chặt chẽ:

Dreaming trực tiếp làm việc từ kho Dreaming ngắn hạn trong memory/.dreams/ và là cơ chế mà pha sâu bình thường dùng khi quyết định nội dung nào có thể tốt nghiệp vào MEMORY.md.
Backfill có căn cứ đọc các ghi chú lịch sử memory/YYYY-MM-DD.md như các tệp ngày độc lập và ghi đầu ra xem xét có cấu trúc vào DREAMS.md.

Backfill có căn cứ hữu ích khi bạn muốn phát lại các ghi chú cũ hơn và kiểm tra những gì hệ thống cho là bền vững mà không chỉnh sửa MEMORY.md thủ công. Khi bạn dùng:

openclaw memory rem-backfill --path ./memory --stage-short-term

các ứng viên bền vững có căn cứ không được promotion trực tiếp. Chúng được đưa vào cùng kho Dreaming ngắn hạn mà pha sâu bình thường đã dùng. Điều đó nghĩa là:

DREAMS.md vẫn là bề mặt xem xét dành cho con người.
kho ngắn hạn vẫn là bề mặt xếp hạng dành cho máy.
MEMORY.md vẫn chỉ được ghi bởi promotion sâu.

Nếu bạn quyết định rằng lần phát lại đó không hữu ích, bạn có thể xóa các artifact đã staged mà không chạm vào các mục nhật ký thông thường hoặc trạng thái recall bình thường:

openclaw memory rem-backfill --rollback
openclaw memory rem-backfill --rollback-short-term

CLI

openclaw memory status          # Kiểm tra trạng thái chỉ mục và nhà cung cấp
openclaw memory search "query"  # Tìm kiếm từ dòng lệnh
openclaw memory index --force   # Xây dựng lại chỉ mục

Đọc thêm

Công cụ bộ nhớ tích hợp sẵn: backend SQLite mặc định.
Công cụ bộ nhớ QMD: sidecar ưu tiên cục bộ nâng cao.
Bộ nhớ Honcho: bộ nhớ xuyên phiên theo hướng AI-native.
Memory LanceDB: Plugin hậu thuẫn bởi LanceDB với embedding tương thích OpenAI.
Memory Wiki: kho tri thức đã biên dịch và công cụ gốc wiki.
Tìm kiếm bộ nhớ: pipeline tìm kiếm, nhà cung cấp và tinh chỉnh.
Dreaming: promotion nền từ recall ngắn hạn sang bộ nhớ dài hạn.
Tham chiếu cấu hình bộ nhớ: tất cả núm cấu hình.
Compaction: cách Compaction tương tác với bộ nhớ.

Documentation Index

​Cách hoạt động

​Nội dung nào đặt ở đâu

​Cam kết được suy luận

​Công cụ bộ nhớ

​Plugin đồng hành Memory Wiki

​Tìm kiếm bộ nhớ

​Backend bộ nhớ

Tích hợp sẵn (mặc định)

QMD

Honcho

LanceDB

​Lớp wiki tri thức

Memory Wiki

​Tự động flush bộ nhớ

​Dreaming

​Backfill có căn cứ và promotion trực tiếp

​CLI

​Đọc thêm

​Liên quan

Cách hoạt động

Nội dung nào đặt ở đâu

Cam kết được suy luận

Công cụ bộ nhớ

Plugin đồng hành Memory Wiki

Tìm kiếm bộ nhớ

Backend bộ nhớ

Lớp wiki tri thức

Tự động flush bộ nhớ

Dreaming

Backfill có căn cứ và promotion trực tiếp

CLI

Đọc thêm

Liên quan