記憶 Wiki

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

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

使用此外掛的命令列介面、工具或執行階段整合之前，請先啟用它：

openclaw plugins enable memory-wikiopenclaw gateway restart

實用原則：

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

常見的本機優先設定：使用 QMD 作為負責回憶的主動記憶後端，並以 bridge 模式使用 memory-wiki 來保存持久的綜整頁面。請參閱 設定下方的 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/：匯入的原始素材，以及由橋接／不安全本機來源支援的頁面
• entities/：持久存在的事物、人員、系統、專案、物件
• concepts/：想法、抽象概念、模式、政策（也是 OKF 匯入內容的放置位置）
• syntheses/：已編譯的摘要和持續維護的彙整內容
• reports/：產生的儀表板

Open Knowledge Format 匯入

openclaw wiki okf import ./bundles/ga4

將已解壓縮的 Open Knowledge Format 套件匯入 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:- 範例生態系路由notEnoughFor:- 法律核准lastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:handles:  - "@example-handle"socials:  - "https://x.example/example-handle"emails:  - alex@example.comtimezone: America/Chicagolane: 範例生態系askFor:  - 範例發布問題avoidAskingFor:  - 不相關的帳務決策confidence: 0.8privacyTier: confirm-before-userelationships:- targetId: entity.other-person  targetTitle: 其他人員  kind: collaborates-with  confidence: 0.7  evidenceKind: discrawl-statclaims:- id: claim.example.routing  text: Alex 適合協助範例生態系的路由。  status: supported  confidence: 0.9  evidence:    - kind: maintainer-whois      sourceId: source.maintainers      privacyTier: local-private

編譯流水線

編譯會讀取 wiki 頁面、正規化摘要，並將機器使用的 快照保存至 OpenClaw 的共用 SQLite 外掛狀態。執行階段程式碼會使用 生命週期擁有者管理的快照，在非同步提示詞準備期間載入 SQLite； 同步提示詞組裝絕不會抓取 Markdown 或讀取快取檔案。 已編譯的輸出也支援搜尋／取得的第一階段 wiki 索引、依主張 ID 反查其所屬頁面、精簡提示詞補充內容，以及報告 產生作業。

來源編輯和知識庫還原只有在下一次 編譯後才會對機器可見。重新啟動或重新整理外掛生命週期時，會比較知識庫中 具有因果鏈的編譯發布與 SQLite，並拒絕來自更新且已回復狀態的快照。 在回復之前啟動的編譯器無法針對已還原的前置狀態 發布。提示詞準備不會輪詢知識庫，也不會安裝檔案監看器。 進入回復隔離狀態後，在執行中程序內進行編譯會立即清除擁有者； 獨立的編譯器程序則需要重新整理外掛生命週期，讓 常駐程式能確認新的持久發布。 已編譯的快取可重新建置：發布時期之前的快取資料列會 視為未命中，並由下一次編譯取代；它們不會被遷移。

儀表板與健康狀態報告

啟用 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 時，記憶提示詞區段 會附加從外掛狀態編譯而成的精簡快照：僅限最重要的頁面、 最重要的宣告、矛盾數量、問題數量、信賴度／新鮮度 限定資訊。由於這會改變提示詞形態，因此必須選擇加入；主要適用於 明確使用記憶補充內容的情境引擎或提示詞組裝流程。

設定

將設定放在 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 會附加 正規化後的代理程式 ID：

{  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 明確指定代理程式。若只設定一個代理程式，未提供 ID 時仍會預設使用該代理程式。

在橋接模式中，只有當公開記憶成品的 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 概觀