Công cụ bộ nhớ QMD

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Những gì nó bổ sung so với công cụ tích hợp sẵn

• Sắp xếp lại thứ hạng và mở rộng truy vấn để cải thiện khả năng truy hồi.
• Lập chỉ mục các thư mục bổ sung — tài liệu dự án, ghi chú nhóm, bất kỳ thứ gì trên đĩa.
• Lập chỉ mục bản ghi phiên — truy hồi các cuộc trò chuyện trước đó.
• Hoàn toàn cục bộ — chạy với gói runtime node-llama-cpp tùy chọn và tự động tải xuống các mô hình GGUF.
• Tự động dự phòng — nếu QMD không khả dụng, OpenClaw tự động chuyển về công cụ tích hợp sẵn một cách liền mạch.

​

Bắt đầu

​

Điều kiện tiên quyết

• Cài đặt QMD: npm install -g @tobilu/qmd hoặc bun install -g @tobilu/qmd
• Bản dựng SQLite cho phép tiện ích mở rộng (brew install sqlite trên macOS).
• QMD phải nằm trong PATH của gateway.
• macOS và Linux hoạt động ngay không cần cấu hình thêm. Windows được hỗ trợ tốt nhất qua WSL2.

​

Bật

{
  memory: {
    backend: "qmd",
  },
}

​

Cách thành phần đi kèm hoạt động

• OpenClaw tạo các collection từ các tệp bộ nhớ không gian làm việc của bạn và mọi memory.qmd.paths đã cấu hình, sau đó chạy qmd update khi trình quản lý QMD được mở và định kỳ sau đó (mặc định mỗi 5 phút). Các lần làm mới này chạy qua các tiến trình con QMD, không phải một lượt quét hệ thống tệp trong tiến trình. Các chế độ ngữ nghĩa cũng chạy qmd embed.
• Collection không gian làm việc mặc định theo dõi MEMORY.md cùng cây memory/. memory.md viết thường không được lập chỉ mục như một tệp bộ nhớ gốc.
• Trình quét riêng của QMD bỏ qua các đường dẫn ẩn và các thư mục phụ thuộc/bản dựng phổ biến như .git, .cache, node_modules, vendor, dist và build. Theo mặc định, khởi động Gateway không khởi tạo QMD, nên khởi động nguội tránh nhập runtime bộ nhớ hoặc tạo watcher chạy dài trước khi bộ nhớ được dùng lần đầu.
• Nếu bạn vẫn muốn làm mới khi Gateway khởi động, hãy đặt memory.qmd.update.startup thành idle hoặc immediate. Làm mới lúc khởi động dạng opt-in dùng đường dẫn tiến trình con QMD một lần thay vì tạo watcher trong tiến trình chạy dài đầy đủ.
• Tìm kiếm dùng searchMode đã cấu hình (mặc định: search; cũng hỗ trợ vsearch và query). search chỉ dùng BM25, vì vậy OpenClaw bỏ qua các phép thăm dò mức sẵn sàng của vector ngữ nghĩa và bảo trì embedding trong chế độ đó. Nếu một chế độ thất bại, OpenClaw thử lại bằng qmd query.
• Với các bản phát hành QMD quảng bá bộ lọc đa collection, OpenClaw nhóm các collection cùng nguồn vào một lệnh gọi tìm kiếm QMD. Các bản phát hành QMD cũ hơn giữ cơ chế dự phòng tương thích theo từng collection.
• Nếu QMD thất bại hoàn toàn, OpenClaw chuyển về công cụ SQLite tích hợp sẵn. Các lần thử lặp lại trong lượt chat sẽ tạm lùi ngắn sau khi mở thất bại để một tệp nhị phân bị thiếu hoặc phụ thuộc sidecar bị hỏng không tạo ra bão thử lại; openclaw memory status và các phép thăm dò CLI một lần vẫn kiểm tra lại QMD trực tiếp.

​

Hiệu năng tìm kiếm và khả năng tương thích

qmd search "router notes" --json -n 10 -c memory-root-main -c memory-dir-main

qmd --help | grep -i collection

​

Ghi đè mô hình

export QMD_EMBED_MODEL="hf:Qwen/Qwen3-Embedding-0.6B-GGUF/Qwen3-Embedding-0.6B-Q8_0.gguf"
export QMD_RERANK_MODEL="/absolute/path/to/reranker.gguf"
export QMD_GENERATE_MODEL="/absolute/path/to/generator.gguf"

​

Lập chỉ mục đường dẫn bổ sung

{
  memory: {
    backend: "qmd",
    qmd: {
      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],
    },
  },
}

​

Lập chỉ mục bản ghi phiên

{
  memory: {
    backend: "qmd",
    qmd: {
      sessions: { enabled: true },
    },
  },
}

​

Phạm vi tìm kiếm

{
  memory: {
    qmd: {
      scope: {
        default: "deny",
        rules: [{ action: "allow", match: { chatType: "direct" } }],
      },
    },
  },
}

​

Trích dẫn

​

Khi nào nên dùng

• Sắp xếp lại thứ hạng để có kết quả chất lượng cao hơn.
• Tìm kiếm tài liệu dự án hoặc ghi chú ngoài không gian làm việc.
• Truy hồi các cuộc trò chuyện phiên trước đây.
• Tìm kiếm hoàn toàn cục bộ mà không cần khóa API.

​

Khắc phục sự cố

{
  memory: {
    backend: "qmd",
    qmd: {
      command: "/absolute/path/to/qmd",
    },
  },
}

​

Cấu hình

​

Liên quan

• Tổng quan bộ nhớ
• Công cụ bộ nhớ tích hợp sẵn
• Bộ nhớ Honcho