memory-wiki は、永続的な知識をナビゲート可能な wiki にコンパイルするバンドル済みプラグインです。決定的なページ、エビデンス付きの構造化クレーム、来歴、ダッシュボード、機械可読ダイジェストを生成します。
これはアクティブメモリプラグインを置き換えるものではありません。リコール、昇格、インデックス作成、dreaming は、設定されているメモリバックエンド(memory-core、QMD、Honcho など)が引き続き所有します。memory-wiki はその横に配置され、知識を保守された wiki レイヤーにコンパイルします。
| レイヤー | 所有するもの |
|---|---|
| Active memory plugin | リコール、セマンティック検索、昇格、dreaming、メモリランタイム |
memory-wiki | コンパイル済み wiki ページ、来歴豊富な統合、ダッシュボード、wiki search/get/apply |
- 設定済みのコーパス全体に対する幅広いリコールを 1 回行うには
memory_search - wiki 固有のランキング、来歴、またはページ単位の信念構造が必要な場合は
wiki_search/wiki_get - アクティブメモリプラグインがコーパス選択をサポートしている場合、1 回の呼び出しで両方のレイヤーをまたぐには
memory_search corpus=all
memory-wiki を bridge モードで使います。Configuration の QMD + bridge モードの例を参照してください。
bridge モードでエクスポートされたアーティファクトが 0 件と報告される場合、アクティブメモリプラグインは現在パブリック bridge 入力を公開していません。まず openclaw wiki doctor を実行し、その後アクティブメモリプラグインがパブリックアーティファクトをサポートしていることを確認してください。
Vault モード
isolated(デフォルト): 独自の vault、独自のソースを持ち、アクティブメモリプラグインに依存しません。自己完結したキュレーション済み知識ストアに使用します。bridge: パブリック Plugin SDK の継ぎ目を通じて、アクティブメモリプラグインからパブリックメモリアーティファクトとイベントログを読み取ります。プライベートなプラグイン内部に踏み込まず、メモリプラグインがエクスポートしたアーティファクトをコンパイルするために使用します。unsafe-local: ローカルのプライベートパス向けに、明示的な同一マシンの脱出口を提供します。意図的に実験的で移植性はありません。信頼境界を理解しており、bridge モードでは提供できないローカルファイルシステムアクセスが特に必要な場合にのみ使用してください。
bridge.* 設定トグルごとに次をインデックスできます。
- エクスポートされたメモリアーティファクト(
indexMemoryRoot) - デイリーノート(
indexDailyNotes) - dream レポート(
indexDreamReports) - メモリイベントログ(
followMemoryEvents)
bridge.readMemoryArtifacts が有効な場合、openclaw wiki status、openclaw wiki doctor、openclaw wiki bridge import は実行中の Gateway 経由でルーティングされるため、エージェント/ランタイムメモリと同じアクティブメモリプラグインコンテキストを参照します。bridge が無効、またはアーティファクト読み取りがオフの場合、これらのコマンドはローカル/オフラインの動作を維持します。
Vault レイアウト
sources/: インポートされた生素材と bridge/unsafe-local に裏付けられたページentities/: 永続的なもの、人、システム、プロジェクト、オブジェクトconcepts/: アイデア、抽象、パターン、ポリシー(OKF インポートの配置先でもあります)syntheses/: コンパイル済みサマリーと保守されるロールアップreports/: 生成されたダッシュボード
Open Knowledge Format インポート
memory-wiki に OpenClaw ネイティブなコンセプトページとコンパイル済みダイジェストへ変換させます。
- 予約されていない
.mdファイルはコンセプトドキュメントです - インポートされる各コンセプトには、空でない
typefrontmatter フィールドが必要です。typeがない場合はmissing-type警告が生成され、そのファイルはスキップされます - 未知の
type値は汎用コンセプトとして受け入れられます index.mdとlog.mdは予約済みであり、コンセプトとしてインポートされることはありません- 壊れた Markdown リンクまたは外部 Markdown リンクは変更されません
concepts/ の下にフラット化されるため、既存の compile、search、get、dashboard フローは 2 つ目の 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、projectcanonicalId: エイリアスやインポートをまたぐ安定した ID キーaliases: 同じページに解決される名前、ハンドル、またはラベルprivacyTier: 自由形式の文字列。publicはレビュー不要として扱われ、それ以外の値(例:local-private、sensitive、confirm-before-use)はreports/privacy-review.mdでフラグ付けされますbestUsedFor/notEnoughFor: コンパクトなルーティングヒントlastRefreshedAt: ページ編集時刻とは別のソース更新タイムスタンプpersonCard: 任意の人物固有ルーティングカード(ハンドル、ソーシャル、メール、タイムゾーン、レーン、依頼対象、依頼を避ける対象、信頼度、プライバシー階層)relationships: 関連ページへの型付きエッジ(ターゲット、種類、重み、信頼度、エビデンス種別、プライバシー階層、ノート)
reports/person-agent-directory.md から始め、その後連絡先詳細や推定された事実を使う前に wiki_get で人物ページを開いてください。
コンパイルパイプライン
compile は wiki ページを読み取り、サマリーを正規化し、安定した機械向けアーティファクトを次の場所に出力します。.openclaw-wiki/cache/agent-digest.json.openclaw-wiki/cache/claims.jsonl
ダッシュボードとヘルスレポート
render.createDashboards が有効な場合、compile は 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 | 使用前にレビューが必要な非パブリックなプライバシー階層 |
検索と取得
2 つの検索バックエンド:shared: 利用可能な場合は共有メモリ検索フローを使用local: wiki をローカルで検索
wiki、memory、all。
wiki_search/wiki_getは、可能な場合はコンパイル済みダイジェストを初回パスとして使用します- クレーム ID は所有ページへ逆引きされます
- 異議あり/古い/新鮮なクレームはランキングに影響します
- 来歴ラベルは結果に引き継がれます
--mode / ツールの mode パラメーター):
| モード | ブースト対象 |
|---|---|
auto | バランスの取れたデフォルト |
find-person | 人物らしいエンティティ、エイリアス、ハンドル、ソーシャル、canonical ID |
route-question | エージェントカード、ask-for/best-used-for ヒント、関係コンテキスト |
source-evidence | ソースページと構造化エビデンスメタデータ |
raw-claim | 一致する構造化クレーム。クレーム/エビデンスメタデータを返します |
wiki_search は詳細ペイロードで matchedClaimId、matchedClaimStatus、matchedClaimConfidence、evidenceKinds、evidenceSourceIds を返します。利用可能な場合、テキスト出力にはコンパクトな Claim: 行と Evidence: 行が含まれます。
エージェントツール
| ツール | 目的 |
|---|---|
wiki_status | 現在の vault モード、ヘルス、Obsidian CLI の可用性 |
wiki_search | wiki ページと、設定されている場合は共有メモリコーパスを検索します。人物検索、質問ルーティング、ソースエビデンス、または raw claim ドリルダウン用に mode を受け取ります |
wiki_get | id/path で wiki ページを読み取ります。共有検索が有効で検索が失敗した場合は、共有メモリコーパスにフォールバックします |
wiki_apply | 自由形式のページ手術を行わず、狭い範囲の統合/メタデータ変更を行います |
wiki_lint | 構造チェック、来歴の不足、矛盾、未解決の質問 |
memory_search と memory_get は wiki に到達できます。
プロンプトとコンテキストの動作
context.includeCompiledDigestPrompt が有効な場合、メモリプロンプトセクションは
agent-digest.json からコンパクトなコンパイル済みスナップショットを追加します。上位ページのみ、
上位クレームのみ、矛盾数、質問数、信頼度/鮮度の
修飾子です。これはプロンプト形状を変えるためオプトインです。主に、メモリ
補足を明示的に消費するコンテキストエンジンやプロンプト組み立てで重要になります。
設定
設定はplugins.entries.memory-wiki.config の下に置きます。
| キー | 値 / デフォルト | 注記 |
|---|---|---|
vaultMode | isolated (デフォルト), bridge, unsafe-local | |
vault.path | デフォルト ~/.openclaw/wiki/main | |
vault.renderMode | native (デフォルト), obsidian | |
bridge.readMemoryArtifacts | デフォルト true | アクティブメモリPluginの公開アーティファクトをインポート |
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 | ダッシュボードページを生成 |
例: QMD + ブリッジモード
リコールには QMD を使い、管理されたナレッジレイヤーにはmemory-wiki を使いたい場合に使用します。
各レイヤーは焦点を保ちます。QMD は生のメモ、セッション
エクスポート、追加コレクションを検索可能にし、memory-wiki は
安定したエンティティ、クレーム、ダッシュボード、ソースページをコンパイルします。
memory-wiki は
コンパイル済みページとダッシュボードに集中し、コンパイル済みダイジェストプロンプトを
意図的に有効にするまでプロンプト形状は変わりません。
CLI
wiki okf import、wiki apply metadata、wiki unsafe-local import、
wiki chatgpt import / wiki chatgpt rollback、および完全な wiki obsidian
サブコマンドセットが含まれます。
Obsidian サポート
vault.renderMode が obsidian の場合、Plugin は Obsidian に適した
Markdown を書き出し、必要に応じて公式の obsidian CLI を使用してステータス
調査、保管庫検索、ページを開く操作、コマンド呼び出し、日次ノートへのジャンプを
実行できます。これは任意です。wiki は Obsidian なしでもネイティブモードで動作します。