CLI commands
ウィキ
openclaw wiki
memory-wiki保管庫を検査・管理します。バンドルされたmemory-wiki Pluginによって提供されます。
関連項目:Memory Wiki Plugin、メモリの概要、CLI:メモリ
よく使うコマンド
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 dailyエージェントの選択
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複数のエージェントが設定された環境では、コマンドが任意のデフォルト保管庫を読み書きできないように、CLI操作に--agentが必須です。設定されたエージェントが1つだけの場合、そのエージェントが引き続きデフォルトになります。不明なエージェントIDは、保管庫操作の開始前にエラーになります。vault.scopeがglobalの場合、このオプションによって選択されたパスは変わりません。
Gatewayクライアントにも同じ規則が適用されます。エージェント単位のマルチエージェント環境では、保管庫を利用するwiki.*リクエストにagentIdを渡します。IDがない場合や不明な場合はエラーになります。エージェントターン、Wikiツール、メモリコーパスの補足、およびコンパイル済みプロンプトダイジェストには、アクティブなランタイムエージェントのコンテキストがすでに含まれています。
コマンド
wiki status
保管庫のモードとスコープ、解決されたエージェント、健全性、およびObsidian CLIの利用可否を表示します。目的の保管庫が初期化されているか、ブリッジモードが正常か、またはObsidian連携が利用可能かを確認するには、最初にこれを使用します。
ブリッジモードが有効で、メモリアーティファクトを読み取るよう設定されている場合、このコマンドは実行中のGatewayに問い合わせるため、エージェントやランタイムのメモリと同じアクティブなメモリPluginコンテキストを参照します。
wiki doctor
Wikiの健全性チェックを実行し、実行可能な修正方法を報告します。異常がある場合はゼロ以外で終了します。
ブリッジモードが有効で、メモリアーティファクトを読み取るよう設定されている場合、このコマンドはレポートを構築する前に実行中のGatewayへ問い合わせます。ブリッジインポートが無効な場合や、メモリアーティファクトを読み取らないブリッジ設定の場合は、ローカル/オフラインのまま動作します。
代表的な問題:
- 公開メモリアーティファクトなしでブリッジモードが有効
- 保管庫レイアウトが無効または存在しない
- Obsidianモードを使用する設定で、外部のObsidian CLIが存在しない
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-wiki/cache/agent-digest.json.openclaw-wiki/cache/claims.jsonl
render.createDashboardsが有効な場合、コンパイルによってレポートページも更新されます。
wiki lint
保管庫を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を使用します。広範な共有想起を1回行う場合、アクティブなメモリPluginが共有検索を公開しているなら、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も公開されます。
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
アクティブなメモリPluginから公開メモリアーティファクトを、ブリッジを利用するソースページへインポートします。bridgeモードでは、最新のエクスポート済みメモリアーティファクトをWiki保管庫に取り込むために使用します。
アクティブなブリッジアーティファクトの読み取りでは、CLIはGateway RPC経由でインポートをルーティングし、ランタイムのメモリPluginコンテキストを使用します。ブリッジインポートが無効な場合、またはアーティファクトの読み取りがオフの場合、コマンドはローカル/オフラインでインポート件数ゼロの動作を維持します。インポート後のインデックス更新は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が記録され、概要に表示されます。
wiki chatgpt rollback <run-id>
以前適用したChatGPTインポートの実行をロールバックし、その実行で作成されたページを削除して、上書きされたページを復元します。その実行がすでにロールバック済みの場合は何も行わず、alreadyRolledBackを報告します。
wiki obsidian ...
Obsidian互換モードで動作する保管庫向けのObsidian補助コマンド:status、search、open、command、daily。obsidian.useOfficialCliが有効な場合、これらを使用するには公式のobsidian CLIがPATHに存在する必要があります。
vault.scopeがagentの場合、設定の検証によってobsidian.useOfficialCli: trueは拒否されます。これは、obsidian.vaultNameがエージェントごとのマッピングではなく、単一のグローバル設定であるためです。Obsidian互換のMarkdownレンダリングは引き続き利用できます。
実践的な使用ガイド
- 来歴とページIDが重要な場合は、
wiki searchとwiki getを使用します。 - 管理対象の生成セクションを手動編集する代わりに、
wiki applyを使用します。 - 矛盾する内容や信頼度の低い内容を信用する前に、
wiki lintを使用します。 - 一括インポートやソース変更の後、最新のダッシュボードとコンパイル済みダイジェストをすぐに必要とする場合は、
wiki compileを使用します。 - データカタログ、ドキュメントのエクスポート、またはエージェント拡充パイプラインがすでに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
完全な設定モデルについては、Memory Wiki Pluginを参照してください。