> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # 記憶 Wiki `memory-wiki` 是一個隨附的外掛，可將持久知識編譯成 可導覽的 wiki：具決定性的頁面、附有證據的結構化主張、 來源資訊、儀表板，以及機器可讀的摘要。 它不會取代主動記憶外掛。回憶、提升、索引和 夢境整理仍由已設定的記憶後端 （`memory-core`、QMD、Honcho 等）負責。`memory-wiki` 與其並存，並將 知識編譯成受維護的 wiki 層。 使用此外掛的命令列介面、工具或執行階段整合之前，請先啟用它： ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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` 來保存持久的綜整頁面。請參閱 [設定](#configuration)下方的 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` 會透過執行中的閘道路由，因此能看到與代理／執行階段記憶相同的主動記憶 外掛內容。如果橋接已停用或成品讀取已關閉，這些命令會維持 本機／離線行為。 ## 知識庫配置 ```text theme={"theme":{"light":"min-light","dark":"min-dark"}} / 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 匯入 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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` 開啟人員頁面，再使用聯絡資料或推論出的 事實。 ```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}} 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` 之下： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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` 明確指定代理程式。若只設定一個代理程式，未提供 ID 時仍會預設使用該代理程式。 在橋接模式中，只有當公開記憶成品的 `agentIds` 包含所選代理程式時，代理程式範圍的匯入才會接受該成品。屬於其他代理程式、 不含擁有權中繼資料或擁有者不明的成品都會略過。全域範圍 會維持現有的共用成品行為。 變更 `vault.scope` 不會複製或拆分現有知識庫。在代理程式範圍中， 明確設定的 `vault.path` 會成為父目錄，因此在切換正式環境中的代理程式之前，請審慎地 移動或匯入現有頁面。請先備份 知識庫。 每個代理程式各自的知識庫是同一處理程序中的知識邊界，而不是作業系統層級的 安全邊界。可存取主機檔案系統的外掛與未受沙箱限制的工具， 仍然可以讀取其他代理程式的目錄。當代理程式彼此不信任時，請使用[沙箱](/zh-TW/gateway/sandboxing)或 [獨立的閘道設定檔](/zh-TW/gateway/multiple-gateways)。 ### 範例：QMD + 橋接模式 如果你想使用 QMD 進行回想，並以 `memory-wiki` 維護 知識層，請使用此設定。每一層都會專注於各自用途：QMD 讓原始筆記、工作階段 匯出內容及額外集合保持可搜尋，而 `memory-wiki` 則會編譯 穩定實體、宣告、儀表板與來源頁面。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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` 專注於 已編譯頁面與儀表板，並維持提示詞形態不變，直到你 刻意啟用已編譯的摘要提示詞。 ## 命令列介面 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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](/zh-TW/cli/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 保持在全域範圍中。 ## 建議工作流程 回想、提升與夢境整理仍由設定的記憶體後端負責。 除非你明確要使用橋接模式，否則請從 `isolated` 模式開始。 需要 Wiki 專屬的排序或頁面層級信念結構時，優先使用這些工具，而非 `memory_search`。 避免手動編輯受管理的已產生區塊。 可找出矛盾、未解問題與出處資訊缺漏。 設定 `render.createDashboards: true`（預設值）。 ## 相關文件 * [記憶體概觀](/zh-TW/concepts/memory) * [命令列介面：記憶體](/zh-TW/cli/memory) * [命令列介面：Wiki](/zh-TW/cli/wiki) * [外掛 SDK 概觀](/zh-TW/plugins/sdk-overview)