​

Mesin Memori QMD

​

Apa yang ditambahkan dibandingkan bawaan

• Reranking dan ekspansi kueri untuk recall yang lebih baik.
• Mengindeks direktori tambahan — dokumentasi proyek, catatan tim, apa pun di disk.
• Mengindeks transkrip sesi — mengingat percakapan sebelumnya.
• Sepenuhnya lokal — berjalan melalui Bun + node-llama-cpp, otomatis mengunduh model GGUF.
• Fallback otomatis — jika QMD tidak tersedia, OpenClaw kembali ke mesin bawaan tanpa hambatan.

​

Memulai

​

Prasyarat

• Instal QMD: npm install -g @tobilu/qmd atau bun install -g @tobilu/qmd
• Build SQLite yang mengizinkan ekstensi (brew install sqlite di macOS).
• QMD harus ada di PATH milik Gateway.
• macOS dan Linux berfungsi langsung. Windows paling didukung melalui WSL2.

​

Aktifkan

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

​

Cara kerja sidecar

• OpenClaw membuat koleksi dari file memori workspace Anda dan semua memory.qmd.paths yang dikonfigurasi, lalu menjalankan qmd update + qmd embed saat boot dan secara berkala (default setiap 5 menit).
• Koleksi workspace default melacak MEMORY.md plus tree memory/. memory.md huruf kecil tetap menjadi fallback bootstrap, bukan koleksi QMD terpisah.
• Refresh saat boot berjalan di latar belakang agar startup chat tidak terhambat.
• Pencarian menggunakan searchMode yang dikonfigurasi (default: search; juga mendukung vsearch dan query). Jika suatu mode gagal, OpenClaw mencoba lagi dengan qmd query.
• Jika QMD gagal sepenuhnya, OpenClaw kembali ke mesin SQLite bawaan.

​

Override model

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"

​

Mengindeks jalur tambahan

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

​

Mengindeks transkrip sesi

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

​

Cakupan pencarian

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

​

Sitasi

​

Kapan digunakan

• Reranking untuk hasil berkualitas lebih tinggi.
• Mencari dokumentasi proyek atau catatan di luar workspace.
• Mengingat percakapan sesi sebelumnya.
• Pencarian sepenuhnya lokal tanpa API key.

​

Pemecahan masalah

​

Konfigurasi