Bộ nhớ

​

openclaw memory

Quản lý việc lập chỉ mục bộ nhớ ngữ nghĩa, tìm kiếm và đưa nội dung vào MEMORY.md. Được cung cấp bởi plugin memory-core đi kèm, khả dụng khi plugins.slots.memory chọn memory-core (mặc định). Các plugin bộ nhớ khác cung cấp không gian tên CLI riêng.

Liên quan: khái niệm Bộ nhớ, Dreaming, Tham chiếu cấu hình bộ nhớ, Wiki bộ nhớ, wiki, Plugin.

​

memory status

openclaw memory status [--agent <id>] [--deep] [--index] [--fix] [--json] [--verbose]

Nếu không có --agent, lệnh sẽ chạy cho mọi tác tử trong agents.list; nếu chưa cấu hình danh sách tác tử, lệnh sẽ dùng tác tử mặc định.

Cờ	Tác dụng
--deep	Kiểm tra mức độ sẵn sàng của kho vectơ, nhà cung cấp embedding và tìm kiếm ngữ nghĩa (dẫn đến các lệnh gọi bổ sung tới nhà cung cấp). memory status thông thường vẫn chạy nhanh và bỏ qua bước này; trạng thái vectơ/ngữ nghĩa không xác định nghĩa là chưa được kiểm tra. Chế độ từ vựng QMD searchMode: "search" luôn bỏ qua kiểm tra vectơ ngữ nghĩa, kể cả khi có --deep.
--index	Lập chỉ mục lại nếu kho đang ở trạng thái bẩn. Bao hàm --deep.
--fix	Sửa các khóa truy hồi cũ và chuẩn hóa siêu dữ liệu đưa vào bộ nhớ.
--json	In JSON.
--verbose	Xuất nhật ký chi tiết theo từng giai đoạn.

Nếu dòng Dreaming vẫn ở trạng thái off ngay cả khi có dreaming.enabled: true, hoặc các lượt quét theo lịch dường như không bao giờ chạy, Cron Dreaming được quản lý phụ thuộc vào Heartbeat của tác tử mặc định được kích hoạt để bắt đầu quá trình đối soát. Xem Dreaming để biết chi tiết về lịch chạy.

Trạng thái cũng liệt kê mọi đường dẫn tìm kiếm bổ sung từ agents.defaults.memorySearch.extraPaths.

​

memory index

openclaw memory index [--agent <id>] [--force] [--verbose]

Có cùng phạm vi theo tác tử như status. --force thực hiện lập chỉ mục lại toàn bộ thay vì lập chỉ mục tăng dần. --verbose in thông tin về nhà cung cấp, mô hình, nguồn và đường dẫn bổ sung của từng tác tử trước khi hiển thị tiến trình lập chỉ mục.

​

memory search

openclaw memory search [query] [--query <text>] [--agent <id>] [--max-results <n>] [--min-score <n>] [--json]

• Truy vấn: đối số vị trí [query] hoặc --query <text>. Nếu đặt cả hai, --query được ưu tiên. Nếu không đặt đối số nào, lệnh sẽ báo lỗi.
• --agent <id>: mặc định là tác tử mặc định (không phải toàn bộ danh sách tác tử).
• --max-results <n>: giới hạn số lượng kết quả (số nguyên dương).
• --min-score <n>: lọc bỏ các kết quả khớp có điểm thấp hơn giá trị này.

​

memory promote

Xếp hạng các ứng viên ngắn hạn từ memory/YYYY-MM-DD.md và tùy chọn nối thêm các mục hàng đầu vào MEMORY.md.

openclaw memory promote [--agent <id>] [--limit <n>] [--min-score <n>] \
  [--min-recall-count <n>] [--min-unique-queries <n>] [--apply] [--include-promoted] [--json]

Cờ	Mặc định	Tác dụng
--limit <n>		Số ứng viên tối đa cần trả về/áp dụng.
--min-score <n>	0.75	Điểm đưa vào bộ nhớ có trọng số tối thiểu.
--min-recall-count <n>	3	Số lượt truy hồi tối thiểu bắt buộc.
--min-unique-queries <n>	2	Số truy vấn riêng biệt tối thiểu bắt buộc.
--apply	chỉ xem trước	Nối các ứng viên đã chọn vào MEMORY.md và đánh dấu là đã được đưa vào bộ nhớ.
--include-promoted		Bao gồm các ứng viên đã được đưa vào bộ nhớ trong những chu kỳ trước.
--json		In JSON.

Các giá trị mặc định của CLI này khác với ngưỡng giai đoạn sâu của lượt quét Dreaming theo lịch (xem Dreaming bên dưới); hãy truyền các cờ tường minh để khớp với hành vi quét khi chạy thủ công một lần.

Các tín hiệu xếp hạng: tần suất truy hồi, mức độ liên quan khi truy xuất, độ đa dạng truy vấn, độ mới theo thời gian, sự hợp nhất qua nhiều ngày và độ phong phú của khái niệm dẫn xuất, được lấy từ cả các lượt truy hồi bộ nhớ lẫn các lượt nhập hằng ngày, cùng với mức tăng cường nhẹ từ giai đoạn nhẹ/REM cho những lần Dreaming lặp lại. Trước khi ghi, quá trình đưa vào bộ nhớ sẽ đọc lại ghi chú hằng ngày hiện hành, vì vậy các chỉnh sửa hoặc nội dung bị xóa khỏi đoạn trích ngắn hạn sau khi xếp hạng vẫn được tôn trọng, thay vì đưa nội dung từ một ảnh chụp cũ vào bộ nhớ.

​

memory promote-explain

Giải thích chi tiết cách tính điểm của một ứng viên đưa vào bộ nhớ.

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]

<selector> khớp với khóa (chính xác hoặc chuỗi con), đường dẫn hoặc văn bản đoạn trích của ứng viên.

​

memory rem-harness

Xem trước các suy ngẫm REM, các sự thật ứng viên và kết quả đưa vào bộ nhớ của giai đoạn sâu mà không ghi bất kỳ nội dung nào.

openclaw memory rem-harness [--agent <id>] [--path <file-or-dir>] [--grounded] [--include-promoted] [--json]

• --path <file-or-dir>: khởi tạo bộ thử nghiệm từ các tệp hằng ngày YYYY-MM-DD.md trong lịch sử thay vì không gian làm việc hiện hành.
• --grounded: đồng thời kết xuất bản xem trước có căn cứ gồm Điều đã xảy ra / Suy ngẫm / Các cập nhật lâu dài khả dĩ từ các ghi chú lịch sử.

​

memory rem-backfill

Ghi các bản tóm tắt REM lịch sử có căn cứ vào DREAMS.md để xem xét trong giao diện người dùng. Có thể hoàn tác.

openclaw memory rem-backfill --path <file-or-dir> [--agent <id>] [--stage-short-term] [--json]
openclaw memory rem-backfill --rollback [--rollback-short-term] [--json]

• --path <file-or-dir>: bắt buộc trừ khi đặt --rollback/--rollback-short-term. Một hoặc nhiều tệp bộ nhớ hằng ngày trong lịch sử hoặc thư mục dùng làm nguồn để điền bù.
• --stage-short-term: đồng thời đưa các ứng viên bền vững có căn cứ vào kho đưa vào bộ nhớ ngắn hạn hiện hành để giai đoạn sâu thông thường có thể xếp hạng chúng.
• --rollback: xóa các mục nhật ký có căn cứ đã ghi trước đó khỏi DREAMS.md.
• --rollback-short-term: xóa các ứng viên ngắn hạn có căn cứ đã được đưa vào trước đó.

​

Dreaming

Dreaming là hệ thống hợp nhất bộ nhớ chạy nền với ba giai đoạn phối hợp, chạy theo thứ tự trong cùng một lịch: nhẹ (sắp xếp/chuẩn bị tài liệu ngắn hạn), REM (suy ngẫm và làm nổi bật các chủ đề), sâu (đưa các dữ kiện bền vững vào MEMORY.md). Chỉ giai đoạn sâu ghi vào MEMORY.md.

• Bật bằng plugins.entries.memory-core.config.dreaming.enabled: true (mặc định là false); memory-core tự động quản lý tác vụ Cron quét, không cần chạy thủ công openclaw cron add.
• Bật/tắt từ cuộc trò chuyện bằng /dreaming on|off; kiểm tra bằng /dreaming status (hoặc /dreaming//dreaming help). on/off yêu cầu trạng thái chủ sở hữu kênh hoặc quyền operator.admin của Gateway; trạng thái và trợ giúp vẫn khả dụng cho bất kỳ ai có thể gọi lệnh.
• Kết quả dễ đọc của từng giai đoạn được ghi vào DREAMS.md (hoặc tệp dreams.md hiện có). Theo mặc định (dreaming.storage.mode: "separate"), mỗi giai đoạn cũng ghi một báo cáo độc lập vào memory/dreaming/<phase>/YYYY-MM-DD.md; đặt mode: "inline" để gộp các báo cáo vào tệp bộ nhớ hằng ngày, hoặc "both" để dùng cả hai.
• Các lượt chạy theo lịch và chạy thủ công bằng memory promote sử dụng chung các tín hiệu xếp hạng của giai đoạn sâu; chỉ các ngưỡng mặc định là khác nhau (xem bảng bên trên so với các giá trị mặc định theo lịch bên dưới).
• Các lượt chạy theo lịch được phân phối trên không gian làm việc bộ nhớ của mọi tác tử đã cấu hình.

Các giá trị mặc định theo lịch (plugins.entries.memory-core.config.dreaming):

Khóa	Mặc định
frequency	0 3 * * *
phases.deep.minScore	0.8
phases.deep.minRecallCount	3
phases.deep.minUniqueQueries	3
phases.deep.recencyHalfLifeDays	14
phases.deep.maxAgeDays	30
phases.deep.maxPromotedSnippetTokens	160

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true
          }
        }
      }
    }
  }
}

Danh sách khóa đầy đủ và chi tiết từng giai đoạn: Dreaming, Tham chiếu cấu hình bộ nhớ.

​

Phụ thuộc Gateway của SecretRef

Nếu các trường khóa API từ xa của Active Memory được cấu hình dưới dạng SecretRef, các lệnh memory sẽ phân giải chúng từ ảnh chụp Gateway đang hoạt động; nếu Gateway không khả dụng, lệnh sẽ thất bại ngay. Điều này yêu cầu Gateway hỗ trợ phương thức secrets.resolve; các Gateway cũ hơn sẽ trả về lỗi không xác định phương thức.

​

Liên quan

• Tham chiếu CLI
• Tổng quan về bộ nhớ