English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

Bộ nhớ

openclaw memory

Quản lý việc lập chỉ mục và tìm kiếm bộ nhớ ngữ nghĩa. Được cung cấp bởi Plugin Active Memory (mặc định: memory-core; đặt plugins.slots.memory = "none" để tắt).

Liên quan:

Ví dụ

openclaw memory status
openclaw memory status --deep
openclaw memory status --fix
openclaw memory index --force
openclaw memory search "meeting notes"
openclaw memory search --query "deployment" --max-results 20
openclaw memory promote --limit 10 --min-score 0.75
openclaw memory promote --apply
openclaw memory promote --json --min-recall-count 0 --min-unique-queries 0
openclaw memory promote-explain "router vlan"
openclaw memory promote-explain "router vlan" --json
openclaw memory rem-harness
openclaw memory rem-harness --json
openclaw memory status --json
openclaw memory status --deep --index
openclaw memory status --deep --index --verbose
openclaw memory status --agent main
openclaw 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 tác nhân duy nhất. Nếu không có tùy chọn này, các lệnh này chạy cho từng tác nhân đã cấu hình; nếu không có danh sách tác nhân nào được cấu hình, chúng sẽ dùng tác nhân mặc định.
  • --verbose: xuất nhật ký chi tiết trong quá trình 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 nhúng, 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 công việc nhúng trực tiếp hoặc phát hiện 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 từ vựng searchMode: "search" bỏ qua thăm dò vector ngữ nghĩa và bảo trì nhúng ngay cả khi có --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 truy hồi cũ và chuẩn hóa siêu dữ liệu thăng hạng.
  • --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 chạy cho tác nhân 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] theo 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 tùy chọn nào, lệnh thoát với lỗi.
  • --agent <id>: giới hạn phạm vi vào một tác nhân duy nhất (mặc định: tác nhân mặc định).
  • --max-results <n>: giới hạn số lượng kết quả được 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 thăng hạng bộ nhớ ngắn hạn.

openclaw memory promote [--apply] [--limit <n>] [--include-promoted]
  • --apply -- ghi các thăng hạng 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 thăng hạng trong các chu kỳ trước.

Tùy chọn đầy đủ:

  • Xếp hạng các ứng viên ngắn hạn từ memory/YYYY-MM-DD.md bằng các tín hiệu thăng hạng 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ả các lần truy hồi bộ nhớ và các lượt nạp dữ liệu hằng ngày, cùng với tín hiệu củng cố pha nhẹ/REM.
  • Khi Dreaming được bật, memory-core tự động 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 openclaw cron add thủ công).
  • --agent <id>: giới hạn phạm vi vào một tác nhân duy nhất (mặc định: tác nhân mặc định).
  • --limit <n>: số ứng viên tối đa để trả về/áp dụng.
  • --min-score <n>: điểm thăng hạng có trọng số tối thiểu.
  • --min-recall-count <n>: số lần truy hồi tối thiểu bắt buộ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 bắt buộ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à đã thăng hạng.
  • --include-promoted: bao gồm các ứng viên đã được thăng hạng trong đầu ra.
  • --json: in đầu ra JSON.

memory promote-explain:

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

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 để tra cứu.
  • --agent <id>: giới hạn phạm vi vào một tác nhân duy nhất (mặc định: tác nhân mặc định).
  • --include-promoted: bao gồm các ứng viên đã được thăng hạng.
  • --json: in đầu ra JSON.

memory rem-harness:

Xem trước các phản tư REM, chân lý ứng viên, và đầu ra thăng hạng sâu mà không ghi gì.

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

Dreaming

Dreaming là hệ thống củng cố bộ nhớ nền với ba pha phối hợp: nhẹ (sắp xếp/dàn dựng tài liệu ngắn hạn), sâu (thăng hạng 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 chủ đề).

  • Bật bằng plugins.entries.memory-core.config.dreaming.enabled: true.
  • Bật/tắt từ cuộc trò chuyện bằng /dreaming on|off (hoặc kiểm tra bằng /dreaming status).
  • 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ự: nhẹ, REM, sâu.
  • Chỉ pha sâu 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 các 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 sử dụng các tín hiệu có trọng số: tần suất truy hồi, mức liên quan khi truy xuất, độ đa dạng truy vấn, độ gần đây theo thời gian, củng cố qua nhiều ngày, và độ phong phú khái niệm được suy ra.
  • Việc thăng hạng đọc lại ghi chú hằng ngày trực tiếp 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 thăng hạng từ ảnh chụp kho truy hồi cũ.
  • Các lần chạy memory promote theo lịch và thủ công dùng chung mặc định pha sâu, trừ khi bạn truyền ghi đè ngưỡng qua CLI.
  • Các lần chạy tự động phân nhánh trên các không gian làm việc bộ nhớ đã cấu hình.

Lịch mặc định:

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

Ví dụ:

{
  "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, mô hình, nguồn, hoạt động theo lô).
  • memory status bao gồm mọi đường dẫn bổ sung được cấu hình qua memorySearch.extraPaths.
  • Nếu các trường khóa API từ xa của Active Memory đang thực sự hoạt động được cấu hình dưới dạng SecretRefs, lệnh sẽ phân giải các giá trị đó từ ảnh chụp Gateway đang hoạt động. Nếu Gateway không khả dụng, lệnh sẽ thất bại nhanh.
  • Lưu ý về lệch phiên bản Gateway: đường dẫn lệnh này yêu cầu Gateway hỗ trợ secrets.resolve; các 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 thăng hạng sâu ngoài ra là nội bộ; dùng các cờ CLI trên memory promote khi bạn cần ghi đè 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 để xem lại trong UI.
  • 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 thăng hạng ngắn hạn trực tiếp để pha sâu 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ứ đã dàn dựng trước đó.
  • Xem Dreaming để biết mô tả đầy đủ về các pha và tham chiếu cấu hình.

Liên quan