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

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.

​

สิ่งที่เพิ่มเข้ามา

• คลังวิกิเฉพาะพร้อมเลย์เอาต์หน้าที่กำหนดได้แน่นอน
• เมทาดาทา claim และหลักฐานแบบมีโครงสร้าง ไม่ใช่แค่ข้อความร้อยแก้ว
• แหล่งที่มา ความมั่นใจ ความขัดแย้ง และคำถามเปิดในระดับหน้า
• digest ที่คอมไพล์แล้วสำหรับผู้บริโภคฝั่งเอเจนต์/รันไทม์
• เครื่องมือค้นหา/get/apply/lint แบบเนทีฟของวิกิ
• โหมด bridge แบบเลือกได้ ซึ่งนำเข้า artifact สาธารณะจาก Plugin หน่วยความจำที่ทำงานอยู่
• โหมด render ที่เป็นมิตรกับ Obsidian และการผสานกับ CLI แบบเลือกได้

​

ทำงานร่วมกับหน่วยความจำอย่างไร

​

รูปแบบไฮบริดที่แนะนำ

• QMD เป็นแบ็กเอนด์หน่วยความจำที่ทำงานอยู่สำหรับการเรียกคืนและการค้นหาเชิงความหมายแบบกว้าง
• memory-wiki ในโหมด bridge สำหรับหน้าความรู้ถาวรที่สังเคราะห์แล้ว

• QMD ทำให้โน้ตดิบ การส่งออกเซสชัน และคอลเลกชันเพิ่มเติมค้นหาได้
• memory-wiki คอมไพล์เอนทิตี claim แดชบอร์ด และหน้าต้นทางที่เสถียร

• ใช้ memory_search เมื่อคุณต้องการการเรียกคืนแบบกว้างหนึ่งรอบทั่วทั้งหน่วยความจำ
• ใช้ wiki_search และ wiki_get เมื่อคุณต้องการผลลัพธ์วิกิที่รับรู้แหล่งที่มา
• ใช้ memory_search corpus=all เมื่อคุณต้องการให้การค้นหาร่วมครอบคลุมทั้งสองชั้น

​

โหมดคลัง

​

isolated

​

bridge

• artifact หน่วยความจำที่ส่งออก
• รายงาน dream
• โน้ตรายวัน
• ไฟล์รากของหน่วยความจำ
• บันทึกเหตุการณ์หน่วยความจำ

​

unsafe-local

​

เลย์เอาต์คลัง

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

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

​

claim และหลักฐานแบบมีโครงสร้าง

• id
• text
• status
• confidence
• evidence[]
• updatedAt

• kind
• sourceId
• path
• lines
• weight
• confidence
• privacyTier
• note
• updatedAt

​

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

• entityType: ตัวอย่างเช่น person, team, system หรือ project
• canonicalId: คีย์ตัวตนที่เสถียรซึ่งใช้ข้ามนามแฝงและการนำเข้า
• aliases: ชื่อ handle หรือป้ายกำกับที่ควร resolve ไปยังหน้าเดียวกัน
• privacyTier: public, local-private, sensitive หรือ confirm-before-use
• bestUsedFor / notEnoughFor: คำใบ้การกำหนดเส้นทางแบบกะทัดรัด
• lastRefreshedAt: timestamp การรีเฟรชแหล่งข้อมูลที่แยกจากเวลาแก้ไขหน้า
• personCard: การ์ดกำหนดเส้นทางเฉพาะบุคคลแบบเลือกได้ พร้อม handle, socials, อีเมล เขตเวลา lane, ask-for, avoid-asking-for, ความมั่นใจ และความเป็นส่วนตัว
• relationships: edge แบบมีชนิดไปยังหน้าที่เกี่ยวข้อง พร้อมเป้าหมาย ชนิด น้ำหนัก ความมั่นใจ ชนิดหลักฐาน ระดับความเป็นส่วนตัว และโน้ต

pageType: entity
entityType: person
id: entity.brad-groux
canonicalId: maintainer.brad-groux
aliases:
  - Brad
  - bgroux
privacyTier: local-private
bestUsedFor:
  - Microsoft Teams and Azure routing
notEnoughFor:
  - legal approval
lastRefreshedAt: "2026-04-29T00:00:00.000Z"
personCard:
  handles:
    - "@bgroux"
  socials:
    - "https://x.example/bgroux"
  emails:
    - brad@example.com
  timezone: America/Chicago
  lane: Microsoft ecosystem
  askFor:
    - Teams rollout questions
  avoidAskingFor:
    - unrelated billing decisions
  confidence: 0.8
  privacyTier: confirm-before-use
relationships:
  - targetId: entity.alice
    targetTitle: Alice
    kind: collaborates-with
    confidence: 0.7
    evidenceKind: discrawl-stat
claims:
  - id: claim.brad.teams
    text: Brad is useful for Microsoft Teams 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

• การจัดทำดัชนีวิกิรอบแรกสำหรับ flow การค้นหา/get
• การค้นหา claim-id กลับไปยังหน้าที่เป็นเจ้าของ
• ส่วนเสริม prompt แบบกะทัดรัด
• การสร้างรายงาน/แดชบอร์ด

​

แดชบอร์ดและรายงานสุขภาพ

• reports/open-questions.md
• reports/contradictions.md
• reports/low-confidence.md
• reports/claim-health.md
• reports/stale-pages.md
• reports/person-agent-directory.md
• reports/relationship-graph.md
• reports/provenance-coverage.md
• reports/privacy-review.md

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

​

การค้นหาและการเรียกคืน

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

• wiki
• memory
• all

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

• ใช้ memory_search corpus=all สำหรับการเรียกคืนแบบกว้างหนึ่งรอบ
• ใช้ wiki_search + wiki_get เมื่อคุณให้ความสำคัญกับการจัดอันดับเฉพาะวิกิ แหล่งที่มา หรือโครงสร้างความเชื่อระดับหน้า

• auto: ค่าเริ่มต้นแบบสมดุล
• find-person: เพิ่มน้ำหนักเอนทิตีที่เหมือนบุคคล นามแฝง handle, socials และ canonical ID
• route-question: เพิ่มน้ำหนักการ์ดเอเจนต์ คำใบ้ ask-for คำใบ้ best-used-for และ บริบทความสัมพันธ์
• source-evidence: เพิ่มน้ำหนักหน้าต้นทางและเมทาดาทาหลักฐานแบบมีโครงสร้าง
• raw-claim: เพิ่มน้ำหนัก claim แบบมีโครงสร้างที่ตรงกัน และส่งคืนเมทาดาทา claim/หลักฐาน ในผลลัพธ์

​

เครื่องมือเอเจนต์

• wiki_status
• wiki_search
• wiki_get
• wiki_apply
• wiki_lint

• wiki_status: โหมดคลังปัจจุบัน สุขภาพ ความพร้อมใช้งานของ Obsidian CLI
• wiki_search: ค้นหาหน้าวิกิ และเมื่อกำหนดค่าไว้ ค้นหา corpus หน่วยความจำร่วม; รับ mode สำหรับการค้นหาบุคคล การกำหนดเส้นทางคำถาม หลักฐานแหล่งข้อมูล หรือการเจาะลึก claim ดิบ
• wiki_get: อ่านหน้าวิกิตาม id/path หรือ fallback ไปยัง corpus หน่วยความจำร่วม
• wiki_apply: การกลายพันธุ์ synthesis/เมทาดาทาแบบแคบโดยไม่ผ่าตัดหน้าแบบอิสระ
• wiki_lint: การตรวจโครงสร้าง ช่องว่างของแหล่งที่มา ความขัดแย้ง คำถามเปิด

​

พฤติกรรม prompt และบริบท

• เฉพาะหน้ายอดนิยม
• เฉพาะ claim ยอดนิยม
• จำนวนความขัดแย้ง
• จำนวนคำถาม
• ตัวระบุความมั่นใจ/ความสดใหม่

​

การกำหนดค่า

{
  plugins: {
    entries: {
      "memory-wiki": {
        enabled: true,
        config: {
          vaultMode: "isolated",
          vault: {
            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,
          },
          ingest: {
            autoCompile: true,
            maxConcurrentJobs: 1,
            allowUrlIngest: true,
          },
          search: {
            backend: "shared",
            corpus: "wiki",
          },
          context: {
            includeCompiledDigestPrompt: false,
          },
          render: {
            preserveHumanBlocks: true,
            createBacklinks: true,
            createDashboards: true,
          },
        },
      },
    },
  },
}

• vaultMode: isolated, bridge, unsafe-local
• vault.renderMode: native หรือ obsidian
• bridge.readMemoryArtifacts: นำเข้าอาร์ติแฟกต์สาธารณะของ Active Memory Plugin
• bridge.followMemoryEvents: รวมบันทึกเหตุการณ์ในโหมด bridge
• search.backend: shared หรือ local
• search.corpus: wiki, memory หรือ all
• context.includeCompiledDigestPrompt: ผนวกสแนปช็อตไดเจสต์แบบกะทัดรัดเข้ากับส่วนพรอมต์หน่วยความจำ
• render.createBacklinks: สร้างบล็อกที่เกี่ยวข้องแบบกำหนดแน่นอน
• render.createDashboards: สร้างหน้าแดชบอร์ด

​

ตัวอย่าง: โหมด QMD + bridge

{
  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 รับผิดชอบการเรียกคืน Active Memory
• ให้ memory-wiki มุ่งเน้นไปที่หน้าที่คอมไพล์แล้วและแดชบอร์ด
• รูปทรงของพรอมต์ไม่เปลี่ยนแปลงจนกว่าคุณจะตั้งใจเปิดใช้พรอมต์ไดเจสต์ที่คอมไพล์แล้ว

​

CLI

openclaw wiki status
openclaw wiki doctor
openclaw wiki init
openclaw wiki ingest ./notes/alpha.md
openclaw wiki compile
openclaw wiki lint
openclaw wiki search "alpha"
openclaw wiki get entity.alpha
openclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alpha
openclaw wiki bridge import
openclaw wiki obsidian status

​

การรองรับ Obsidian

• การตรวจสอบสถานะ
• การค้นหา vault
• การเปิดหน้า
• การเรียกใช้คำสั่ง Obsidian
• การข้ามไปยังบันทึกประจำวัน

​

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

1. เก็บ Active Memory Plugin ของคุณไว้สำหรับการเรียกคืน/การเลื่อนระดับ/Dreaming
2. เปิดใช้ memory-wiki
3. เริ่มด้วยโหมด isolated เว้นแต่คุณต้องการโหมด bridge อย่างชัดเจน
4. ใช้ wiki_search / wiki_get เมื่อแหล่งที่มามีความสำคัญ
5. ใช้ wiki_apply สำหรับการสังเคราะห์แบบแคบหรือการอัปเดตเมตาดาตา
6. รัน wiki_lint หลังจากมีการเปลี่ยนแปลงที่มีนัยสำคัญ
7. เปิดใช้แดชบอร์ดหากคุณต้องการมองเห็นรายการล้าสมัย/ข้อขัดแย้ง

​

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

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