---
read_when:
    - Bạn muốn lập chỉ mục hoặc tìm kiếm bộ nhớ ngữ nghĩa
    - Bạn đang gỡ lỗi tính khả dụng của bộ nhớ hoặc quá trình lập chỉ mục
    - Bạn muốn đưa bộ nhớ ngắn hạn đã được truy hồi vào `MEMORY.md`
summary: Tham chiếu CLI cho `openclaw memory` (status/index/search/promote/promote-explain/rem-harness)
title: Bộ nhớ
x-i18n:
    generated_at: "2026-05-06T17:53:26Z"
    model: gpt-5.5
    provider: openai
    source_hash: 7137f8a9529095204699de5fee7a0baf5d5a377792dc93b4059145d0eefab737
    source_path: cli/memory.md
    workflow: 16
---

# `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:

- Khái niệm bộ nhớ: [Bộ nhớ](/vi/concepts/memory)
- Wiki bộ nhớ: [Wiki bộ nhớ](/vi/plugins/memory-wiki)
- CLI wiki: [wiki](/vi/cli/wiki)
- Plugins: [Plugins](/vi/tools/plugin)

## Ví dụ

```bash
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](/vi/concepts/dreaming#dreaming-never-runs-status-shows-blocked) để 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.

```bash
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 đó.

```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 để 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ì.

```bash
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ụ:

```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, 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](/vi/concepts/dreaming) để biết mô tả đầy đủ về các pha và tham chiếu cấu hình.

## Liên quan

- [Tham chiếu CLI](/vi/cli)
- [Tổng quan bộ nhớ](/vi/concepts/memory)