ข้อมูลอ้างอิงการกำหนดค่า Memory

หน้านี้แสดงรายการตัวเลือกการกำหนดค่าทั้งหมดสำหรับการค้นหาหน่วยความจำของ OpenClaw สำหรับภาพรวมเชิงแนวคิด โปรดดู:

การตั้งค่าการค้นหาหน่วยความจำทั้งหมดอยู่ภายใต้ agents.defaults.memorySearch ใน openclaw.json เว้นแต่จะระบุไว้เป็นอย่างอื่น

การเลือกผู้ให้บริการ

เมื่อไม่ได้ตั้งค่า provider OpenClaw จะใช้ embeddings ของ OpenAI ตั้งค่า provider อย่างชัดเจนเพื่อใช้ Gemini, Voyage, Mistral, DeepInfra, Bedrock, GitHub Copilot, Ollama, โมเดล GGUF ภายในเครื่อง หรือ endpoint /v1/embeddings ที่เข้ากันได้กับ OpenAI การกำหนดค่าเดิมที่ยังระบุ provider: "auto" จะ resolve เป็น openai

เมื่อไม่ได้ตั้งค่า provider, มี provider: "auto" แบบเดิมอยู่ หรือ provider: "none" จงใจเลือกโหมด FTS-only การเรียกคืนหน่วยความจำยังสามารถ ใช้การจัดอันดับ FTS แบบ lexical ได้เมื่อ embeddings ไม่พร้อมใช้งาน

ผู้ให้บริการที่ไม่ใช่ภายในเครื่องซึ่งระบุอย่างชัดเจนจะล้มเหลวแบบปิด หากคุณตั้งค่า memorySearch.provider เป็น ผู้ให้บริการที่มีแบ็กเอนด์ระยะไกลแบบเจาะจง เช่น OpenAI, Gemini, Voyage, Mistral, Bedrock, GitHub Copilot, DeepInfra, Ollama, LM Studio หรือผู้ให้บริการกำหนดเอง ที่เข้ากันได้กับ OpenAI และผู้ให้บริการนั้นไม่พร้อมใช้งานขณะรัน memory_search จะส่งคืนผลลัพธ์ไม่พร้อมใช้งานแทนการใช้การเรียกคืนแบบ FTS-only อย่างเงียบ ๆ แก้ไข การกำหนดค่าผู้ให้บริการ/auth สลับไปใช้ผู้ให้บริการที่เข้าถึงได้ หรือตั้งค่า provider: "none" หากคุณต้องการการเรียกคืนแบบ FTS-only โดยเจตนา

ID ผู้ให้บริการกำหนดเอง

memorySearch.provider สามารถชี้ไปยังรายการ models.providers.<id> กำหนดเองสำหรับอะแดปเตอร์ผู้ให้บริการเฉพาะหน่วยความจำ เช่น ollama หรือสำหรับ API โมเดลที่เข้ากันได้กับ OpenAI เช่น openai-responses / openai-completions OpenClaw จะ resolve เจ้าของ api ของผู้ให้บริการนั้นสำหรับอะแดปเตอร์ embedding ขณะคง ID ผู้ให้บริการกำหนดเองไว้สำหรับ endpoint, auth และการจัดการ model-prefix วิธีนี้ช่วยให้การตั้งค่าแบบหลาย GPU หรือหลายโฮสต์จัดสรร embeddings หน่วยความจำให้กับ endpoint ภายในเครื่องแบบเจาะจงได้:

{  models: {    providers: {      "ollama-5080": {        api: "ollama",        baseUrl: "http://gpu-box.local:11435",        apiKey: "ollama-local",        models: [{ id: "qwen3-embedding:0.6b" }],      },    },  },  agents: {    defaults: {      memorySearch: {        provider: "ollama-5080",        model: "qwen3-embedding:0.6b",      },    },  },}

การ resolve คีย์ API

Embeddings ระยะไกลต้องใช้คีย์ API Bedrock ใช้ credential chain เริ่มต้นของ AWS SDK แทน (instance roles, SSO, access keys)

การกำหนดค่า endpoint ระยะไกล

ใช้ provider: "openai-compatible" สำหรับเซิร์ฟเวอร์ /v1/embeddings ทั่วไปที่เข้ากันได้กับ OpenAI ซึ่งไม่ควรสืบทอดข้อมูลรับรองแชต OpenAI ส่วนกลาง

{  agents: {    defaults: {      memorySearch: {        provider: "openai-compatible",        model: "text-embedding-3-small",        remote: {          baseUrl: "https://api.example.com/v1/",          apiKey: "YOUR_KEY",        },      },    },  },}

การกำหนดค่าเฉพาะผู้ให้บริการ

{  agents: {    defaults: {      memorySearch: {        provider: "openai-compatible",        remote: {          baseUrl: "https://embeddings.example/v1",          apiKey: "${EMBEDDINGS_API_KEY}",        },        model: "asymmetric-embedder",        queryInputType: "query",        documentInputType: "passage",      },    },  },}

{  agents: {    defaults: {      memorySearch: {        provider: "bedrock",        model: "amazon.titan-embed-text-v2:0",      },    },  },}

{  "Effect": "Allow",  "Action": "bedrock:InvokeModel",  "Resource": "*"}

arn:aws:bedrock:*::foundation-model/amazon.titan-embed-text-v2:0

openclaw memory status --deep --agent mainopenclaw memory index --force --agent main

หมดเวลาการฝังแบบอินไลน์

การกำหนดค่าการค้นหาแบบไฮบริด

ทั้งหมดอยู่ภายใต้ memorySearch.query.hybrid:

ตัวอย่างเต็ม

{  agents: {    defaults: {      memorySearch: {        query: {          hybrid: {            vectorWeight: 0.7,            textWeight: 0.3,            mmr: { enabled: true, lambda: 0.7 },            temporalDecay: { enabled: true, halfLifeDays: 30 },          },        },      },    },  },}

เส้นทางหน่วยความจำเพิ่มเติม

{  agents: {    defaults: {      memorySearch: {        extraPaths: ["../team-docs", "/srv/shared-notes"],      },    },  },}

เส้นทางอาจเป็นแบบสัมบูรณ์หรือสัมพันธ์กับเวิร์กสเปซก็ได้ ไดเรกทอรีจะถูกสแกนแบบเรียกซ้ำเพื่อหาไฟล์ .md การจัดการ symlink ขึ้นอยู่กับแบ็กเอนด์ที่ใช้งานอยู่: เอนจินในตัวจะไม่สนใจ symlink ขณะที่ QMD จะทำตามพฤติกรรมของสแกนเนอร์ QMD พื้นฐาน

สำหรับการค้นหาทรานสคริปต์ข้ามเอเจนต์ที่มีขอบเขตตามเอเจนต์ ให้ใช้ agents.list[].memorySearch.qmd.extraCollections แทน memory.qmd.paths คอลเลกชันเพิ่มเติมเหล่านั้นใช้รูปแบบ { path, name, pattern? } เดียวกัน แต่จะถูกผสานแยกตามแต่ละเอเจนต์ และสามารถคงชื่อที่แชร์ไว้อย่างชัดเจนเมื่อเส้นทางชี้ไปนอกเวิร์กสเปซปัจจุบัน หากเส้นทางที่ resolve แล้วเส้นทางเดียวกันปรากฏทั้งใน memory.qmd.paths และ memorySearch.qmd.extraCollections QMD จะเก็บรายการแรกไว้และข้ามรายการที่ซ้ำ

หน่วยความจำหลายโมดัล (Gemini)

ทำดัชนีรูปภาพและเสียงควบคู่กับ Markdown โดยใช้ Gemini Embedding 2:

รูปแบบที่รองรับ: .jpg, .jpeg, .png, .webp, .gif, .heic, .heif (รูปภาพ); .mp3, .wav, .ogg, .opus, .m4a, .aac, .flac (เสียง)

แคช Embedding

ป้องกันการ embedding ข้อความที่ไม่เปลี่ยนแปลงซ้ำระหว่างการทำดัชนีใหม่หรือการอัปเดตทรานสคริปต์

การทำดัชนีแบบแบตช์

พร้อมใช้งานสำหรับ openai, gemini และ voyage โดยทั่วไป แบตช์ของ OpenAI จะเร็วที่สุดและมีต้นทุนต่ำที่สุดสำหรับการเติมข้อมูลย้อนหลังขนาดใหญ่

remote.nonBatchConcurrency ควบคุมการเรียก embedding แบบอินไลน์ที่ใช้โดยผู้ให้บริการแบบโลคัล/โฮสต์เอง และผู้ให้บริการแบบโฮสต์เมื่อ API แบตช์ของผู้ให้บริการไม่ได้ทำงานอยู่ Ollama มีค่าเริ่มต้นเป็น 1 สำหรับการทำดัชนีแบบไม่ใช้แบตช์ เพื่อหลีกเลี่ยงการใช้งานโฮสต์โลคัลขนาดเล็กมากเกินไป ตั้งค่าให้สูงขึ้นบนเครื่องที่ใหญ่กว่า

ค่านี้แยกจาก sync.embeddingBatchTimeoutSeconds ซึ่งควบคุมการหมดเวลาสำหรับการเรียก embedding แบบอินไลน์

การค้นหาหน่วยความจำเซสชัน (ทดลอง)

ทำดัชนีทรานสคริปต์ของเซสชันและแสดงผ่าน memory_search:

ผลลัพธ์จากทรานสคริปต์ของเซสชันยังเป็นไปตาม tools.sessions.visibility ด้วย ค่าเริ่มต้นของการมองเห็นแบบ tree จะเปิดเผยเฉพาะเซสชันปัจจุบันและเซสชันที่เซสชันนั้นสร้างขึ้น หากต้องการ เรียกคืนเซสชันของเอเจนต์เดียวกันที่ Gateway ส่งงาน แต่ไม่เกี่ยวข้องกัน จากเซสชันอื่น เช่น DM ให้ตั้งใจขยายการมองเห็นเป็น agent (หรือ all เฉพาะเมื่อจำเป็นต้องเรียกคืนข้ามเอเจนต์ด้วย และนโยบายเอเจนต์ถึงเอเจนต์อนุญาต)

ตัวอย่างด้านล่างวางการตั้งค่าเหล่านี้ไว้ใต้ agents.defaults คุณยังสามารถ ใช้การตั้งค่า memorySearch ที่เทียบเท่ากันในการแทนที่รายเอเจนต์ได้ เมื่อมีเพียง เอเจนต์เดียวที่ควรจัดทำดัชนีและค้นหาทรานสคริปต์ของเซสชัน

สำหรับการเรียกคืนจาก Gateway ไปยัง DM ในเอเจนต์เดียวกัน:

{  agents: {    defaults: {      memorySearch: {        experimental: { sessionMemory: true },        sources: ["memory", "sessions"],      },    },  },  tools: {    sessions: { visibility: "agent" },  },}

{  agents: {    defaults: {      memorySearch: {        experimental: { sessionMemory: true },        sources: ["memory", "sessions"],      },    },  },  memory: {    backend: "qmd",    qmd: {      sessions: { enabled: true },    },  },  tools: {    sessions: { visibility: "agent" },  },}

เมื่อใช้ QMD, agents.defaults.memorySearch.experimental.sessionMemory และ sources: ["sessions"] จะไม่ส่งออกทรานสคริปต์เข้าไปยัง QMD ด้วยตัวเอง ให้ตั้งค่า memory.qmd.sessions.enabled: true ด้วย

การเร่งความเร็วเวกเตอร์ SQLite (sqlite-vec)

เมื่อ sqlite-vec ไม่พร้อมใช้งาน OpenClaw จะถอยกลับไปใช้ cosine similarity ภายในโปรเซสโดยอัตโนมัติ

พื้นที่จัดเก็บดัชนี

ดัชนีหน่วยความจำในตัวอยู่ในฐานข้อมูล OpenClaw SQLite ของแต่ละเอเจนต์ที่ agents/<agentId>/agent/openclaw-agent.sqlite

การกำหนดค่าแบ็กเอนด์ QMD

ตั้งค่า memory.backend = "qmd" เพื่อเปิดใช้งาน การตั้งค่า QMD ทั้งหมดอยู่ใต้ memory.qmd:

searchMode: "search" เป็นแบบ lexical/BM25 เท่านั้น OpenClaw จะไม่เรียกโพรบความพร้อมของเวกเตอร์เชิงความหมายหรือการดูแลรักษา embedding ของ QMD สำหรับโหมดนั้น รวมถึงระหว่าง memory status --deep; vsearch และ query ยังคงต้องใช้ความพร้อมของเวกเตอร์ QMD และ embeddings

rerank: false เปลี่ยนเฉพาะโหมด query ของ QMD และต้องใช้ QMD 2.1 หรือใหม่กว่า ในโหมด CLI โดยตรง OpenClaw จะส่ง --no-rerank; ในโหมด MCP ที่ใช้ mcporter หนุนหลัง จะส่ง rerank: false ไปยังเครื่องมือคิวรีแบบรวมของ QMD ปล่อยไว้โดยไม่ตั้งค่าเพื่อใช้พฤติกรรมการจัดอันดับซ้ำของคิวรีตามค่าเริ่มต้นของ QMD

OpenClaw เลือกใช้รูปแบบ collection และคิวรี MCP ปัจจุบันของ QMD เป็นหลัก แต่ยังคงให้ QMD รุ่นเก่าทำงานได้โดยลองใช้แฟล็กรูปแบบ collection ที่เข้ากันได้และชื่อเครื่องมือ MCP แบบเก่าเมื่อจำเป็น เมื่อ QMD ประกาศว่ารองรับตัวกรอง collection หลายรายการ จะค้นหา collection จากแหล่งเดียวกันด้วยโปรเซส QMD เดียว; บิลด์ QMD รุ่นเก่าจะคงพาธความเข้ากันได้แบบต่อ collection ไว้ แหล่งเดียวกันหมายถึง collection หน่วยความจำถาวรถูกจัดกลุ่มรวมกัน ขณะที่ collection ทรานสคริปต์ของเซสชันยังคงเป็นอีกกลุ่มหนึ่ง เพื่อให้การกระจายแหล่งที่มายังมีอินพุตทั้งสองประเภท

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

เมื่อเปิดใช้การเริ่มต้น QMD ตอน Gateway เริ่มทำงาน OpenClaw จะเริ่ม QMD เฉพาะสำหรับ agent ที่เข้าเกณฑ์เท่านั้น หาก update.onBoot เป็น true และไม่ได้กำหนดค่าการดูแลรักษา interval/embed การเริ่มต้นจะใช้ผู้จัดการแบบทำครั้งเดียวสำหรับการรีเฟรชตอนบูตแล้วปิด หากกำหนดค่า update หรือ embed interval ไว้ การเริ่มต้นจะเปิดผู้จัดการ QMD ที่ทำงานระยะยาวเพื่อให้เป็นเจ้าของ watcher และตัวจับเวลา interval; update.onBoot: false จะข้ามเฉพาะการรีเฟรชทันทีตอนบูตเท่านั้น

ตัวอย่าง QMD แบบเต็ม

{  memory: {    backend: "qmd",    citations: "auto",    qmd: {      includeDefaultMemory: true,      update: { interval: "5m", debounceMs: 15000 },      limits: { maxResults: 6, timeoutMs: 4000 },      scope: {        default: "deny",        rules: [{ action: "allow", match: { chatType: "direct" } }],      },      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],    },  },}

Dreaming

กำหนดค่า Dreaming ภายใต้ plugins.entries.memory-core.config.dreaming ไม่ใช่ภายใต้ agents.defaults.memorySearch

Dreaming ทำงานเป็นการกวาดตามกำหนดเวลาหนึ่งครั้ง และใช้เฟส light/deep/REM ภายในเป็นรายละเอียดการนำไปใช้

สำหรับพฤติกรรมเชิงแนวคิดและคำสั่ง slash โปรดดู Dreaming

การตั้งค่าผู้ใช้

ตัวอย่าง

{  plugins: {    entries: {      "memory-core": {        subagent: {          allowModelOverride: true,          allowedModels: ["anthropic/claude-sonnet-4-6"],        },        config: {          dreaming: {            enabled: true,            frequency: "0 3 * * *",            model: "anthropic/claude-sonnet-4-6",          },        },      },    },  },}

ที่เกี่ยวข้อง

• ข้อมูลอ้างอิงการกำหนดค่า
• ภาพรวมหน่วยความจำ
• การค้นหาหน่วยความจำ