記憶維基

memory-wiki 是一個隨附的外掛，可將持久知識編譯成可導覽的 Wiki：具決定性的頁面、附帶證據的結構化主張、 來源追溯、儀表板，以及機器可讀摘要。

它不會取代主動記憶外掛。召回、提升、索引與 夢境整理仍由已設定的記憶後端 （memory-core、QMD、Honcho 等）負責。memory-wiki 與其並行運作，將 知識編譯成持續維護的 Wiki 層。

實務原則：

• 使用 memory_search 對所有已設定的語料庫執行一次廣泛召回
• 當你需要 Wiki 專屬排序、來源追溯或頁面層級的信念結構時，使用 wiki_search／wiki_get
• 當主動記憶外掛支援語料庫選擇時，使用 memory_search corpus=all 在一次呼叫中涵蓋兩個層級

常見的本機優先設定：以 QMD 作為負責召回的主動記憶後端，並將 memory-wiki 設為 bridge 模式，以產生持久的綜合頁面。請參閱 設定中的 QMD + 橋接模式範例。

如果橋接模式回報匯出的成品數量為零，表示主動記憶外掛 目前未公開橋接輸入。請先執行 openclaw wiki doctor， 再確認主動記憶外掛支援公開成品。

儲存庫模式

• isolated（預設）：使用自己的儲存庫與來源，不依賴主動記憶外掛。適用於自成一體、經過策展的知識庫。
• bridge：透過公開的外掛 SDK 介面，從主動記憶外掛讀取公開的記憶成品與事件日誌。用於編譯記憶外掛匯出的成品，而不存取外掛的私有內部實作。
• unsafe-local：明確提供的同機逃生通道，可存取本機私有路徑。此模式刻意設計為實驗性且不可移植；僅限於你了解信任邊界，且確實需要橋接模式無法提供的本機檔案系統存取時使用。

儲存庫模式與儲存庫範圍是兩項獨立選擇：

• vaultMode 選擇 Wiki 輸入的來源。
• vault.scope 選擇所有代理程式共用一個儲存庫，或每個代理程式各自使用一個子儲存庫。

vault.scope: "global" 是預設值，並保留既有的單一儲存庫 行為。當代理程式不得共用 Wiki 頁面、編譯摘要、搜尋結果或寫入內容時， 請搭配 isolated 或 bridge 模式使用 vault.scope: "agent"。 代理程式範圍不能與 unsafe-local 模式合併使用，因為這些已設定的 私有路徑並非代理程式擁有的輸入。設定驗證會拒絕此 組合。

橋接模式可依各個 bridge.* 設定開關建立以下內容的索引：

• 匯出的記憶成品（indexMemoryRoot）
• 每日筆記（indexDailyNotes）
• 夢境整理報告（indexDreamReports）
• 記憶事件日誌（followMemoryEvents）

當橋接模式啟用且 bridge.readMemoryArtifacts 已開啟時， openclaw wiki status、openclaw wiki doctor 與 openclaw wiki bridge import 會透過正在執行的閘道路由，因此可看到與代理程式／執行階段記憶 相同的主動記憶外掛情境。如果橋接已停用或成品 讀取已關閉，這些命令會維持本機／離線行為。

儲存庫配置

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

受管理的內容會保留在產生的區塊內；人工筆記區塊會在 重新產生後保留。

• sources/：匯入的原始資料，以及由橋接／unsafe-local 支援的頁面
• entities/：持久存在的事物、人員、系統、專案、物件
• concepts/：想法、抽象概念、模式、政策（也是 OKF 匯入內容的落點）
• syntheses/：編譯後的摘要與持續維護的彙總
• reports/：產生的儀表板

開放知識格式匯入

openclaw wiki okf import ./bundles/ga4

將已解壓縮的開放知識格式套件匯入 Wiki 概念頁面。當資料目錄、文件爬蟲或擴充代理程式已經 產生 OKF 時非常適合：將 OKF 保留為可攜式交換成品，並讓 memory-wiki 將其轉換成 OpenClaw 原生概念頁面與編譯摘要。

• 非保留的 .md 檔案會作為概念文件
• 每個匯入的概念都必須具有非空白的 type frontmatter 欄位；缺少 type 會產生 missing-type 警告，並略過該檔案
• 未知的 type 值會作為通用概念接受
• index.md 與 log.md 為保留檔案，絕不會匯入為概念
• 失效或外部的 Markdown 連結會維持不變

匯入的頁面會平面化置於 concepts/ 下，讓既有的編譯、搜尋、取得與 儀表板流程無須第二棵 Wiki 樹即可存取。每個頁面都會保留 原始 OKF 概念 ID、來源路徑、type、resource、tags、時間戳記， 以及完整的產生者 frontmatter。內部 OKF 連結會改寫為產生的 Wiki 概念頁面，並同時產生具有 kind: okf-link 的結構化 relationships 項目。

結構化主張與證據

頁面具有結構化的 claims frontmatter，而不只是自由格式文字。每個 主張可包含 id、text、status、confidence、evidence[] 與 updatedAt。每個證據項目可包含 kind、sourceId、path、 lines、weight、confidence、privacyTier、note 與 updatedAt。

這使 Wiki 成為信念層，而不是被動的筆記傾印區。 主張可被追蹤、評分、質疑，並追溯至來源加以解決。

面向代理程式的實體中繼資料

實體頁面包含可用於人員、團隊、 系統、專案或任何其他實體類型的通用路由中繼資料：

• entityType：例如 person、team、system、project
• canonicalId：跨別名與匯入項目的穩定身分識別鍵
• aliases：解析至同一頁面的名稱、帳號代稱或標籤
• privacyTier：自由格式字串；public 視為無須審查，任何其他值（例如 local-private、sensitive、confirm-before-use）都會在 reports/privacy-review.md 中標示
• bestUsedFor／notEnoughFor：精簡的路由提示
• lastRefreshedAt：來源重新整理時間戳記，與頁面編輯時間分開
• personCard：選用的人員專屬路由卡片（帳號代稱、社群帳號、電子郵件、時區、工作範疇、適合詢問事項、不宜詢問事項、可信度、隱私層級）
• relationships：連往相關頁面的具型別邊線（目標、類型、權重、可信度、證據類型、隱私層級、備註）

若是人員 Wiki，請先從 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

編譯管線

編譯程序會讀取 Wiki 頁面、正規化摘要，並在以下位置產生穩定的 機器端成品：

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

代理程式與執行階段程式碼會讀取這些摘要，而非抓取 Markdown。 編譯後輸出也支援搜尋／取得的第一階段 Wiki 索引、從主張 ID 查回所屬頁面、精簡的提示詞補充內容，以及報告 產生功能。

儀表板與健康狀態報告

當 render.createDashboards 啟用時，編譯程序會維護 reports/ 下的儀表板：

搜尋與擷取

兩種搜尋後端：

• shared：可用時使用共用記憶搜尋流程
• local：在本機搜尋 Wiki

三種語料庫：wiki、memory、all。

• wiki_search／wiki_get 會盡可能使用編譯摘要作為第一階段
• 主張 ID 會解析回其所屬頁面
• 受質疑／過時／最新的主張會影響排序
• 來源追溯標籤會保留至結果中

搜尋模式（--mode／工具 mode 參數）：

當結果符合結構化主張時，wiki_search 會在其詳細資料承載內容中傳回 matchedClaimId、matchedClaimStatus、matchedClaimConfidence、 evidenceKinds 與 evidenceSourceIds。若相關資訊可用，文字輸出 會包含精簡的 Claim: 與 Evidence: 行。

代理程式工具

此外掛也會註冊非獨占的記憶語料庫補充來源，因此當作用中的記憶 外掛支援選擇語料庫時，共享的 memory_search 和 memory_get 即可存取 wiki。

提示詞與上下文行為

啟用 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，即可讓每個已設定的代理程式擁有獨立的 wiki。 在此範圍中，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 提供的 wiki 補充內容，都會依照作用中代理程式的上下文解析知識庫。 在設定了多個代理程式的環境中進行命令列介面和閘道呼叫時，請使用 openclaw wiki --agent <agentId> ... 或閘道請求的 agentId 明確指定代理程式。若只設定一個代理程式，未提供識別碼時仍會預設使用該代理程式。

在橋接模式下，代理程式範圍的匯入只會接受 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 專注於 編譯頁面和儀表板，並在您刻意啟用編譯摘要提示詞之前， 維持提示詞結構不變。

命令列介面

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

完整命令參考請參閱命令列介面：wiki，其中包括 wiki okf import、wiki apply metadata、wiki unsafe-local import、 wiki chatgpt import／wiki chatgpt rollback，以及完整的 wiki obsidian 子命令集。

Obsidian 支援

當 vault.renderMode 為 obsidian 時，此外掛會寫入適合 Obsidian 的 Markdown，並可選擇使用官方 obsidian 命令列介面來探測狀態、 搜尋知識庫、開啟頁面、叫用命令，以及跳至每日筆記。 此功能為選用；沒有 Obsidian 時，wiki 仍可在原生模式下運作。

代理程式範圍的知識庫仍可使用適合 Obsidian 的 Markdown，但設定 驗證會拒絕同時使用 obsidian.useOfficialCli: true 與 vault.scope: "agent"。 目前的 obsidian.vaultName 設定是全域的，無法為每個代理程式選擇不同的 Obsidian 知識庫。請改用 wiki 工具和命令列介面操作， 或將由 Obsidian 操作的 wiki 維持在全域範圍。

建議工作流程

相關文件

• 記憶概覽
• 命令列介面：記憶
• 命令列介面：wiki
• 外掛 SDK 概覽