CLI commands
維基百科
openclaw wiki
檢查並維護 memory-wiki 資料庫。由隨附的選用 memory-wiki 外掛提供。首次使用前請先啟用:
openclaw plugins enable memory-wikiopenclaw gateway restart相關內容:記憶 Wiki 外掛、記憶概覽、命令列介面:memory
常用命令
openclaw wiki statusopenclaw wiki doctoropenclaw wiki initopenclaw wiki ingest ./notes/alpha.mdopenclaw wiki okf import ./knowledge-catalog/okf/bundles/ga4openclaw wiki compileopenclaw wiki lintopenclaw wiki search "alpha"openclaw wiki search "who should I ask about Teams?" --mode route-questionopenclaw wiki get entity.alpha --from 1 --lines 80 openclaw wiki apply synthesis "Alpha Summary" \ --body "Short synthesis body" \ --source-id source.alpha openclaw wiki apply metadata entity.alpha \ --source-id source.alpha \ --status review \ --question "Still active?" openclaw wiki bridge importopenclaw wiki unsafe-local importopenclaw wiki chatgpt import --export ./chatgpt-export --dry-runopenclaw wiki chatgpt rollback <run-id> openclaw wiki obsidian statusopenclaw wiki obsidian search "alpha"openclaw wiki obsidian open syntheses/alpha-summary.mdopenclaw wiki obsidian command workspace:quick-switcheropenclaw wiki obsidian dailyAgent 選擇
當 plugins.entries.memory-wiki.config.vault.scope 為 agent 時,請使用頂層 --agent <id> 選項選取資料庫:
openclaw wiki --agent support statusopenclaw wiki --agent support search "refund policy"openclaw wiki --agent marketing ingest ./campaign-notes.md在設定多個 Agent 的環境中,命令列介面操作必須提供 --agent,以免命令讀取或寫入任意的預設資料庫。若僅設定一個 Agent,該 Agent 仍為預設值。未知的 Agent ID 會在資料庫操作開始前失敗。當 vault.scope 為 global 時,此選項不會變更所選路徑。
閘道用戶端遵循相同規則:在 Agent 範圍的多 Agent 設定中,對以資料庫為基礎的 wiki.* 要求傳入 agentId。缺少或未知的 ID 會導致錯誤。Agent 回合、Wiki 工具、記憶語料庫補充內容,以及編譯後的提示摘要,均已攜帶作用中的執行階段 Agent 情境。
命令
wiki status
顯示資料庫模式與範圍、解析後的 Agent、健康狀態,以及 Obsidian 命令列介面的可用性。請先使用此命令,檢查預期的資料庫是否已初始化、橋接模式是否正常,或 Obsidian 整合是否可用。
當橋接模式處於作用中且設定為讀取記憶成品時,此命令會查詢執行中的閘道,因此能看到與 Agent/執行階段記憶相同的作用中記憶外掛情境。
wiki doctor
執行 Wiki 健康檢查並回報可採取的修正措施。狀態不正常時會以非零狀態結束。
當橋接模式處於作用中且設定為讀取記憶成品時,此命令會先查詢執行中的閘道,再建立報告。停用的橋接匯入,以及未讀取記憶成品的橋接設定,會維持本機/離線運作。
常見問題:
- 已啟用橋接模式,但沒有公開記憶成品
- 資料庫配置無效或遺失
- 預期使用 Obsidian 模式時,缺少外部 Obsidian 命令列介面
wiki init
建立 Wiki 資料庫配置與入門頁面,包括頂層索引與快取目錄。
wiki ingest <path>
將本機 Markdown 或文字檔案匯入 Wiki 的 sources/ 資料夾,作為來源頁面。<path> 必須是本機檔案路徑;目前不支援從 URL 擷取。二進位檔案會遭拒絕。
匯入的來源頁面會帶有來源追溯 frontmatter(sourceType: local-file、sourcePath、ingestedAt)。擷取後一律會重新編譯資料庫。
旗標:--title <title> 會覆寫來源標題(預設值:從檔名衍生)。
wiki okf import <path>
將解壓縮的 Open Knowledge Format 套件匯入 Wiki 概念頁面。
匯入工具會讀取 OKF 目錄樹中每個非保留的 .md 概念文件、要求 type 欄位不得為空,並將未知的 OKF type 值視為一般概念。保留的 OKF index.md 與 log.md 檔案不會匯入為概念。
匯入的頁面會扁平化存放於 concepts/ 下,讓現有的 Wiki 編譯、搜尋、取得、摘要及儀表板流程能立即存取。原始 OKF 概念 ID、type、resource、tags、時間戳記、來源路徑及完整 frontmatter,都會保留在頁面的 frontmatter 中。內部 OKF Markdown 連結會改寫為產生的 Wiki 頁面;失效或外部連結則維持不變。匯入後一律會重新編譯資料庫。
範例:
openclaw wiki okf import ./bundles/ga4openclaw wiki okf import ./bundles/ga4 --jsonopenclaw wiki search "BigQuery Table" --mode source-evidence --jsonopenclaw wiki get <path-from-json-result>wiki compile
重建索引、相關內容區塊、儀表板,以及編譯後的查詢/提示快照。快照會保存於 OpenClaw 的共用 SQLite 外掛狀態,並保留在記憶體中以同步投射提示;它不會在資料庫中建立快取檔案。
若已啟用 render.createDashboards,編譯也會重新整理報告頁面。
wiki lint
檢查資料庫並寫入涵蓋下列項目的報告:
- 結構問題(失效連結、遺失/重複 ID、缺少頁面類型或標題、無效 frontmatter)
- 來源追溯缺口(缺少來源 ID、缺少匯入來源資訊)
- 矛盾(標記的矛盾、互相衝突的主張)
- 未解問題
- 低信心頁面與主張
- 過時頁面與主張
完成重要的 Wiki 更新後,請執行此命令。
wiki search <query>
搜尋 Wiki 內容。行為取決於設定:
search.backend:shared或localsearch.corpus:wiki、memory或all--mode:auto、find-person、route-question、source-evidence或raw-claim
需要 Wiki 專用的排序與來源追溯時,請使用 wiki search。若要執行一次廣泛的共用回憶查詢,當作用中的記憶外掛公開共用搜尋時,請優先使用 openclaw memory search。
搜尋模式:
find-person:別名、帳號名稱、社群帳號、標準 ID 及人物頁面route-question:詢問對象/最適用途提示及關係情境source-evidence:來源頁面與結構化證據欄位raw-claim:含主張/證據中繼資料的結構化主張文字
範例:
openclaw wiki search "bgroux" --mode find-personopenclaw wiki search "who knows Teams rollout?" --mode route-questionopenclaw wiki search "maintainer-whois" --mode source-evidenceopenclaw wiki search "strong route Teams" --mode raw-claim --json當結果符合結構化主張時,文字輸出會包含 Claim: 與 Evidence: 行。JSON 輸出另會公開 matchedClaimId、matchedClaimStatus、matchedClaimConfidence、evidenceKinds 及 evidenceSourceIds,供 Agent 端深入探索。
wiki get <lookup>
依 ID 或相對路徑讀取 Wiki 頁面。
openclaw wiki get entity.alphaopenclaw wiki get syntheses/alpha-summary.md --from 1 --lines 80wiki apply
套用範圍明確的變更,無須任意修改頁面:
apply synthesis <title>:以受管理的摘要內文建立或重新整理綜合頁面apply metadata <lookup>:更新現有頁面的中繼資料
兩者皆接受 --source-id、--contradiction、--question(各自可重複指定)、--confidence <n>(0-1)及 --status <status>。apply metadata 也接受 --clear-confidence,以移除已儲存的信心值。這是演進 Wiki 頁面的支援方式,可確保受管理的產生區塊保持完整。
wiki bridge import
將作用中記憶外掛的公開記憶成品匯入橋接後端的來源頁面。請在 bridge 模式中使用此命令,將最新匯出的記憶成品提取至 Wiki 資料庫。
讀取作用中的橋接成品時,命令列介面會透過閘道 RPC 路由匯入,因此會使用執行階段記憶外掛情境。若已停用橋接匯入或成品讀取,命令會維持本機/離線的零匯入行為。匯入後是否重新整理索引由 ingest.autoCompile 控制。
wiki unsafe-local import
在 unsafe-local 模式中,從明確設定的本機路徑(unsafeLocal.paths)匯入。此功能刻意設為實驗性質,且僅限同一台電腦。匯入後是否重新整理索引由 ingest.autoCompile 控制。
wiki chatgpt import
將 ChatGPT 匯出內容匯入為 Wiki 來源頁面草稿。
openclaw wiki chatgpt import --export ./chatgpt-exportopenclaw wiki chatgpt import --export ./conversations.json --dry-run| 旗標 | 預設值 | 說明 |
|---|---|---|
--export <path> |
(必填) | ChatGPT 匯出目錄或 conversations.json 路徑。 |
--dry-run |
false |
在不寫入頁面的情況下預覽建立/更新/略過的數量。 |
非試執行的匯入只要變更任何頁面,就會記錄匯入執行 ID 並顯示於摘要中;回復操作需要此 ID。
wiki chatgpt rollback <run-id>
回復先前套用的 ChatGPT 匯入執行,移除其建立的頁面,並還原其覆寫的頁面。若該執行已經回復,則不執行任何操作(並回報 alreadyRolledBack)。
wiki obsidian ...
適用於以 Obsidian 友善模式運作之資料庫的 Obsidian 輔助命令:status、search、open、command、daily。啟用 obsidian.useOfficialCli 時,這些命令需要 PATH 上的官方 obsidian 命令列介面。
當 vault.scope 為 agent 時,設定驗證會拒絕 obsidian.useOfficialCli: true,因為 obsidian.vaultName 是一項全域設定,而非各 Agent 的對應設定。仍可使用 Obsidian 友善的 Markdown 呈現方式。
實務使用指南
- 當來源追溯與頁面身分很重要時,請使用
wiki search+wiki get。 - 請使用
wiki apply,而非手動編輯受管理的產生區段。 - 在信任互相矛盾或低信心的內容之前,請使用
wiki lint。 - 批次匯入或變更來源後,若要立即取得最新的儀表板與編譯摘要,請使用
wiki compile。 - 當資料目錄、文件匯出或 Agent 強化流水線已產生 OKF Markdown 套件時,請使用
wiki okf import。 - 當橋接模式仰賴新匯出的記憶成品時,請使用
wiki bridge import。
設定關聯
openclaw wiki 的行為受下列項目影響:
plugins.entries.memory-wiki.config.vaultModeplugins.entries.memory-wiki.config.vault.scopeplugins.entries.memory-wiki.config.vault.pathplugins.entries.memory-wiki.config.search.backendplugins.entries.memory-wiki.config.search.corpusplugins.entries.memory-wiki.config.bridge.*plugins.entries.memory-wiki.config.obsidian.*plugins.entries.memory-wiki.config.ingest.autoCompileplugins.entries.memory-wiki.config.render.*plugins.entries.memory-wiki.config.context.includeCompiledDigestPrompt
完整設定模型請參閱記憶 Wiki 外掛。