Wiki bộ nhớ

memory-wiki là một Plugin đi kèm, biến bộ nhớ bền vững thành một kho tri thức đã biên soạn.

Nó không thay thế Plugin Active Memory. Plugin Active Memory vẫn sở hữu việc gọi nhớ, thăng cấp, lập chỉ mục và Dreaming. memory-wiki nằm bên cạnh và biên soạn tri thức bền vững thành một wiki có thể điều hướng với các trang xác định, các khẳng định có cấu trúc, nguồn gốc, bảng điều khiển và bản tóm tắt máy có thể đọc.

Dùng nó khi bạn muốn bộ nhớ hoạt động giống một lớp tri thức được duy trì hơn và ít giống một đống tệp Markdown hơn.

Nó bổ sung gì

• Một kho wiki riêng với bố cục trang xác định
• Siêu dữ liệu khẳng định và bằng chứng có cấu trúc, không chỉ là văn xuôi
• Nguồn gốc, độ tin cậy, mâu thuẫn và câu hỏi mở ở cấp trang
• Bản tóm tắt đã biên soạn cho agent/người tiêu thụ runtime
• Công cụ tìm kiếm/lấy/áp dụng/lint dành riêng cho wiki
• Nhập Open Knowledge Format vào các khái niệm wiki đã biên soạn
• Chế độ cầu nối tùy chọn nhập hiện vật công khai từ Plugin Active Memory
• Chế độ render thân thiện với Obsidian và tích hợp CLI tùy chọn

Cách nó khớp với bộ nhớ

Hãy hình dung phần tách lớp như sau:

Nếu Plugin Active Memory phơi bày các hiện vật gọi nhớ dùng chung, OpenClaw có thể tìm kiếm cả hai lớp trong một lượt bằng memory_search corpus=all.

Khi bạn cần xếp hạng dành riêng cho wiki, nguồn gốc hoặc truy cập trang trực tiếp, hãy dùng các công cụ gốc của wiki.

Mẫu kết hợp được khuyến nghị

Mặc định mạnh cho thiết lập ưu tiên cục bộ là:

• QMD làm backend Active Memory cho gọi nhớ và tìm kiếm ngữ nghĩa rộng
• memory-wiki ở chế độ bridge cho các trang tri thức tổng hợp bền vững

Cách tách đó hoạt động tốt vì mỗi lớp luôn tập trung:

• QMD giữ cho ghi chú thô, bản xuất phiên và các bộ sưu tập bổ sung có thể tìm kiếm
• memory-wiki biên soạn các thực thể, khẳng định, bảng điều khiển và trang nguồn ổn định

Quy tắc thực tế:

• dùng memory_search khi bạn muốn một lượt gọi nhớ rộng trên toàn bộ bộ nhớ
• dùng wiki_search và wiki_get khi bạn muốn kết quả wiki có nhận thức về nguồn gốc
• dùng memory_search corpus=all khi bạn muốn tìm kiếm dùng chung bao phủ cả hai lớp

Nếu chế độ cầu nối báo cáo không có hiện vật đã xuất nào, Plugin Active Memory hiện chưa phơi bày đầu vào cầu nối công khai. Chạy openclaw wiki doctor trước, rồi xác nhận Plugin Active Memory hỗ trợ hiện vật công khai.

Khi chế độ cầu nối đang hoạt động và bridge.readMemoryArtifacts được bật, openclaw wiki status, openclaw wiki doctor và openclaw wiki bridge import đọc qua Gateway đang chạy. Điều đó giữ cho các kiểm tra cầu nối CLI khớp với ngữ cảnh Plugin bộ nhớ ở runtime. Nếu cầu nối bị tắt hoặc đọc hiện vật bị tắt, các lệnh đó vẫn giữ hành vi cục bộ/ngoại tuyến.

Chế độ kho

memory-wiki hỗ trợ ba chế độ kho:

isolated

Kho riêng, nguồn riêng, không phụ thuộc vào memory-core.

Dùng chế độ này khi bạn muốn wiki là kho tri thức được tuyển chọn riêng.

bridge

Đọc hiện vật bộ nhớ công khai và sự kiện bộ nhớ từ Plugin Active Memory thông qua các điểm nối Plugin SDK công khai.

Dùng chế độ này khi bạn muốn wiki biên soạn và tổ chức các hiện vật đã xuất của Plugin bộ nhớ mà không chạm vào nội bộ riêng tư của Plugin.

Chế độ cầu nối có thể lập chỉ mục:

• hiện vật bộ nhớ đã xuất
• báo cáo dream
• ghi chú hằng ngày
• tệp gốc bộ nhớ
• nhật ký sự kiện bộ nhớ

unsafe-local

Cửa thoát tường minh trên cùng máy cho đường dẫn cục bộ riêng tư.

Chế độ này có chủ ý là thử nghiệm và không di động. Chỉ dùng khi bạn hiểu ranh giới tin cậy và thật sự cần truy cập hệ thống tệp cục bộ mà chế độ cầu nối không cung cấp được.

Bố cục kho

Plugin khởi tạo một kho như sau:

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

Nội dung được quản lý nằm trong các khối đã tạo. Khối ghi chú của con người được giữ nguyên.

Các nhóm trang chính là:

• sources/ cho tài liệu thô đã nhập và các trang được cầu nối hỗ trợ
• entities/ cho sự vật, con người, hệ thống, dự án và đối tượng bền vững
• concepts/ cho ý tưởng, trừu tượng, mẫu hình và chính sách
• syntheses/ cho tóm tắt đã biên soạn và bản tổng hợp được duy trì
• reports/ cho bảng điều khiển được tạo

Nhập Open Knowledge Format

memory-wiki có thể nhập các gói Open Knowledge Format đã giải nén bằng:

openclaw wiki okf import ./bundles/ga4

Đây là cách phù hợp sạch nhất khi danh mục dữ liệu, trình thu thập tài liệu hoặc agent làm giàu đã tạo OKF: giữ OKF làm hiện vật trao đổi di động, rồi để memory-wiki biến nó thành các trang khái niệm gốc OpenClaw và bản tóm tắt đã biên soạn.

Trình nhập tuân theo dạng OKF v0.1:

• các tệp .md không dành riêng là tài liệu khái niệm
• mỗi khái niệm đã nhập cần trường frontmatter type không rỗng
• các giá trị OKF type không xác định vẫn được chấp nhận
• các tệp dành riêng index.md và log.md không được nhập làm khái niệm
• liên kết markdown hỏng hoặc bên ngoài được giữ nguyên

Các trang khái niệm đã nhập được làm phẳng dưới concepts/ để các đường dẫn biên soạn, tìm kiếm, lấy, bảng điều khiển và prompt-digest hiện có nhìn thấy chúng mà không cần thêm cây wiki thứ hai. Mỗi trang giữ ID khái niệm OKF gốc, đường dẫn nguồn, type, resource, tags, dấu thời gian và toàn bộ frontmatter của bộ tạo. Liên kết OKF nội bộ được viết lại sang các trang khái niệm wiki đã tạo và cũng được phát ra dưới dạng các mục relationships có cấu trúc với kind: okf-link.

Khẳng định và bằng chứng có cấu trúc

Trang có thể mang frontmatter claims có cấu trúc, không chỉ văn bản tự do.

Mỗi khẳng định có thể bao gồm:

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

Mục bằng chứng có thể bao gồm:

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

Đây là điều khiến wiki hoạt động giống một lớp niềm tin hơn là một nơi đổ ghi chú thụ động. Khẳng định có thể được theo dõi, chấm điểm, tranh luận và truy ngược về nguồn.

Siêu dữ liệu thực thể dành cho agent

Trang thực thể cũng có thể mang siêu dữ liệu định tuyến cho agent sử dụng. Đây là frontmatter chung, nên nó hoạt động cho người, đội nhóm, hệ thống, dự án hoặc bất kỳ loại thực thể nào khác.

Các trường phổ biến bao gồm:

• entityType: ví dụ person, team, system hoặc project
• canonicalId: khóa danh tính ổn định dùng trên alias và nhập liệu
• aliases: tên, handle hoặc nhãn nên phân giải về cùng một trang
• privacyTier: public, local-private, sensitive hoặc confirm-before-use
• bestUsedFor / notEnoughFor: gợi ý định tuyến ngắn gọn
• lastRefreshedAt: dấu thời gian làm mới nguồn tách biệt với thời gian chỉnh sửa trang
• personCard: thẻ định tuyến tùy chọn dành riêng cho người với handle, mạng xã hội, email, múi giờ, luồng, nên hỏi về, tránh hỏi về, độ tin cậy và quyền riêng tư
• relationships: cạnh có kiểu đến các trang liên quan với đích, loại, trọng số, độ tin cậy, loại bằng chứng, cấp riêng tư và ghi chú

Đối với wiki về con người, agent thường nên bắt đầu với reports/person-agent-directory.md, rồi mở trang người bằng wiki_get trước khi dùng chi tiết liên hệ hoặc sự kiện suy luận.

Ví dụ:

pageType: entityentityType: personid: entity.brad-grouxcanonicalId: maintainer.brad-grouxaliases:  - Brad  - bgrouxprivacyTier: local-privatebestUsedFor:  - Microsoft Teams and Azure routingnotEnoughFor:  - legal approvallastRefreshedAt: "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-userelationships:  - targetId: entity.alice    targetTitle: Alice    kind: collaborates-with    confidence: 0.7    evidenceKind: discrawl-statclaims:  - 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

Pipeline biên soạn

Bước biên soạn đọc các trang wiki, chuẩn hóa tóm tắt và phát ra các hiện vật ổn định dành cho máy dưới:

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

Các bản tóm tắt này tồn tại để agent và mã runtime không phải quét các trang Markdown.

Đầu ra đã biên soạn cũng cung cấp năng lực cho:

• lập chỉ mục wiki lượt đầu cho luồng tìm kiếm/lấy
• tra cứu ID khẳng định ngược về trang sở hữu
• phần bổ sung prompt ngắn gọn
• tạo báo cáo/bảng điều khiển

Bảng điều khiển và báo cáo sức khỏe

Khi render.createDashboards được bật, quá trình biên soạn duy trì bảng điều khiển dưới reports/.

Báo cáo tích hợp bao gồm:

• 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

Các báo cáo này theo dõi những thứ như:

• cụm ghi chú mâu thuẫn
• cụm khẳng định cạnh tranh
• khẳng định thiếu bằng chứng có cấu trúc
• trang và khẳng định có độ tin cậy thấp
• độ mới cũ hoặc không xác định
• trang có câu hỏi chưa giải quyết
• thẻ định tuyến người/thực thể
• cạnh quan hệ có cấu trúc
• độ phủ lớp bằng chứng
• cấp riêng tư không công khai cần xem xét trước khi dùng

Tìm kiếm và truy xuất

memory-wiki hỗ trợ hai backend tìm kiếm:

• shared: dùng luồng tìm kiếm bộ nhớ dùng chung khi có
• local: tìm kiếm wiki cục bộ

Nó cũng hỗ trợ ba kho ngữ liệu:

• wiki
• memory
• all

Hành vi quan trọng:

• wiki_search và wiki_get dùng bản tóm tắt đã biên soạn làm lượt đầu khi có thể
• ID khẳng định có thể phân giải ngược về trang sở hữu
• khẳng định bị tranh luận/cũ/mới ảnh hưởng đến xếp hạng
• nhãn nguồn gốc có thể được giữ trong kết quả
• chế độ tìm kiếm có thể thiên vị xếp hạng cho tra cứu người, định tuyến câu hỏi, bằng chứng nguồn hoặc khẳng định thô

Quy tắc thực tế:

• dùng memory_search corpus=all cho một lượt gọi nhớ rộng
• dùng wiki_search + wiki_get khi bạn quan tâm đến xếp hạng dành riêng cho wiki, nguồn gốc hoặc cấu trúc niềm tin ở cấp trang

Chế độ tìm kiếm:

• auto: mặc định cân bằng
• find-person: tăng hạng thực thể giống người, alias, handle, mạng xã hội và ID chuẩn
• route-question: tăng hạng thẻ agent, gợi ý ask-for, gợi ý best-used-for và ngữ cảnh quan hệ
• source-evidence: tăng hạng trang nguồn và siêu dữ liệu bằng chứng có cấu trúc
• raw-claim: tăng hạng các khẳng định có cấu trúc khớp và trả về siêu dữ liệu khẳng định/bằng chứng trong kết quả

Khi một kết quả khớp với khẳng định có cấu trúc, wiki_search có thể trả về matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds và evidenceSourceIds trong payload chi tiết. Đầu ra văn bản cũng bao gồm các dòng Claim: và Evidence: ngắn gọn khi có.

Công cụ agent

Plugin đăng ký các công cụ sau:

• wiki_status
• wiki_search
• wiki_get
• wiki_apply
• wiki_lint

Chúng làm gì:

• wiki_status: chế độ kho hiện tại, sức khỏe, tính khả dụng của CLI Obsidian
• wiki_search: tìm kiếm trang wiki và, khi được cấu hình, kho ngữ liệu bộ nhớ dùng chung; chấp nhận mode cho tra cứu người, định tuyến câu hỏi, bằng chứng nguồn hoặc đào sâu khẳng định thô
• wiki_get: đọc một trang wiki theo id/đường dẫn hoặc fallback về kho ngữ liệu bộ nhớ dùng chung
• wiki_apply: đột biến tổng hợp/siêu dữ liệu hẹp mà không phẫu thuật trang tự do
• wiki_lint: kiểm tra cấu trúc, khoảng trống nguồn gốc, mâu thuẫn, câu hỏi mở

Plugin cũng đăng ký một phần bổ sung kho ngữ liệu bộ nhớ không độc quyền, nên các công cụ dùng chung memory_search và memory_get có thể truy cập wiki khi plugin bộ nhớ đang hoạt động hỗ trợ chọn kho ngữ liệu.

Hành vi lời nhắc và ngữ cảnh

Khi bật context.includeCompiledDigestPrompt, các phần lời nhắc bộ nhớ sẽ nối thêm một ảnh chụp tổng hợp đã biên soạn, dạng nhỏ gọn, từ agent-digest.json.

Ảnh chụp này được cố ý giữ nhỏ gọn và giàu tín hiệu:

• chỉ các trang hàng đầu
• chỉ các nhận định hàng đầu
• số lượng mâu thuẫn
• số lượng câu hỏi
• các định tính về độ tin cậy/độ mới

Tùy chọn này là tự nguyện vì nó thay đổi hình dạng lời nhắc và chủ yếu hữu ích cho các engine ngữ cảnh hoặc cơ chế lắp ráp lời nhắc cũ có chủ đích tiêu thụ các phần bổ sung bộ nhớ.

Cấu hình

Đặt cấu hình dưới plugins.entries.memory-wiki.config:

{  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,          },        },      },    },  },}

Các nút bật/tắt chính:

• vaultMode: isolated, bridge, unsafe-local
• vault.renderMode: native hoặc obsidian
• bridge.readMemoryArtifacts: nhập các hiện vật công khai của plugin bộ nhớ đang hoạt động
• bridge.followMemoryEvents: bao gồm nhật ký sự kiện ở chế độ bridge
• search.backend: shared hoặc local
• search.corpus: wiki, memory, hoặc all
• context.includeCompiledDigestPrompt: nối ảnh chụp digest nhỏ gọn vào các phần lời nhắc bộ nhớ
• render.createBacklinks: tạo các khối liên quan theo cách xác định
• render.createDashboards: tạo các trang bảng điều khiển

Ví dụ: QMD + chế độ bridge

Dùng cấu hình này khi bạn muốn QMD để truy hồi và memory-wiki cho một lớp tri thức được duy trì:

{  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,          },        },      },    },  },}

Điều này giữ cho:

• QMD phụ trách truy hồi bộ nhớ đang hoạt động
• memory-wiki tập trung vào các trang đã biên soạn và bảng điều khiển
• hình dạng lời nhắc không đổi cho đến khi bạn chủ động bật lời nhắc digest đã biên soạn

CLI

memory-wiki cũng cung cấp một bề mặt CLI cấp cao nhất:

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

Xem CLI: wiki để có tài liệu tham chiếu lệnh đầy đủ.

Hỗ trợ Obsidian

Khi vault.renderMode là obsidian, plugin ghi Markdown thân thiện với Obsidian và có thể tùy chọn dùng CLI obsidian chính thức.

Các quy trình được hỗ trợ bao gồm:

• thăm dò trạng thái
• tìm kiếm vault
• mở một trang
• gọi một lệnh Obsidian
• chuyển tới ghi chú hằng ngày

Phần này là tùy chọn. Wiki vẫn hoạt động ở chế độ native mà không cần Obsidian.

Quy trình được khuyến nghị

1. Giữ plugin bộ nhớ đang hoạt động của bạn cho truy hồi/đề bạt/Dreaming.
2. Bật memory-wiki.
3. Bắt đầu với chế độ isolated trừ khi bạn rõ ràng muốn dùng chế độ bridge.
4. Dùng wiki_search / wiki_get khi nguồn gốc quan trọng.
5. Dùng wiki_apply cho các bản tổng hợp hẹp hoặc cập nhật siêu dữ liệu.
6. Chạy wiki_lint sau các thay đổi đáng kể.
7. Bật bảng điều khiển nếu bạn muốn thấy dữ liệu cũ/mâu thuẫn.

Tài liệu liên quan

• Tổng quan về bộ nhớ
• CLI: bộ nhớ
• CLI: wiki
• Tổng quan Plugin SDK