# openclaw memory

จัดการการทำดัชนีและการค้นหาหน่วยความจำเชิงความหมาย จัดเตรียมโดย Active Memory Plugin (ค่าเริ่มต้น: memory-core; ตั้งค่า plugins.slots.memory = "none" เพื่อปิดใช้งาน)

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

• แนวคิดหน่วยความจำ: หน่วยความจำ
• วิกิหน่วยความจำ: วิกิหน่วยความจำ
• CLI วิกิ: wiki
• Plugins: Plugins

# ตัวอย่าง

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

# ตัวเลือก

memory status และ memory index:

• --agent <id>: จำกัดขอบเขตไว้ที่เอเจนต์เดียว หากไม่มีตัวเลือกนี้ คำสั่งเหล่านี้จะทำงานกับเอเจนต์ที่กำหนดค่าไว้แต่ละตัว หากไม่ได้กำหนดค่ารายการเอเจนต์ไว้ จะย้อนกลับไปใช้เอเจนต์เริ่มต้น
• --verbose: แสดงบันทึกโดยละเอียดระหว่างการตรวจสอบและการทำดัชนี

memory status:

• --deep: ตรวจสอบความพร้อมของที่เก็บเวกเตอร์ภายในเครื่อง ความพร้อมของผู้ให้บริการ embedding และความพร้อมของการค้นหาเวกเตอร์เชิงความหมาย memory status แบบปกติจะยังคงรวดเร็วและไม่เรียกใช้งาน embedding สดหรือการค้นหาผู้ให้บริการ สถานะที่เก็บเวกเตอร์หรือเวกเตอร์เชิงความหมายที่ไม่ทราบหมายความว่ายังไม่ได้ตรวจสอบในคำสั่งนั้น QMD lexical searchMode: "search" จะข้ามการตรวจสอบเวกเตอร์เชิงความหมายและการบำรุงรักษา embedding แม้ใช้ --deep
• --index: เรียกทำดัชนีใหม่หากที่เก็บอยู่ในสถานะ dirty (โดยนัยว่าใช้ --deep)
• --fix: ซ่อมแซมล็อกการ recall ที่ค้างอยู่และปรับข้อมูลเมตาของการ promote ให้เป็นปกติ
• --json: พิมพ์เอาต์พุต JSON

หาก memory status แสดง Dreaming status: blocked หมายความว่า Cron สำหรับ Dreaming ที่จัดการไว้เปิดใช้งานอยู่ แต่ Heartbeat ที่ขับเคลื่อนไม่ได้ทำงานสำหรับเอเจนต์เริ่มต้น ดู Dreaming ไม่เคยทำงาน สำหรับสาเหตุที่พบบ่อยสองกรณี

memory index:

• --force: บังคับทำดัชนีใหม่ทั้งหมด

memory search:

• อินพุตคิวรี: ส่งได้ทั้ง [query] แบบตำแหน่งหรือ --query <text>
• หากระบุทั้งสองแบบ --query จะมีผลเหนือกว่า
• หากไม่ได้ระบุทั้งสองแบบ คำสั่งจะออกพร้อมข้อผิดพลาด
• --agent <id>: จำกัดขอบเขตไว้ที่เอเจนต์เดียว (ค่าเริ่มต้น: เอเจนต์เริ่มต้น)
• --max-results <n>: จำกัดจำนวนผลลัพธ์ที่ส่งกลับ
• --min-score <n>: กรองรายการที่มีคะแนนต่ำออก
• --json: พิมพ์ผลลัพธ์ JSON

memory promote:

ดูตัวอย่างและใช้การ promote หน่วยความจำระยะสั้น

openclaw memory promote [--apply] [--limit <n>] [--include-promoted]

• --apply -- เขียนการ promote ไปยัง MEMORY.md (ค่าเริ่มต้น: ดูตัวอย่างเท่านั้น)
• --limit <n> -- จำกัดจำนวน candidate ที่แสดง
• --include-promoted -- รวมรายการที่ถูก promote แล้วในรอบก่อนหน้า

ตัวเลือกทั้งหมด:

• จัดอันดับ candidate ระยะสั้นจาก memory/YYYY-MM-DD.md โดยใช้สัญญาณการ promote แบบถ่วงน้ำหนัก (frequency, relevance, query diversity, recency, consolidation, conceptual richness)
• ใช้สัญญาณระยะสั้นจากทั้งการ recall หน่วยความจำและรอบการ ingest รายวัน รวมถึงสัญญาณเสริมแรงจากเฟส light/REM
• เมื่อเปิดใช้งาน Dreaming แล้ว memory-core จะจัดการ Cron job หนึ่งรายการโดยอัตโนมัติ ซึ่งเรียก sweep แบบเต็ม (light -> REM -> deep) ในเบื้องหลัง (ไม่ต้องใช้ openclaw cron add ด้วยตนเอง)
• --agent <id>: จำกัดขอบเขตไว้ที่เอเจนต์เดียว (ค่าเริ่มต้น: เอเจนต์เริ่มต้น)
• --limit <n>: จำนวน candidate สูงสุดที่จะส่งกลับ/นำไปใช้
• --min-score <n>: คะแนนการ promote แบบถ่วงน้ำหนักขั้นต่ำ
• --min-recall-count <n>: จำนวนการ recall ขั้นต่ำที่จำเป็นสำหรับ candidate
• --min-unique-queries <n>: จำนวนคิวรีที่แตกต่างกันขั้นต่ำที่จำเป็นสำหรับ candidate
• --apply: ผนวก candidate ที่เลือกลงใน MEMORY.md และทำเครื่องหมายว่า promoted
• --include-promoted: รวม candidate ที่ถูก promote แล้วในเอาต์พุต
• --json: พิมพ์เอาต์พุต JSON

memory promote-explain:

อธิบาย candidate การ promote ที่ระบุและรายละเอียดคะแนน

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]

• <selector>: คีย์ candidate, ส่วนย่อยของพาธ หรือส่วนย่อยของ snippet ที่จะค้นหา
• --agent <id>: จำกัดขอบเขตไว้ที่เอเจนต์เดียว (ค่าเริ่มต้น: เอเจนต์เริ่มต้น)
• --include-promoted: รวม candidate ที่ถูก promote แล้ว
• --json: พิมพ์เอาต์พุต JSON

memory rem-harness:

ดูตัวอย่างการสะท้อนของ REM, ความจริง candidate และเอาต์พุตการ promote ระดับลึกโดยไม่เขียนอะไร

openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]

• --agent <id>: จำกัดขอบเขตไว้ที่เอเจนต์เดียว (ค่าเริ่มต้น: เอเจนต์เริ่มต้น)
• --include-promoted: รวม deep candidate ที่ถูก promote แล้ว
• --json: พิมพ์เอาต์พุต JSON

# Dreaming

Dreaming คือระบบรวบรวมและกลั่นกรองหน่วยความจำเบื้องหลังที่มีสามเฟสซึ่งทำงานร่วมกัน: light (จัดเรียง/เตรียมข้อมูลระยะสั้น), deep (promote ข้อเท็จจริงที่คงทนไปยัง MEMORY.md) และ REM (สะท้อนและยกธีมขึ้นมาให้เห็น)

• เปิดใช้งานด้วย plugins.entries.memory-core.config.dreaming.enabled: true
• สลับจากแชตด้วย /dreaming on|off (หรือตรวจสอบด้วย /dreaming status)
• Dreaming ทำงานตามกำหนดการ sweep ที่จัดการไว้หนึ่งรายการ (dreaming.frequency) และดำเนินเฟสตามลำดับ: light, REM, deep
• เฉพาะเฟส deep เท่านั้นที่เขียนหน่วยความจำถาวรไปยัง MEMORY.md
• เอาต์พุตเฟสและรายการไดอารีที่มนุษย์อ่านได้จะถูกเขียนไปยัง DREAMS.md (หรือ dreams.md ที่มีอยู่) พร้อมรายงานแยกตามเฟสแบบไม่บังคับใน memory/dreaming/<phase>/YYYY-MM-DD.md
• การจัดอันดับใช้สัญญาณแบบถ่วงน้ำหนัก: ความถี่การ recall, ความเกี่ยวข้องของการดึงข้อมูล, ความหลากหลายของคิวรี, ความใหม่ตามเวลา, การรวบรวมข้ามวัน และความสมบูรณ์ของแนวคิดที่อนุมานได้
• การ promote จะอ่านโน้ตรายวันสดซ้ำก่อนเขียนไปยัง MEMORY.md ดังนั้น snippet ระยะสั้นที่ถูกแก้ไขหรือลบจะไม่ถูก promote จาก snapshot ของ recall-store ที่ล้าสมัย
• การเรียก memory promote ทั้งแบบตามกำหนดการและแบบด้วยตนเองใช้ค่าเริ่มต้นของเฟส deep เดียวกัน เว้นแต่คุณจะส่งค่า override ของ threshold ผ่าน CLI
• การเรียกอัตโนมัติจะกระจายงานไปยัง workspace หน่วยความจำที่กำหนดค่าไว้

การกำหนดเวลาเริ่มต้น:

• รอบการ sweep: dreaming.frequency = 0 3 * * *
• Threshold ของ Deep: minScore=0.8, minRecallCount=3, minUniqueQueries=3, recencyHalfLifeDays=14, maxAgeDays=30

ตัวอย่าง:

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true
          }
        }
      }
    }
  }
}

หมายเหตุ:

• memory index --verbose พิมพ์รายละเอียดแยกตามเฟส (ผู้ให้บริการ, โมเดล, แหล่งที่มา, กิจกรรม batch)
• memory status รวมพาธเพิ่มเติมที่กำหนดค่าผ่าน memorySearch.extraPaths
• หากฟิลด์คีย์ API ระยะไกลของ Active Memory ที่มีผลใช้งานจริงถูกกำหนดค่าเป็น SecretRefs คำสั่งจะ resolve ค่าเหล่านั้นจาก snapshot ของ Gateway ที่ใช้งานอยู่ หาก Gateway ไม่พร้อมใช้งาน คำสั่งจะล้มเหลวอย่างรวดเร็ว
• หมายเหตุเรื่องเวอร์ชัน Gateway ไม่ตรงกัน: เส้นทางคำสั่งนี้ต้องใช้ Gateway ที่รองรับ secrets.resolve; Gateway รุ่นเก่าจะส่งคืนข้อผิดพลาด unknown-method
• ปรับรอบ sweep ตามกำหนดการด้วย dreaming.frequency นโยบายการ promote ระดับ deep นอกเหนือจากนี้เป็นภายในระบบ ให้ใช้ flag ของ CLI บน memory promote เมื่อต้องการ override แบบทำด้วยตนเองเฉพาะครั้ง
• memory rem-harness --path <file-or-dir> --grounded ดูตัวอย่าง What Happened, Reflections และ Possible Lasting Updates ที่อิงหลักฐานจากโน้ตรายวันในอดีตโดยไม่เขียนอะไร
• memory rem-backfill --path <file-or-dir> เขียนรายการไดอารีที่อิงหลักฐานและย้อนกลับได้ลงใน DREAMS.md เพื่อรีวิวใน UI
• memory rem-backfill --path <file-or-dir> --stage-short-term จะ seed candidate ถาวรที่อิงหลักฐานลงในที่เก็บการ promote ระยะสั้นสดด้วย เพื่อให้เฟส deep ปกติสามารถจัดอันดับได้
• memory rem-backfill --rollback ลบรายการไดอารีที่อิงหลักฐานซึ่งเคยเขียนไว้ก่อนหน้า และ memory rem-backfill --rollback-short-term ลบ candidate ระยะสั้นที่อิงหลักฐานซึ่งเคย stage ไว้ก่อนหน้า
• ดู Dreaming สำหรับคำอธิบายเฟสทั้งหมดและข้อมูลอ้างอิงการกำหนดค่า

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

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