memory-wiki là một plugin đi kèm có chức năng biên soạn kiến thức bền vững thành một
wiki có thể điều hướng: các trang có tính xác định, các luận điểm có cấu trúc kèm bằng chứng,
nguồn gốc, bảng điều khiển và bản tóm lược mà máy có thể đọc được.
Plugin này không thay thế plugin Active Memory. Việc truy hồi, thăng cấp, lập chỉ mục và
Dreaming vẫn thuộc quyền quản lý của bất kỳ phần phụ trợ bộ nhớ nào được cấu hình
(memory-core, QMD, Honcho, v.v.). memory-wiki hoạt động bên cạnh phần phụ trợ đó và biên soạn
kiến thức thành một lớp wiki được duy trì.
Quy tắc thực tế:
memory_searchđể thực hiện một lượt truy hồi rộng trên mọi kho ngữ liệu đã cấu hìnhwiki_search/wiki_getkhi cần xếp hạng dành riêng cho wiki, thông tin nguồn gốc hoặc cấu trúc niềm tin cấp trangmemory_search corpus=allđể bao quát cả hai lớp trong một lệnh gọi khi plugin Active Memory hỗ trợ chọn kho ngữ liệu
memory-wiki ở chế độ bridge cho các trang tổng hợp bền vững. Xem ví dụ
QMD + chế độ cầu nối trong phần Cấu hình.
Nếu chế độ cầu nối báo cáo không có hiện vật nào được xuất, thì plugin Active Memory
hiện không cung cấp đầu vào cầu nối công khai. Trước tiên hãy chạy openclaw wiki doctor,
sau đó xác nhận plugin Active Memory hỗ trợ hiện vật công khai.
Chế độ vault
isolated(mặc định): vault riêng, nguồn riêng, không phụ thuộc vào plugin Active Memory. Dùng chế độ này cho một kho kiến thức tuyển chọn độc lập.bridge: đọc các hiện vật bộ nhớ công khai và nhật ký sự kiện từ plugin Active Memory thông qua các điểm nối SDK plugin công khai. Dùng chế độ này để biên soạn các hiện vật do plugin bộ nhớ xuất mà không truy cập vào phần nội bộ riêng tư của plugin.unsafe-local: lối thoát tường minh trên cùng máy dành cho các đường dẫn cục bộ riêng tư. Được chủ ý xem là thử nghiệm và không có tính di động; chỉ dùng khi bạn hiểu ranh giới tin cậy và đặc biệt cần quyền truy cập hệ thống tệp cục bộ mà chế độ cầu nối không thể cung cấp.
vaultModechọn nguồn đầu vào wiki.vault.scopechọn tất cả agent dùng chung một vault hay mỗi agent có một vault con.
vault.scope: "global" là mặc định và duy trì hành vi một vault hiện có.
Dùng vault.scope: "agent" với chế độ isolated hoặc bridge khi
các agent không được dùng chung trang wiki, bản tóm lược đã biên soạn, kết quả tìm kiếm hoặc thao tác ghi.
Không thể kết hợp phạm vi agent với chế độ unsafe-local vì các đường dẫn
riêng tư đã cấu hình đó không phải là đầu vào do agent sở hữu. Quá trình xác thực cấu hình sẽ từ chối
tổ hợp này.
Chế độ cầu nối có thể lập chỉ mục những nội dung sau, tùy theo nút bật/tắt cấu hình bridge.*:
- các hiện vật bộ nhớ đã xuất (
indexMemoryRoot) - ghi chú hằng ngày (
indexDailyNotes) - báo cáo Dreaming (
indexDreamReports) - nhật ký sự kiện bộ nhớ (
followMemoryEvents)
bridge.readMemoryArtifacts được bật,
openclaw wiki status, openclaw wiki doctor và openclaw wiki bridge import được định tuyến qua Gateway đang chạy để chúng thấy cùng ngữ cảnh plugin Active Memory
như bộ nhớ agent/runtime. Nếu cầu nối bị tắt hoặc tính năng đọ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.
Bố cục vault
sources/: tài liệu thô đã nhập và các trang dựa trên cầu nối/cục bộ không an toànentities/: các sự vật, con người, hệ thống, dự án và đối tượng bền vữngconcepts/: ý tưởng, khái niệm trừu tượng, mẫu và chính sách (đồng thời là vị trí đích cho nội dung nhập OKF)syntheses/: bản tóm tắt đã biên soạn và bản tổng hợp được duy trìreports/: bảng điều khiển đã tạo
Nhập Open Knowledge Format
memory-wiki
chuyển nó thành các trang khái niệm gốc của OpenClaw và các bản tóm lược đã biên soạn.
- các tệp
.mdkhông dành riêng là tài liệu khái niệm - mỗi khái niệm được nhập yêu cầu trường frontmatter
typekhông trống; thiếutypesẽ tạo cảnh báomissing-typevà tệp bị bỏ qua - các giá trị
typekhông xác định được chấp nhận dưới dạng khái niệm chung index.mdvàlog.mdđược dành riêng và không bao giờ được nhập dưới dạng khái niệm- các liên kết Markdown bị hỏng hoặc liên kết ngoài được giữ nguyên
concepts/ để các luồng biên soạn, tìm kiếm, lấy và
bảng điều khiển hiện có có thể thấy chúng mà không cần 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 trình tạo. Các liên kết OKF nội bộ được viết lại để trỏ đến
các trang khái niệm wiki đã tạo, đồng thời phát ra các mục relationships có cấu trúc với
kind: okf-link.
Luận điểm và bằng chứng có cấu trúc
Các trang chứa frontmatterclaims có cấu trúc, không chỉ văn bản tự do. Mỗi
luận điểm có thể bao gồm id, text, status, confidence, evidence[] và
updatedAt. Mỗi mục bằng chứng có thể bao gồm kind, sourceId, path,
lines, weight, confidence, privacyTier, note và updatedAt.
Điều này khiến wiki hoạt động như một lớp niềm tin thay vì một kho ghi chú thụ động.
Các luận điểm có thể được theo dõi, chấm điểm, phản biện và đối chiếu ngược về nguồn để giải quyết.
Siêu dữ liệu thực thể dành cho agent
Các trang thực thể chứa siêu dữ liệu định tuyến chung có thể dùng cho con người, nhóm, hệ thống, dự án hoặc bất kỳ loại thực thể nào khác:entityType: ví dụperson,team,system,projectcanonicalId: khóa danh tính ổn định xuyên suốt các bí danh và nội dung nhậpaliases: tên, định danh hoặc nhãn phân giải về cùng một trangprivacyTier: chuỗi dạng tự do;publicđược xem là không cần review, mọi giá trị khác (ví dụlocal-private,sensitive,confirm-before-use) đều được gắn cờ trongreports/privacy-review.mdbestUsedFor/notEnoughFor: gợi ý định tuyến ngắn gọnlastRefreshedAt: dấu thời gian làm mới nguồn, tách biệt với thời gian chỉnh sửa trangpersonCard: thẻ định tuyến tùy chọn dành riêng cho cá nhân (định danh, mạng xã hội, email, múi giờ, luồng, nội dung nên hỏi, nội dung nên tránh hỏi, độ tin cậy, cấp độ riêng tư)relationships: các cạnh có kiểu đến những trang liên quan (đích, loại, trọng số, độ tin cậy, loại bằng chứng, cấp độ riêng tư, ghi chú)
reports/person-agent-directory.md, sau đó mở
trang cá nhân bằng wiki_get trước khi sử dụng thông tin liên hệ hoặc các
sự kiện được suy luận.
Ví dụ về trang thực thể
Ví dụ về trang thực thể
Pipeline biên soạn
Quá trình biên soạn đọc các trang wiki, chuẩn hóa bản tóm tắt và duy trì một bản chụp dành cho máy trong trạng thái plugin SQLite dùng chung của OpenClaw. Mã runtime sử dụng bản chụp của chủ sở hữu do vòng đời quản lý để tải SQLite trong quá trình chuẩn bị prompt bất đồng bộ; quá trình lắp ráp prompt đồng bộ không bao giờ thu thập dữ liệu từ Markdown hoặc đọc tệp bộ nhớ đệm. Đầu ra đã biên soạn cũng hỗ trợ việc lập chỉ mục wiki ở lượt đầu tiên cho thao tác tìm kiếm/lấy, tra cứu ID luận điểm ngược về trang sở hữu, phần bổ sung prompt ngắn gọn và tạo báo cáo. Các chỉnh sửa nguồn và khôi phục vault chỉ trở nên khả dụng cho máy sau lần biên soạn tiếp theo. Việc khởi động lại hoặc làm mới vòng đời plugin sẽ so sánh ấn bản biên soạn được xâu chuỗi nhân quả của vault với SQLite và từ chối bản chụp từ một trạng thái mới hơn đã bị hoàn tác. Trình biên dịch bắt đầu trước khi hoàn tác không thể xuất bản dựa trên trạng thái tiền nhiệm đã khôi phục. Quá trình chuẩn bị prompt không thăm dò vault hoặc cài đặt trình theo dõi tệp. Sau khi cách ly do hoàn tác, một lần biên soạn trong tiến trình đang chạy sẽ xóa chủ sở hữu ngay lập tức; một tiến trình biên dịch riêng biệt yêu cầu làm mới vòng đời plugin để daemon có thể xác nhận ấn bản bền vững mới. Bộ nhớ đệm đã biên soạn có thể được xây dựng lại: các hàng bộ nhớ đệm từ trước các kỷ nguyên xuất bản được xem là không tìm thấy và được thay thế trong lần biên soạn tiếp theo; chúng không được di chuyển.Bảng điều khiển và báo cáo tình trạng
Khirender.createDashboards được bật, quá trình biên soạn duy trì các bảng điều khiển trong
reports/:
Tìm kiếm và truy xuất
Hai phần phụ trợ tìm kiếm:shared: sử dụng luồng tìm kiếm bộ nhớ dùng chung khi khả dụnglocal: tìm kiếm wiki cục bộ
wiki, memory, all.
wiki_search/wiki_getsử dụng các bản tóm lược đã biên soạn làm lượt đầu tiên khi có thể- ID luận điểm được phân giải ngược về trang sở hữu
- các luận điểm bị phản biện/lỗi thời/mới ảnh hưởng đến thứ hạng
- nhãn nguồn gốc được giữ lại trong kết quả
--mode / công cụ mode):
Khi một kết quả khớp với khẳng định có cấu trúc,
wiki_search trả về
matchedClaimId, matchedClaimStatus, matchedClaimConfidence,
evidenceKinds và evidenceSourceIds trong payload chi tiết. Đầu ra văn bản
bao gồm các dòng Claim: và Evidence: dạng rút gọn khi có sẵn.
Công cụ tác nhân
Plugin cũng đăng ký một phần bổ sung kho ngữ liệu bộ nhớ không độc quyền, nhờ đó
memory_search và memory_get dùng chung có thể truy cập wiki khi Plugin bộ nhớ
đang hoạt động hỗ trợ lựa chọn kho ngữ liệu.
Hành vi của lời nhắc và ngữ cảnh
Khicontext.includeCompiledDigestPrompt được bật, các phần lời nhắc bộ nhớ
sẽ nối thêm một bản chụp đã biên dịch dạng rút gọn từ trạng thái Plugin: chỉ các trang hàng đầu,
chỉ các khẳng định hàng đầu, số lượng mâu thuẫn, số lượng câu hỏi, các tiêu chí
về độ tin cậy/độ mới. Tính năng này yêu cầu chủ động bật vì nó thay đổi cấu trúc lời nhắc; nó chủ yếu quan trọng
đối với các công cụ ngữ cảnh hoặc quy trình tạo lời nhắc có sử dụng rõ ràng
các phần bổ sung bộ nhớ.
Cấu hình
Đặt cấu hình trongplugins.entries.memory-wiki.config:
Kho riêng cho từng tác nhân
Đặtvault.scope thành agent để cấp cho mỗi tác nhân đã cấu hình một wiki riêng.
Trong phạm vi này, vault.path là thư mục cha và OpenClaw nối thêm
id tác nhân đã chuẩn hóa:
~/.openclaw/wiki/support và
~/.openclaw/wiki/marketing. Nếu vault.path bị bỏ qua trong phạm vi tác nhân,
thư mục cha mặc định là ~/.openclaw/wiki. Do đó, tác nhân main mặc định giữ nguyên
đường dẫn ~/.openclaw/wiki/main hiện có.
Các công cụ tác nhân, bản tóm lược lời nhắc đã biên dịch và phần bổ sung wiki được cung cấp thông qua
memory_search / memory_get sẽ phân giải kho từ ngữ cảnh tác nhân đang hoạt động.
Đối với các lệnh gọi CLI và Gateway trong thiết lập có nhiều tác nhân được cấu hình, hãy chỉ định
rõ tác nhân bằng openclaw wiki --agent <agentId> ... hoặc agentId của yêu cầu
Gateway. Một tác nhân duy nhất đã cấu hình vẫn là mặc định khi không cung cấp id.
Trong chế độ cầu nối, các thao tác nhập ở phạm vi tác nhân chỉ chấp nhận tạo tác bộ nhớ công khai khi
agentIds của tạo tác đó bao gồm tác nhân đã chọn. Các tạo tác thuộc về tác nhân khác,
không có siêu dữ liệu quyền sở hữu hoặc có chủ sở hữu không xác định sẽ bị bỏ qua. Phạm vi toàn cục
giữ nguyên hành vi tạo tác dùng chung hiện có.
Ví dụ: QMD + chế độ cầu nối
Sử dụng cấu hình này khi bạn muốn dùng QMD để truy hồi vàmemory-wiki làm lớp
tri thức được duy trì. Mỗi lớp giữ đúng trọng tâm: QMD giúp ghi chú thô, dữ liệu xuất
phiên và các bộ sưu tập bổ sung có thể tìm kiếm, trong khi memory-wiki biên dịch
các thực thể ổn định, khẳng định, bảng điều khiển và trang nguồn.
memory-wiki tập trung vào
các trang và bảng điều khiển đã biên dịch, đồng thời không thay đổi cấu trúc lời nhắc cho đến khi bạn
chủ động bật lời nhắc tóm lược đã biên dịch.
CLI
wiki okf import, wiki apply metadata, wiki unsafe-local import,
wiki chatgpt import / wiki chatgpt rollback và toàn bộ tập hợp lệnh con wiki obsidian.
Hỗ trợ Obsidian
Khivault.renderMode là obsidian, Plugin ghi Markdown tương thích với Obsidian
và có thể tùy chọn sử dụng CLI obsidian chính thức để thăm dò trạng thái,
tìm kiếm kho, mở trang, gọi lệnh và chuyển đến
ghi chú hằng ngày. Tính năng này là tùy chọn; wiki vẫn hoạt động ở chế độ gốc mà không cần
Obsidian.
Kho ở phạm vi tác nhân vẫn có thể sử dụng Markdown tương thích với Obsidian, nhưng quá trình xác thực
cấu hình sẽ từ chối obsidian.useOfficialCli: true cùng với vault.scope: "agent".
Thiết lập obsidian.vaultName hiện tại mang tính toàn cục và không thể chọn một kho
Obsidian riêng cho từng tác nhân. Thay vào đó, hãy sử dụng các công cụ wiki và thao tác CLI,
hoặc duy trì một wiki do Obsidian vận hành trong phạm vi toàn cục.
Quy trình làm việc được đề xuất
1
Giữ plugin bộ nhớ đang hoạt động để truy hồi
Việc truy hồi, quảng bá và Dreaming vẫn do backend bộ nhớ đã cấu hình quản lý.
2
Bật memory-wiki
Bắt đầu với chế độ
isolated trừ khi bạn muốn dùng chế độ cầu nối một cách rõ ràng.3
Sử dụng wiki_search / wiki_get khi nguồn gốc thông tin là yếu tố quan trọng
Ưu tiên các công cụ này hơn
memory_search khi bạn muốn dùng cơ chế xếp hạng dành riêng cho wiki hoặc cấu trúc niềm tin ở cấp độ trang.4
Sử dụng wiki_apply cho các bản tổng hợp phạm vi hẹp hoặc cập nhật siêu dữ liệu
Tránh chỉnh sửa thủ công các khối được tạo và quản lý tự động.
5
Chạy wiki_lint sau các thay đổi đáng kể
Phát hiện các mâu thuẫn, câu hỏi chưa được giải đáp và khoảng trống về nguồn gốc thông tin.
6
Bật bảng điều khiển để hiển thị nội dung cũ/mâu thuẫn
Đặt
render.createDashboards: true (mặc định).