メモリ Wiki

memory-wiki は、永続的な知識をナビゲート可能な Wiki にコンパイルする同梱 Plugin です。決定論的なページ、根拠付きの構造化された主張、出典、ダッシュボード、機械可読なダイジェストを提供します。

これは Active Memory Plugin を置き換えるものではありません。想起、昇格、インデックス作成、Dreaming は、設定されているメモリバックエンド（memory-core、QMD、Honcho など）が引き続き担当します。memory-wiki はその隣で動作し、知識を保守可能な Wiki レイヤーにコンパイルします。

実用上の原則：

• 設定済みのすべてのコーパスを対象に、広範な想起を一度行う場合は memory_search
• Wiki 固有のランキング、出典、またはページ単位の信念構造が必要な場合は wiki_search / wiki_get
• Active Memory Plugin がコーパス選択をサポートしている場合、1 回の呼び出しで両方のレイヤーを対象にするには memory_search corpus=all

一般的なローカルファースト構成では、想起用の Active Memory バックエンドとして QMD を使用し、永続的な統合ページ用に memory-wiki を bridge モードで使用します。設定にある QMD + bridge モードの例を参照してください。

bridge モードでエクスポート済みアーティファクトが 0 件と報告される場合、Active Memory Plugin は現在、公開 bridge 入力を公開していません。まず openclaw wiki doctor を実行し、次に Active Memory Plugin が公開アーティファクトをサポートしていることを確認してください。

Vault モード

• isolated（デフォルト）：独自の Vault とソースを持ち、Active Memory Plugin に依存しません。自己完結型のキュレーション済み知識ストアに使用します。
• bridge：公開 Plugin SDK の接続点を通じて、Active Memory Plugin から公開メモリアーティファクトとイベントログを読み取ります。Plugin の非公開内部実装に立ち入らず、Memory Plugin がエクスポートしたアーティファクトをコンパイルする場合に使用します。
• unsafe-local：ローカルの非公開パスにアクセスするための、同一マシン上での明示的なエスケープハッチです。意図的に実験的かつ移植性がありません。信頼境界を理解し、bridge モードでは提供できないローカルファイルシステムへのアクセスが特に必要な場合にのみ使用してください。

Vault モードと Vault スコープは別々に選択します：

• vaultMode は Wiki の入力元を選択します。
• vault.scope は、すべてのエージェントが 1 つの Vault を使用するか、各エージェントが子 Vault を持つかを選択します。

vault.scope: "global" がデフォルトであり、既存の単一 Vault の動作を維持します。エージェント間で Wiki ページ、コンパイル済みダイジェスト、検索結果、または書き込みを共有してはならない場合は、isolated または bridge モードで vault.scope: "agent" を使用してください。設定された非公開パスはエージェント所有の入力ではないため、エージェントスコープを unsafe-local モードと組み合わせることはできません。設定検証ではこの組み合わせが拒否されます。

bridge モードでは、bridge.* の各設定トグルに応じて、以下をインデックス化できます：

• エクスポートされたメモリアーティファクト（indexMemoryRoot）
• 日次ノート（indexDailyNotes）
• Dreaming レポート（indexDreamReports）
• メモリイベントログ（followMemoryEvents）

bridge モードが有効で、bridge.readMemoryArtifacts が有効な場合、openclaw wiki status、openclaw wiki doctor、openclaw wiki bridge import は実行中の Gateway を経由するため、エージェント／ランタイムメモリと同じ Active Memory Plugin のコンテキストを参照します。bridge が無効、またはアーティファクトの読み取りが無効な場合、これらのコマンドはローカル／オフライン動作を維持します。

Vault のレイアウト

<vault>/  AGENTS.md  WIKI.md  index.md  inbox.md  entities/  concepts/  syntheses/  sources/  reports/  _attachments/  _views/  .openclaw-wiki/

管理対象コンテンツは生成ブロック内に保持され、人間が記述したノートブロックは再生成後も維持されます。

• sources/：インポートされた原資料と、bridge／unsafe-local を基盤とするページ
• 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 フロントマター項目が必要です。type がない場合は missing-type 警告が発生し、そのファイルはスキップされます
• 未知の type 値は汎用概念として受け入れられます
• index.md と log.md は予約済みであり、概念としてインポートされることはありません
• 壊れた Markdown リンクや外部 Markdown リンクは変更されません

インポートされたページは concepts/ 配下にフラット化されるため、既存のコンパイル、検索、取得、ダッシュボードの各フローは、2 つ目の Wiki ツリーを用意せずにそれらを参照できます。各ページには、元の OKF 概念 ID、ソースパス、type、resource、tags、タイムスタンプ、および生成元のフロントマター全体が保持されます。内部 OKF リンクは生成された Wiki 概念ページへのリンクに書き換えられ、さらに kind: okf-link を持つ構造化された relationships エントリも生成されます。

構造化された主張と根拠

ページには自由形式のテキストだけでなく、構造化された claims フロントマターが含まれます。各主張には 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: entityentityType: personid: entity.example-personcanonicalId: maintainer.example-personaliases:- Alex- example-handleprivacyTier: local-privatebestUsedFor:- Example ecosystem routingnotEnoughFor:- legal approvallastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:handles:  - "@example-handle"socials:  - "https://x.example/example-handle"emails:  - alex@example.comtimezone: America/Chicagolane: Example ecosystemaskFor:  - Example rollout questionsavoidAskingFor:  - unrelated billing decisionsconfidence: 0.8privacyTier: confirm-before-userelationships:- targetId: entity.other-person  targetTitle: Other Person  kind: collaborates-with  confidence: 0.7  evidenceKind: discrawl-statclaims:- id: claim.example.routing  text: Alex is useful for example-ecosystem routing.  status: supported  confidence: 0.9  evidence:    - kind: maintainer-whois      sourceId: source.maintainers      privacyTier: local-private

コンパイルパイプライン

コンパイルでは Wiki ページを読み取り、要約を正規化し、以下の場所に安定した機械向けアーティファクトを出力します：

• .openclaw-wiki/cache/agent-digest.json
• .openclaw-wiki/cache/claims.jsonl

エージェントとランタイムコードは、Markdown をスクレイピングする代わりにこれらのダイジェストを読み取ります。コンパイル済み出力は、検索／取得用の初回 Wiki インデックス作成、主張 ID から所有ページへの逆引き、簡潔なプロンプト補足、レポート生成にも使用されます。

ダッシュボードと健全性レポート

render.createDashboards が有効な場合、コンパイルによって reports/ 配下のダッシュボードが保守されます：

検索と取得

検索バックエンドは 2 種類あります：

• shared：利用可能な場合は共有メモリ検索フローを使用
• local：Wiki をローカルで検索

コーパスは wiki、memory、all の 3 種類です。

• wiki_search / wiki_get は、可能な場合、コンパイル済みダイジェストを第一段階として使用します
• 主張 ID は、その主張を所有するページに解決されます
• 異議のある主張、古い主張、新しい主張はランキングに影響します
• 出典ラベルは結果にも保持されます

検索モード（--mode / ツールの mode パラメーター）：

結果が構造化された主張に一致すると、wiki_search は詳細ペイロードに matchedClaimId、matchedClaimStatus、matchedClaimConfidence、evidenceKinds、evidenceSourceIds を返します。利用可能な場合、テキスト出力には簡潔な Claim: 行と Evidence: 行が含まれます。

エージェントツール

この Plugin は非排他的なメモリコーパスの補完も登録するため、Active Memory Plugin がコーパス選択をサポートしている場合、共有の memory_search と memory_get から Wiki にアクセスできます。

プロンプトとコンテキストの動作

context.includeCompiledDigestPrompt を有効にすると、メモリプロンプトのセクションに agent-digest.json からのコンパクトなコンパイル済みスナップショットが追加されます。内容は、 上位ページのみ、上位の主張のみ、矛盾数、質問数、信頼度／鮮度の修飾情報です。 これはプロンプトの構造を変更するためオプトインです。主に、メモリ補完を明示的に使用する コンテキストエンジンやプロンプト組み立て処理に関係します。

設定

設定は 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,          },        },      },    },  },}

主要な切り替え設定：

エージェントごとの保管庫

設定済みの各エージェントに個別の Wiki を割り当てるには、vault.scope を agent に設定します。このスコープでは、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 補完は、アクティブな エージェントコンテキストから保管庫を解決します。複数のエージェントが設定された 環境で CLI と Gateway を呼び出す場合は、openclaw wiki --agent <agentId> ... または Gateway リクエストの agentId でエージェントを明示的に指定してください。 設定済みのエージェントが 1 つだけの場合は、ID を指定しなくてもそのエージェントが デフォルトになります。

ブリッジモードでは、エージェントスコープのインポートは、公開メモリアーティファクトの agentIds に選択したエージェントが含まれている場合にのみ受け付けます。 別のエージェントが所有するアーティファクト、所有権メタデータがないアーティファクト、 または所有者が不明なアーティファクトはスキップされます。グローバルスコープでは、 既存の共有アーティファクトの動作が維持されます。

例：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,          },        },      },    },  },}

これにより、Active Memory の検索は QMD が担当し、memory-wiki は コンパイル済みページとダッシュボードに専念します。また、コンパイル済みダイジェストの プロンプトを意図的に有効にするまで、プロンプトの構造は変更されません。

CLI

openclaw wiki statusopenclaw wiki doctoropenclaw wiki initopenclaw wiki ingest ./notes/alpha.mdopenclaw wiki compileopenclaw wiki lintopenclaw wiki search "alpha"openclaw wiki get entity.alphaopenclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alphaopenclaw wiki bridge importopenclaw wiki obsidian status

wiki okf import、wiki apply metadata、wiki unsafe-local import、 wiki chatgpt import／wiki chatgpt rollback、および wiki obsidian サブコマンド一式を含む完全なコマンドリファレンスについては、 CLI：Wikiを参照してください。

Obsidian のサポート

vault.renderMode が obsidian の場合、Plugin は Obsidian 向けの Markdown を書き出し、必要に応じて公式の obsidian CLI を使用して、 状態の確認、保管庫の検索、ページを開く操作、コマンドの実行、デイリーノートへの 移動を行えます。これは任意です。Obsidian がなくても、Wiki はネイティブモードで 引き続き動作します。

エージェントスコープの保管庫でも Obsidian 向け Markdown を使用できますが、 設定の検証では vault.scope: "agent" と obsidian.useOfficialCli: true の 組み合わせが拒否されます。現在の obsidian.vaultName 設定はグローバルであり、 エージェントごとに異なる Obsidian 保管庫を選択することはできません。代わりに Wiki ツールと CLI 操作を使用するか、Obsidian で操作する Wiki をグローバルスコープに 維持してください。

推奨ワークフロー

関連ドキュメント

• メモリの概要
• CLI：メモリ
• CLI：Wiki
• Plugin SDK の概要