記憶 Wiki

memory-wiki 是一個隨附的外掛，可將持久知識編譯成可導覽的 wiki：具決定性的頁面、附有證據的結構化主張、來源資訊、儀表板，以及機器可讀的摘要。它不會取代主動記憶外掛。回憶、提升、索引和夢境整理仍由已設定的記憶後端（memory-core、QMD、Honcho 等）負責。memory-wiki 與其並存，並將知識編譯成受維護的 wiki 層。使用此外掛的命令列介面、工具或執行階段整合之前，請先啟用它：

openclaw plugins enable memory-wiki
openclaw gateway restart

層	負責
主動記憶外掛	回憶、語意搜尋、提升、夢境整理、記憶體執行階段
`memory-wiki`	已編譯的 wiki 頁面、富含來源資訊的綜整內容、儀表板、wiki 搜尋／取得／套用

實用原則：

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: entity
entityType: person
id: entity.example-person
canonicalId: maintainer.example-person
aliases:
  - Alex
  - example-handle
privacyTier: local-private
bestUsedFor:
  - 範例生態系路由
notEnoughFor:
  - 法律核准
lastRefreshedAt: "2026-04-29T00:00:00.000Z"
personCard:
  handles:
    - "@example-handle"
  socials:
    - "https://x.example/example-handle"
  emails:
    - alex@example.com
  timezone: America/Chicago
  lane: 範例生態系
  askFor:
    - 範例發布問題
  avoidAskingFor:
    - 不相關的帳務決策
  confidence: 0.8
  privacyTier: confirm-before-use
relationships:
  - targetId: entity.other-person
    targetTitle: 其他人員
    kind: collaborates-with
    confidence: 0.7
    evidenceKind: discrawl-stat
claims:
  - 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/ 下方的儀表板：

報告	追蹤項目
`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`	使用前需要審查的非公開隱私層級

搜尋與擷取

兩種搜尋後端：

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

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

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

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

模式	加強項目
`auto`	平衡的預設值
`find-person`	類人物實體、別名、使用者代號、社群帳號、標準 ID
`route-question`	代理程式卡片、適合詢問／最適合用途提示、關係情境
`source-evidence`	來源頁面與結構化證據中繼資料
`raw-claim`	比對結構化宣告；傳回宣告／證據中繼資料

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

代理程式工具

工具	用途
`wiki_status`	目前的知識庫模式與範圍、已解析的代理程式、健康狀態、Obsidian 命令列介面可用性
`wiki_search`	搜尋 wiki 頁面，並在設定後搜尋共用記憶語料庫；接受 `mode`，用於人物查詢、問題路由、來源證據或原始宣告深入檢視
`wiki_get`	依 ID／路徑讀取 wiki 頁面；啟用共用搜尋且查詢未命中時，改由共用記憶語料庫查詢
`wiki_apply`	進行有限的綜整／中繼資料變更，不任意修改頁面內容
`wiki_lint`	結構檢查、出處缺口、矛盾、待解問題

此外掛也會註冊非獨佔的記憶語料庫補充來源，因此當使用中的記憶外掛支援語料庫選擇時，共用的 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,
          },
        },
      },
    },
  },
}

主要切換選項：

鍵	值／預設值	備註
`vaultMode`	`isolated`（預設）、`bridge`、`unsafe-local`	選擇輸入與整合行為
`vault.scope`	`global`（預設）、`agent`	使用一個共用知識庫，或讓每個代理程式各有一個子知識庫
`vault.path`	全域預設值 `~/.openclaw/wiki/main`	全域範圍中的確切知識庫；代理程式範圍的父目錄預設為 `~/.openclaw/wiki`
`vault.renderMode`	`native`（預設）、`obsidian`
`bridge.readMemoryArtifacts`	預設值 `true`	匯入使用中記憶外掛的公開成品
`bridge.followMemoryEvents`	預設值 `true`	在橋接模式中包含事件記錄
`unsafeLocal.allowPrivateMemoryCoreAccess`	預設值 `false`	執行 `unsafe-local` 匯入時為必要設定
`unsafeLocal.paths`	預設值 `[]`	在 `unsafe-local` 模式中要匯入的明確本機路徑
`search.backend`	`shared`（預設）、`local`
`search.corpus`	`wiki`（預設）、`memory`、`all`
`context.includeCompiledDigestPrompt`	預設值 `false`	將所選代理程式的精簡摘要快照附加至記憶提示詞區段
`render.createBacklinks`	預設值 `true`	產生具決定性的相關內容區塊
`render.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 包含所選代理程式時，代理程式範圍的匯入才會接受該成品。屬於其他代理程式、不含擁有權中繼資料或擁有者不明的成品都會略過。全域範圍會維持現有的共用成品行為。

變更 vault.scope 不會複製或拆分現有知識庫。在代理程式範圍中，明確設定的 vault.path 會成為父目錄，因此在切換正式環境中的代理程式之前，請審慎地移動或匯入現有頁面。請先備份知識庫。每個代理程式各自的知識庫是同一處理程序中的知識邊界，而不是作業系統層級的安全邊界。可存取主機檔案系統的外掛與未受沙箱限制的工具，仍然可以讀取其他代理程式的目錄。當代理程式彼此不信任時，請使用沙箱或獨立的閘道設定檔。

範例：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 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

請參閱命令列介面：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 保持在全域範圍中。

建議工作流程

保留主動記憶外掛以供回想

回想、提升與夢境整理仍由設定的記憶體後端負責。

啟用 memory-wiki

除非你明確要使用橋接模式，否則請從 isolated 模式開始。

在出處資訊很重要時使用 wiki_search / wiki_get

需要 Wiki 專屬的排序或頁面層級信念結構時，優先使用這些工具，而非 memory_search。

使用 wiki_apply 進行範圍明確的綜合整理或中繼資料更新

避免手動編輯受管理的已產生區塊。

在進行重要變更後執行 wiki_lint

可找出矛盾、未解問題與出處資訊缺漏。

開啟儀表板，以查看過時內容與矛盾

設定 render.createDashboards: true（預設值）。

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

知識庫模式

知識庫配置

Open Knowledge Format 匯入

結構化主張與證據

代理可用的實體中繼資料

編譯流水線

儀表板與健康狀態報告

搜尋與擷取

代理程式工具

提示詞與情境行為

設定

每個代理程式各自的知識庫

範例：QMD + 橋接模式

命令列介面

Obsidian 支援

建議工作流程

相關文件

​知識庫模式

​知識庫配置

​Open Knowledge Format 匯入

​結構化主張與證據

​代理可用的實體中繼資料

​編譯流水線

​儀表板與健康狀態報告

​搜尋與擷取

​代理程式工具

​提示詞與情境行為

​設定

​每個代理程式各自的知識庫

​範例：QMD + 橋接模式

​命令列介面

​Obsidian 支援

​建議工作流程

​相關文件

知識庫模式

知識庫配置

Open Knowledge Format 匯入

結構化主張與證據

代理可用的實體中繼資料

編譯流水線

儀表板與健康狀態報告

搜尋與擷取

代理程式工具

提示詞與情境行為

設定

每個代理程式各自的知識庫

範例：QMD + 橋接模式

命令列介面

Obsidian 支援

建議工作流程

相關文件