English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

CLI commands

Bộ nhớ

openclaw memory

Quản lý lập chỉ mục và tìm kiếm bộ nhớ ngữ nghĩa. Được cung cấp bởi plugin memory-core đi kèm. Lệnh này khả dụng khi plugins.slots.memory chọn memory-core (mặc định); các plugin bộ nhớ khác cung cấp namespace CLI riêng của chúng.

Liên quan:

Ví dụ

bash
openclaw memory statusopenclaw memory status --deepopenclaw memory status --fixopenclaw memory index --forceopenclaw memory search "meeting notes"openclaw memory search --query "deployment" --max-results 20openclaw memory promote --limit 10 --min-score 0.75openclaw memory promote --applyopenclaw memory promote --json --min-recall-count 0 --min-unique-queries 0openclaw memory promote-explain "router vlan"openclaw memory promote-explain "router vlan" --jsonopenclaw memory rem-harnessopenclaw memory rem-harness --jsonopenclaw memory status --jsonopenclaw memory status --deep --indexopenclaw memory status --deep --index --verboseopenclaw memory status --agent mainopenclaw memory index --agent main --verbose

Tùy chọn

memory status và memory index:

  • --agent <id>: giới hạn phạm vi vào một agent duy nhất. Khi không có tùy chọn này, các lệnh này chạy cho từng agent đã cấu hình; nếu chưa cấu hình danh sách agent, chúng dùng lại agent mặc định.
  • --verbose: phát nhật ký chi tiết trong khi thăm dò và lập chỉ mục.

memory status:

  • --deep: thăm dò mức sẵn sàng của kho vector cục bộ, mức sẵn sàng của nhà cung cấp embedding, và mức sẵn sàng của tìm kiếm vector ngữ nghĩa. memory status thông thường vẫn nhanh và không chạy embedding trực tiếp hoặc công việc khám phá nhà cung cấp; trạng thái kho vector hoặc vector ngữ nghĩa không xác định nghĩa là trạng thái đó chưa được thăm dò trong lệnh đó. QMD lexical searchMode: "search" bỏ qua thăm dò vector ngữ nghĩa và bảo trì embedding ngay cả với --deep.
  • --index: chạy lập chỉ mục lại nếu kho đang bẩn (ngụ ý --deep).
  • --fix: sửa các khóa recall cũ và chuẩn hóa siêu dữ liệu promotion.
  • --json: in đầu ra JSON.

Nếu memory status hiển thị Dreaming status: blocked, cron Dreaming được quản lý đã bật nhưng heartbeat điều khiển nó không kích hoạt cho agent mặc định. Xem Dreaming không bao giờ chạy để biết hai nguyên nhân phổ biến.

memory index:

  • --force: buộc lập chỉ mục lại toàn bộ.

memory search:

  • Đầu vào truy vấn: truyền [query] dạng vị trí hoặc --query <text>.
  • Nếu cung cấp cả hai, --query được ưu tiên.
  • Nếu không cung cấp cái nào, lệnh thoát với lỗi.
  • --agent <id>: giới hạn phạm vi vào một agent duy nhất (mặc định: agent mặc định).
  • --max-results <n>: giới hạn số lượng kết quả trả về.
  • --min-score <n>: lọc bỏ các kết quả khớp có điểm thấp.
  • --json: in kết quả JSON.

memory promote:

Xem trước và áp dụng các promotion bộ nhớ ngắn hạn.

bash
openclaw memory promote [--apply] [--limit <n>] [--include-promoted]
  • --apply -- ghi promotion vào MEMORY.md (mặc định: chỉ xem trước).
  • --limit <n> -- giới hạn số lượng ứng viên được hiển thị.
  • --include-promoted -- bao gồm các mục đã được promote trong những chu kỳ trước.

Toàn bộ tùy chọn:

  • Xếp hạng ứng viên ngắn hạn từ memory/YYYY-MM-DD.md bằng các tín hiệu promotion có trọng số (frequency, relevance, query diversity, recency, consolidation, conceptual richness).
  • Sử dụng tín hiệu ngắn hạn từ cả recall bộ nhớ và các lượt nhập hằng ngày, cộng thêm tín hiệu củng cố từ pha light/REM.
  • Khi Dreaming được bật, memory-core tự quản lý một tác vụ cron chạy một lượt quét đầy đủ (light -> REM -> deep) trong nền (không cần tự chạy openclaw cron add).
  • --agent <id>: giới hạn phạm vi vào một agent duy nhất (mặc định: agent mặc định).
  • --limit <n>: số ứng viên tối đa để trả về/áp dụng.
  • --min-score <n>: điểm promotion có trọng số tối thiểu.
  • --min-recall-count <n>: số lần recall tối thiểu cần có cho một ứng viên.
  • --min-unique-queries <n>: số lượng truy vấn riêng biệt tối thiểu cần có cho một ứng viên.
  • --apply: nối các ứng viên đã chọn vào MEMORY.md và đánh dấu chúng là đã promote.
  • --include-promoted: bao gồm các ứng viên đã được promote trong đầu ra.
  • --json: in đầu ra JSON.

memory promote-explain:

Giải thích một ứng viên promotion cụ thể và phân rã điểm của nó.

bash
openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]
  • <selector>: khóa ứng viên, đoạn đường dẫn, hoặc đoạn trích cần tra cứu.
  • --agent <id>: giới hạn phạm vi vào một agent duy nhất (mặc định: agent mặc định).
  • --include-promoted: bao gồm các ứng viên đã được promote.
  • --json: in đầu ra JSON.

memory rem-harness:

Xem trước các phản tư REM, sự thật ứng viên, và đầu ra promotion sâu mà không ghi gì.

bash
openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]
  • --agent <id>: giới hạn phạm vi vào một agent duy nhất (mặc định: agent mặc định).
  • --include-promoted: bao gồm các ứng viên sâu đã được promote.
  • --json: in đầu ra JSON.

Dreaming

Dreaming là hệ thống hợp nhất bộ nhớ chạy nền với ba pha phối hợp: light (sắp xếp/chuẩn bị tư liệu ngắn hạn), deep (promote các sự kiện bền vững vào MEMORY.md), và REM (phản tư và làm nổi bật các chủ đề).

  • Bật bằng plugins.entries.memory-core.config.dreaming.enabled: true.
  • Bật/tắt từ trò chuyện bằng /dreaming on|off (hoặc kiểm tra bằng /dreaming status). Người gọi qua kênh phải là owner để thay đổi cài đặt; client Gateway cần operator.admin. Trạng thái chỉ đọc và trợ giúp vẫn khả dụng cho những người gửi lệnh đã được ủy quyền.
  • Dreaming chạy theo một lịch quét được quản lý (dreaming.frequency) và thực thi các pha theo thứ tự: light, REM, deep.
  • Chỉ pha deep ghi bộ nhớ bền vững vào MEMORY.md.
  • Đầu ra pha và các mục nhật ký dễ đọc cho con người được ghi vào DREAMS.md (hoặc dreams.md hiện có), với báo cáo tùy chọn theo từng pha trong memory/dreaming/<phase>/YYYY-MM-DD.md.
  • Việc xếp hạng dùng các tín hiệu có trọng số: tần suất recall, độ liên quan khi truy xuất, độ đa dạng truy vấn, độ gần đây theo thời gian, hợp nhất xuyên ngày, và độ phong phú khái niệm được suy ra.
  • Promotion đọc lại ghi chú hằng ngày đang hoạt động trước khi ghi vào MEMORY.md, nên các đoạn trích ngắn hạn đã chỉnh sửa hoặc xóa sẽ không được promote từ ảnh chụp recall-store đã cũ.
  • Các lượt chạy theo lịch và memory promote thủ công dùng chung mặc định pha deep trừ khi bạn truyền các ghi đè ngưỡng qua CLI.
  • Các lượt chạy tự động mở rộng trên các workspace bộ nhớ đã cấu hình.

Lịch mặc định:

  • Nhịp quét: dreaming.frequency = 0 3 * * *
  • Ngưỡng deep: minScore=0.8, minRecallCount=3, minUniqueQueries=3, recencyHalfLifeDays=14, maxAgeDays=30

Ví dụ:

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

Ghi chú:

  • memory index --verbose in chi tiết theo từng pha (nhà cung cấp, model, nguồn, hoạt động batch).
  • memory status bao gồm mọi đường dẫn bổ sung đã cấu hình qua memorySearch.extraPaths.
  • Nếu các trường khóa API Active Memory từ xa đang hiệu lực được cấu hình là SecretRefs, lệnh sẽ phân giải các giá trị đó từ snapshot gateway đang hoạt động. Nếu gateway không khả dụng, lệnh thất bại nhanh.
  • Ghi chú về lệch phiên bản Gateway: đường dẫn lệnh này yêu cầu gateway hỗ trợ secrets.resolve; gateway cũ hơn trả về lỗi phương thức không xác định.
  • Điều chỉnh nhịp quét theo lịch bằng dreaming.frequency. Chính sách promotion deep ngoài ra là nội bộ, trừ dreaming.phases.deep.maxPromotedSnippetTokens, tùy chọn giới hạn độ dài đoạn trích được promote trong khi vẫn giữ hiển thị nguồn gốc. Dùng các cờ CLI trên memory promote khi bạn cần ghi đè ngưỡng thủ công một lần.
  • memory rem-harness --path <file-or-dir> --grounded xem trước What Happened, Reflections, và Possible Lasting Updates có căn cứ từ các ghi chú hằng ngày lịch sử mà không ghi gì.
  • memory rem-backfill --path <file-or-dir> ghi các mục nhật ký có căn cứ, có thể đảo ngược vào DREAMS.md để UI xem xét.
  • memory rem-backfill --path <file-or-dir> --stage-short-term cũng gieo các ứng viên bền vững có căn cứ vào kho promotion ngắn hạn đang hoạt động để pha deep bình thường có thể xếp hạng chúng.
  • memory rem-backfill --rollback xóa các mục nhật ký có căn cứ đã ghi trước đó, và memory rem-backfill --rollback-short-term xóa các ứng viên ngắn hạn có căn cứ đã được chuẩn bị trước đó.
  • Xem Dreaming để biết mô tả đầy đủ về các pha và tham chiếu cấu hình.

Liên quan

Was this useful?
On this page

On this page