วิกิหน่วยความจำ

memory-wiki เป็น Plugin ที่มาพร้อมระบบ ซึ่งคอมไพล์ความรู้ที่คงทนให้เป็น วิกิที่นำทางได้ ได้แก่ หน้าที่สร้างแบบกำหนดแน่นอน ข้อกล่าวอ้างแบบมีโครงสร้างพร้อมหลักฐาน ที่มา แดชบอร์ด และข้อมูลสรุปที่เครื่องอ่านได้

Plugin นี้ไม่ได้มาแทนที่ Plugin Active Memory การเรียกคืน การเลื่อนระดับ การทำดัชนี และ Dreaming ยังคงเป็นหน้าที่ของแบ็กเอนด์หน่วยความจำที่กำหนดค่าไว้ (memory-core, QMD, Honcho เป็นต้น) memory-wiki ทำงานควบคู่กันและคอมไพล์ ความรู้เป็นชั้นวิกิที่ได้รับการดูแลรักษา

กฎสำหรับการใช้งานจริง:

• ใช้ memory_search เพื่อเรียกคืนข้อมูลแบบกว้างหนึ่งรอบจากคลังข้อมูลทั้งหมดที่กำหนดค่าไว้
• ใช้ wiki_search / wiki_get เมื่อต้องการการจัดอันดับเฉพาะวิกิ ข้อมูลที่มา หรือโครงสร้างความเชื่อระดับหน้า
• ใช้ memory_search corpus=all เพื่อครอบคลุมทั้งสองชั้นในการเรียกครั้งเดียว เมื่อ Plugin Active Memory รองรับการเลือกคลังข้อมูล

การตั้งค่าแบบเน้นการทำงานภายในเครื่องที่ใช้กันทั่วไปคือ ใช้ QMD เป็นแบ็กเอนด์ Active Memory สำหรับการเรียกคืน และ ใช้ memory-wiki ในโหมด bridge สำหรับหน้าสังเคราะห์ที่คงทน ดูตัวอย่าง โหมด QMD + bridge ในส่วน การกำหนดค่า

หากโหมด bridge รายงานว่าอาร์ติแฟกต์ที่ส่งออกมีจำนวนเป็นศูนย์ แสดงว่า Plugin Active Memory ยังไม่ได้เปิดเผยอินพุต bridge สาธารณะในขณะนี้ ให้เรียกใช้ openclaw wiki doctor ก่อน จากนั้นยืนยันว่า Plugin Active Memory รองรับอาร์ติแฟกต์สาธารณะ

โหมดคลัง

• isolated (ค่าเริ่มต้น): มีคลังและแหล่งข้อมูลของตนเอง โดยไม่ขึ้นต่อ Plugin Active Memory ใช้สำหรับคลังความรู้ที่คัดสรรและทำงานได้อย่างเป็นอิสระ
• bridge: อ่านอาร์ติแฟกต์หน่วยความจำสาธารณะและบันทึกเหตุการณ์จาก Plugin Active Memory ผ่านจุดเชื่อมต่อสาธารณะของ SDK สำหรับ Plugin ใช้เพื่อคอมไพล์อาร์ติแฟกต์ที่ Plugin หน่วยความจำส่งออก โดยไม่เข้าถึงส่วนภายในที่เป็นส่วนตัวของ Plugin
• unsafe-local: ช่องทางเลี่ยงสำหรับเครื่องเดียวกันที่ต้องเปิดใช้อย่างชัดเจน เพื่อเข้าถึงพาธภายในเครื่องที่เป็นส่วนตัว ออกแบบให้เป็นฟีเจอร์ทดลองและไม่รองรับการย้ายข้ามสภาพแวดล้อมโดยตั้งใจ ใช้เฉพาะเมื่อคุณเข้าใจขอบเขตความไว้วางใจและต้องการการเข้าถึงระบบไฟล์ภายในเครื่องซึ่งโหมด bridge ไม่สามารถให้ได้โดยเฉพาะ

โหมดคลังและขอบเขตคลังเป็นตัวเลือกที่แยกจากกัน:

• vaultMode เลือกแหล่งที่มาของอินพุตวิกิ
• vault.scope เลือกว่าจะให้เอเจนต์ทั้งหมดใช้คลังเดียวกัน หรือให้แต่ละเอเจนต์มีคลังย่อยของตนเอง

vault.scope: "global" เป็นค่าเริ่มต้นและคงพฤติกรรมแบบคลังเดียวที่มีอยู่เดิม ใช้ vault.scope: "agent" ร่วมกับโหมด isolated หรือ bridge เมื่อ เอเจนต์ต้องไม่ใช้หน้าวิกิ ข้อมูลสรุปที่คอมไพล์แล้ว ผลการค้นหา หรือการเขียนร่วมกัน ขอบเขตระดับเอเจนต์ใช้ร่วมกับโหมด unsafe-local ไม่ได้ เนื่องจากพาธส่วนตัวที่กำหนดค่าไว้เหล่านั้น ไม่ใช่อินพุตที่เอเจนต์เป็นเจ้าของ การตรวจสอบความถูกต้องของการกำหนดค่าจะปฏิเสธ ชุดค่าผสมนี้

โหมด bridge สามารถทำดัชนีรายการต่อไปนี้ตามตัวเลือกเปิด/ปิดในค่ากำหนด bridge.*:

• อาร์ติแฟกต์หน่วยความจำที่ส่งออก (indexMemoryRoot)
• บันทึกรายวัน (indexDailyNotes)
• รายงานความฝัน (indexDreamReports)
• บันทึกเหตุการณ์หน่วยความจำ (followMemoryEvents)

เมื่อโหมด bridge ทำงานอยู่และเปิดใช้ bridge.readMemoryArtifacts openclaw wiki status, openclaw wiki doctor และ openclaw wiki bridge import จะส่งคำขอผ่าน Gateway ที่กำลังทำงาน เพื่อให้เห็นบริบท Plugin Active Memory เดียวกับหน่วยความจำของเอเจนต์/รันไทม์ หากปิดใช้ bridge หรือปิดการอ่านอาร์ติแฟกต์ คำสั่งเหล่านั้นจะยังคงทำงานแบบภายในเครื่อง/ออฟไลน์

โครงสร้างคลัง

<vault>/  AGENTS.md  WIKI.md  index.md  inbox.md  entities/  concepts/  syntheses/  sources/  reports/  _attachments/  _views/  .openclaw-wiki/

เนื้อหาที่ระบบจัดการจะอยู่ภายในบล็อกที่สร้างขึ้น ส่วนบล็อกบันทึกของมนุษย์จะ ถูกเก็บรักษาไว้เมื่อสร้างใหม่

• sources/: วัตถุดิบดิบที่นำเข้า และหน้าที่มีแหล่งข้อมูลจาก bridge/unsafe-local
• entities/: สิ่งที่คงทน บุคคล ระบบ โครงการ วัตถุ
• concepts/: แนวคิด นามธรรม รูปแบบ นโยบาย (รวมถึงเป็นตำแหน่งปลายทางสำหรับการนำเข้า OKF)
• syntheses/: บทสรุปที่คอมไพล์แล้วและข้อมูลสรุปรวมที่ได้รับการดูแลรักษา
• reports/: แดชบอร์ดที่สร้างขึ้น

การนำเข้า Open Knowledge Format

openclaw wiki okf import ./bundles/ga4

นำเข้าบันเดิล Open Knowledge Format ที่แตกไฟล์แล้วไปยังหน้าแนวคิดของวิกิ เหมาะอย่างยิ่ง เมื่อแค็ตตาล็อกข้อมูล โปรแกรมรวบรวมเอกสาร หรือเอเจนต์เสริมข้อมูลสร้าง OKF อยู่แล้ว โดยคง OKF ไว้เป็นอาร์ติแฟกต์แลกเปลี่ยนแบบพกพา และให้ memory-wiki แปลงเป็นหน้าแนวคิดแบบเนทีฟของ OpenClaw และข้อมูลสรุปที่คอมไพล์แล้ว

• ไฟล์ .md ที่ไม่ได้สงวนไว้เป็นเอกสารแนวคิด
• แนวคิดที่นำเข้าแต่ละรายการต้องมีฟิลด์ frontmatter type ที่ไม่ว่าง หากไม่มี type จะเกิดคำเตือน missing-type และข้ามไฟล์นั้น
• ยอมรับค่า type ที่ไม่รู้จักเป็นแนวคิดทั่วไป
• index.md และ log.md เป็นชื่อที่สงวนไว้และจะไม่ถูกนำเข้าเป็นแนวคิด
• ลิงก์ Markdown ที่เสียหายหรือชี้ไปภายนอกจะคงไว้โดยไม่เปลี่ยนแปลง

หน้าที่นำเข้าจะถูกจัดให้อยู่ในระดับเดียวกันภายใต้ concepts/ เพื่อให้กระบวนการคอมไพล์ ค้นหา ดึงข้อมูล และ แดชบอร์ดที่มีอยู่มองเห็นหน้าเหล่านั้นได้โดยไม่ต้องมีโครงสร้างวิกิชุดที่สอง แต่ละหน้าจะเก็บ รหัสแนวคิด OKF ดั้งเดิม พาธต้นทาง type, resource, tags, การประทับเวลา และ frontmatter ทั้งหมดของผู้สร้าง ลิงก์ OKF ภายในจะถูกเขียนใหม่ให้ชี้ไปยัง หน้าแนวคิดวิกิที่สร้างขึ้น และสร้างรายการ relationships แบบมีโครงสร้างพร้อม kind: okf-link ด้วย

ข้อกล่าวอ้างและหลักฐานแบบมีโครงสร้าง

หน้าต่าง ๆ มี frontmatter claims แบบมีโครงสร้าง ไม่ใช่เพียงข้อความอิสระ แต่ละ ข้อกล่าวอ้างสามารถมี id, text, status, confidence, evidence[] และ updatedAt แต่ละรายการหลักฐานสามารถมี kind, sourceId, path, lines, weight, confidence, privacyTier, note และ updatedAt

สิ่งนี้ทำให้วิกิทำงานเป็นชั้นความเชื่อ ไม่ใช่เพียงที่ทิ้งบันทึกแบบไม่โต้ตอบ ข้อกล่าวอ้างสามารถติดตาม ให้คะแนน โต้แย้ง และตรวจสอบย้อนกลับไปยังแหล่งข้อมูลเพื่อหาข้อยุติได้

เมทาดาทาเอนทิตีสำหรับเอเจนต์

หน้าเอนทิตีมีเมทาดาทาการกำหนดเส้นทางแบบทั่วไป ซึ่งใช้ได้กับบุคคล ทีม ระบบ โครงการ หรือเอนทิตีประเภทอื่น:

• entityType: ตัวอย่างเช่น person, team, system, project
• canonicalId: คีย์ระบุตัวตนที่คงที่ระหว่างนามแฝงและการนำเข้า
• aliases: ชื่อ ชื่อเรียก หรือป้ายกำกับที่เชื่อมโยงมายังหน้าเดียวกัน
• privacyTier: สตริงรูปแบบอิสระ โดยถือว่า public ไม่ต้องตรวจสอบ ส่วนค่าอื่นทั้งหมด (เช่น local-private, sensitive, confirm-before-use) จะถูกทำเครื่องหมายใน reports/privacy-review.md
• bestUsedFor / notEnoughFor: คำแนะนำการกำหนดเส้นทางแบบกระชับ
• lastRefreshedAt: เวลาประทับของการรีเฟรชแหล่งข้อมูล ซึ่งแยกจากเวลาแก้ไขหน้า
• personCard: การ์ดกำหนดเส้นทางเฉพาะบุคคลที่เป็นตัวเลือก (ชื่อเรียก โซเชียล อีเมล เขตเวลา สายงาน เรื่องที่ควรถาม เรื่องที่ควรหลีกเลี่ยงการถาม ความเชื่อมั่น ระดับความเป็นส่วนตัว)
• relationships: เส้นเชื่อมแบบมีประเภทไปยังหน้าที่เกี่ยวข้อง (เป้าหมาย ประเภท น้ำหนัก ความเชื่อมั่น ประเภทหลักฐาน ระดับความเป็นส่วนตัว หมายเหตุ)

สำหรับวิกิบุคคล ให้เริ่มจาก reports/person-agent-directory.md แล้วเปิด หน้าบุคคลด้วย wiki_get ก่อนใช้รายละเอียดการติดต่อหรือข้อเท็จจริงที่อนุมานได้

pageType: entityentityType: personid: entity.example-personcanonicalId: maintainer.example-personaliases:- Alex- example-handleprivacyTier: local-privatebestUsedFor:- Example ecosystem routingnotEnoughFor:- legal approvallastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:handles:  - "@example-handle"socials:  - "https://x.example/example-handle"emails:  - alex@example.comtimezone: America/Chicagolane: Example ecosystemaskFor:  - Example rollout questionsavoidAskingFor:  - unrelated billing decisionsconfidence: 0.8privacyTier: confirm-before-userelationships:- targetId: entity.other-person  targetTitle: Other Person  kind: collaborates-with  confidence: 0.7  evidenceKind: discrawl-statclaims:- id: claim.example.routing  text: Alex is useful for example-ecosystem routing.  status: supported  confidence: 0.9  evidence:    - kind: maintainer-whois      sourceId: source.maintainers      privacyTier: local-private

ไปป์ไลน์การคอมไพล์

การคอมไพล์จะอ่านหน้าวิกิ ปรับบทสรุปให้เป็นรูปแบบมาตรฐาน และสร้าง อาร์ติแฟกต์สำหรับเครื่องที่มีความคงที่ไว้ภายใต้:

• .openclaw-wiki/cache/agent-digest.json
• .openclaw-wiki/cache/claims.jsonl

เอเจนต์และโค้ดรันไทม์จะอ่านข้อมูลสรุปเหล่านี้แทนการดึงข้อมูลจาก Markdown ผลลัพธ์ที่คอมไพล์แล้วยังขับเคลื่อนการทำดัชนีวิกิรอบแรกสำหรับการค้นหา/ดึงข้อมูล การค้นหาหน้าเจ้าของ จากรหัสข้อกล่าวอ้าง ส่วนเสริมพรอมต์แบบกระชับ และการสร้างรายงาน

แดชบอร์ดและรายงานสถานะระบบ

เมื่อเปิดใช้ render.createDashboards การคอมไพล์จะดูแลแดชบอร์ดภายใต้ reports/:

การค้นหาและการดึงข้อมูล

มีแบ็กเอนด์การค้นหาสองแบบ:

• shared: ใช้กระบวนการค้นหาหน่วยความจำร่วมเมื่อพร้อมใช้งาน
• local: ค้นหาวิกิภายในเครื่อง

มีคลังข้อมูลสามแบบ: wiki, memory, all

• wiki_search / wiki_get ใช้ข้อมูลสรุปที่คอมไพล์แล้วเป็นรอบแรกเมื่อทำได้
• รหัสข้อกล่าวอ้างเชื่อมโยงกลับไปยังหน้าที่เป็นเจ้าของ
• ข้อกล่าวอ้างที่ถูกโต้แย้ง/ล้าสมัย/สดใหม่มีผลต่อการจัดอันดับ
• ป้ายกำกับที่มาจะยังคงอยู่ในผลลัพธ์

โหมดการค้นหา (--mode / พารามิเตอร์ mode ของเครื่องมือ):

เมื่อผลลัพธ์ตรงกับข้อกล่าวอ้างแบบมีโครงสร้าง wiki_search จะส่งคืน matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds และ evidenceSourceIds ในเพย์โหลดรายละเอียด ผลลัพธ์ข้อความ จะมีบรรทัด Claim: และ Evidence: แบบกระชับเมื่อพร้อมใช้งาน

เครื่องมือสำหรับเอเจนต์

Plugin ยังลงทะเบียนส่วนเสริมคลังข้อมูลหน่วยความจำแบบไม่ผูกขาดด้วย ดังนั้น memory_search และ memory_get ที่ใช้ร่วมกันจึงเข้าถึงวิกิได้ เมื่อ Plugin หน่วยความจำที่ใช้งานอยู่รองรับการเลือกคลังข้อมูล

ลักษณะการทำงานของพรอมต์และบริบท

เมื่อเปิดใช้ context.includeCompiledDigestPrompt ส่วนหน่วยความจำของพรอมต์ จะต่อท้ายสแนปช็อตแบบย่อที่คอมไพล์จาก agent-digest.json ได้แก่ เฉพาะหน้าอันดับต้น เฉพาะข้อกล่าวอ้างอันดับต้น จำนวนข้อขัดแย้ง จำนวนคำถาม และตัวระบุระดับความเชื่อมั่น/ ความใหม่ คุณลักษณะนี้ต้องเปิดใช้โดยสมัครใจเนื่องจากเปลี่ยนรูปแบบพรอมต์ โดยมีความสำคัญ เป็นหลักต่อกลไกบริบทหรือการประกอบพรอมต์ที่ใช้ส่วนเสริมหน่วยความจำอย่างชัดเจน

การกำหนดค่า

ใส่การกำหนดค่าไว้ภายใต้ plugins.entries.memory-wiki.config:

{  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "isolated",          vault: {            scope: "global",            path: "~/.openclaw/wiki/main",            renderMode: "obsidian",          },          obsidian: {            enabled: true,            useOfficialCli: true,            vaultName: "OpenClaw Wiki",            openAfterWrites: false,          },          bridge: {            enabled: false,            readMemoryArtifacts: true,            indexDreamReports: true,            indexDailyNotes: true,            indexMemoryRoot: true,            followMemoryEvents: true,          },          unsafeLocal: {            allowPrivateMemoryCoreAccess: false,            paths: [],          },          ingest: {            autoCompile: true,            maxConcurrentJobs: 1,            allowUrlIngest: true,          },          search: {            backend: "shared",            corpus: "wiki",          },          context: {            includeCompiledDigestPrompt: false,          },          render: {            preserveHumanBlocks: true,            createBacklinks: true,            createDashboards: true,          },        },      },    },  },}

ตัวเลือกสำคัญ:

คลังแยกตามเอเจนต์

ตั้งค่า vault.scope เป็น agent เพื่อให้เอเจนต์ที่กำหนดค่าไว้แต่ละตัวมีวิกิแยกกัน ในขอบเขตนี้ vault.path คือไดเรกทอรีแม่ และ OpenClaw จะต่อท้ายรหัสเอเจนต์ ที่ปรับให้อยู่ในรูปแบบมาตรฐาน:

{  agents: {    list: [{ id: "support" }, { id: "marketing" }],  },  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "bridge",          vault: {            scope: "agent",            path: "~/.openclaw/wiki",          },          bridge: {            enabled: true,            readMemoryArtifacts: true,          },        },      },    },  },}

การกำหนดค่านี้จะแปลงเป็น ~/.openclaw/wiki/support และ ~/.openclaw/wiki/marketing หากละเว้น vault.path ในขอบเขตเอเจนต์ ไดเรกทอรีแม่จะมีค่าเริ่มต้นเป็น ~/.openclaw/wiki ดังนั้นเอเจนต์ main เริ่มต้นจึงยังคงใช้พาธ ~/.openclaw/wiki/main เดิม

เครื่องมือเอเจนต์ สรุปพรอมต์ที่คอมไพล์ และส่วนเสริมวิกิที่เปิดเผยผ่าน memory_search / memory_get จะระบุคลังจากบริบทของเอเจนต์ที่ใช้งานอยู่ สำหรับการเรียกผ่าน CLI และ Gateway ในการตั้งค่าที่มีเอเจนต์หลายตัว ให้ระบุเอเจนต์อย่างชัดเจนด้วย openclaw wiki --agent <agentId> ... หรือ agentId ของคำขอ Gateway หากกำหนดค่าเอเจนต์ไว้เพียงตัวเดียว เอเจนต์นั้นจะยังคงเป็นค่าเริ่มต้นเมื่อไม่ได้ระบุรหัส

ในโหมดบริดจ์ การนำเข้าในขอบเขตเอเจนต์จะยอมรับอาร์ติแฟกต์หน่วยความจำสาธารณะ เฉพาะเมื่อ agentIds ของอาร์ติแฟกต์นั้นมีเอเจนต์ที่เลือก อาร์ติแฟกต์ที่เป็นของ เอเจนต์อื่น ไม่มีเมทาดาทาความเป็นเจ้าของ หรือไม่ทราบเจ้าของจะถูกข้าม ขอบเขตส่วนกลางยังคงใช้ลักษณะการทำงานเดิมสำหรับอาร์ติแฟกต์ที่ใช้ร่วมกัน

ตัวอย่าง: QMD + โหมดบริดจ์

ใช้รูปแบบนี้เมื่อคุณต้องการ QMD สำหรับการเรียกคืน และ memory-wiki สำหรับชั้นความรู้ที่ได้รับการดูแล แต่ละชั้นยังคงมุ่งเน้นหน้าที่ของตน: QMD ทำให้บันทึกดิบ ข้อมูลส่งออกของเซสชัน และคอลเลกชันเพิ่มเติมค้นหาได้ ขณะที่ memory-wiki คอมไพล์เอนทิตี ข้อกล่าวอ้าง แดชบอร์ด และหน้าแหล่งที่มา ที่มีเสถียรภาพ

{  memory: {    backend: "qmd",  },  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "bridge",          bridge: {            enabled: true,            readMemoryArtifacts: true,            indexDreamReports: true,            indexDailyNotes: true,            indexMemoryRoot: true,            followMemoryEvents: true,          },          search: {            backend: "shared",            corpus: "all",          },          context: {            includeCompiledDigestPrompt: false,          },        },      },    },  },}

การกำหนดค่านี้ทำให้ QMD รับผิดชอบการเรียกคืนหน่วยความจำที่ใช้งานอยู่ ทำให้ memory-wiki มุ่งเน้นหน้าที่คอมไพล์และแดชบอร์ด และคงรูปแบบพรอมต์ไว้ โดยไม่เปลี่ยนแปลงจนกว่าคุณจะเปิดใช้พรอมต์สรุปที่คอมไพล์โดยเจตนา

CLI

openclaw wiki statusopenclaw wiki doctoropenclaw wiki initopenclaw wiki ingest ./notes/alpha.mdopenclaw wiki compileopenclaw wiki lintopenclaw wiki search "alpha"openclaw wiki get entity.alphaopenclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alphaopenclaw wiki bridge importopenclaw wiki obsidian status

ดูข้อมูลอ้างอิงคำสั่งฉบับเต็มได้ที่ CLI: วิกิ รวมถึง wiki okf import, wiki apply metadata, wiki unsafe-local import, wiki chatgpt import / wiki chatgpt rollback และชุดคำสั่งย่อย wiki obsidian ทั้งหมด

การรองรับ Obsidian

เมื่อ vault.renderMode เป็น obsidian Plugin จะเขียน Markdown ที่ใช้งานร่วมกับ Obsidian ได้ และสามารถเลือกใช้ CLI obsidian อย่างเป็นทางการ สำหรับตรวจสอบสถานะ ค้นหาคลัง เปิดหน้า เรียกใช้คำสั่ง และไปยังบันทึกประจำวัน คุณลักษณะนี้เป็นทางเลือก วิกิยังคงทำงานในโหมดเนทีฟได้โดยไม่ต้องใช้ Obsidian

คลังในขอบเขตเอเจนต์ยังคงใช้ Markdown ที่เข้ากันได้กับ Obsidian ได้ แต่การตรวจสอบความถูกต้องของการกำหนดค่าจะปฏิเสธ obsidian.useOfficialCli: true เมื่อใช้ vault.scope: "agent" การตั้งค่า obsidian.vaultName ปัจจุบันเป็นแบบส่วนกลางและไม่สามารถเลือก คลัง Obsidian แยกสำหรับเอเจนต์แต่ละตัวได้ ให้ใช้เครื่องมือวิกิและการดำเนินการ ผ่าน CLI แทน หรือคงวิกิที่ดำเนินการผ่าน Obsidian ไว้ในขอบเขตส่วนกลาง

เวิร์กโฟลว์ที่แนะนำ

เอกสารที่เกี่ยวข้อง

• ภาพรวมหน่วยความจำ
• CLI: หน่วยความจำ
• CLI: วิกิ
• ภาพรวม Plugin SDK