メモリ Wiki

memory-wiki は、永続的な知識をナビゲート可能な wiki にコンパイルするバンドル済みプラグインです。決定的なページ、エビデンス付きの構造化クレーム、来歴、ダッシュボード、機械可読ダイジェストを生成します。

これはアクティブメモリプラグインを置き換えるものではありません。リコール、昇格、インデックス作成、dreaming は、設定されているメモリバックエンド（memory-core、QMD、Honcho など）が引き続き所有します。memory-wiki はその横に配置され、知識を保守された wiki レイヤーにコンパイルします。

実用上のルール:

• 設定済みのコーパス全体に対する幅広いリコールを 1 回行うには memory_search
• wiki 固有のランキング、来歴、またはページ単位の信念構造が必要な場合は wiki_search / wiki_get
• アクティブメモリプラグインがコーパス選択をサポートしている場合、1 回の呼び出しで両方のレイヤーをまたぐには memory_search corpus=all

一般的なローカルファースト構成: リコール用のアクティブメモリバックエンドとして QMD を使い、永続的に統合されたページ用に memory-wiki を bridge モードで使います。Configuration の QMD + bridge モードの例を参照してください。

bridge モードでエクスポートされたアーティファクトが 0 件と報告される場合、アクティブメモリプラグインは現在パブリック bridge 入力を公開していません。まず openclaw wiki doctor を実行し、その後アクティブメモリプラグインがパブリックアーティファクトをサポートしていることを確認してください。

Vault モード

• isolated（デフォルト）: 独自の vault、独自のソースを持ち、アクティブメモリプラグインに依存しません。自己完結したキュレーション済み知識ストアに使用します。
• bridge: パブリック Plugin SDK の継ぎ目を通じて、アクティブメモリプラグインからパブリックメモリアーティファクトとイベントログを読み取ります。プライベートなプラグイン内部に踏み込まず、メモリプラグインがエクスポートしたアーティファクトをコンパイルするために使用します。
• unsafe-local: ローカルのプライベートパス向けに、明示的な同一マシンの脱出口を提供します。意図的に実験的で移植性はありません。信頼境界を理解しており、bridge モードでは提供できないローカルファイルシステムアクセスが特に必要な場合にのみ使用してください。

bridge モードは、bridge.* 設定トグルごとに次をインデックスできます。

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

bridge モードが有効で bridge.readMemoryArtifacts が有効な場合、openclaw wiki status、openclaw wiki doctor、openclaw wiki bridge import は実行中の Gateway 経由でルーティングされるため、エージェント/ランタイムメモリと同じアクティブメモリプラグインコンテキストを参照します。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 frontmatter フィールドが必要です。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、project
• canonicalId: エイリアスやインポートをまたぐ安定した ID キー
• 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

コンパイルパイプライン

compile は wiki ページを読み取り、サマリーを正規化し、安定した機械向けアーティファクトを次の場所に出力します。

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

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

ダッシュボードとヘルスレポート

render.createDashboards が有効な場合、compile は reports/ の下でダッシュボードを保守します。

検索と取得

2 つの検索バックエンド:

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

3 つのコーパス: wiki、memory、all。

• wiki_search / wiki_get は、可能な場合はコンパイル済みダイジェストを初回パスとして使用します
• クレーム ID は所有ページへ逆引きされます
• 異議あり/古い/新鮮なクレームはランキングに影響します
• 来歴ラベルは結果に引き継がれます

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

結果が構造化クレームに一致する場合、wiki_search は詳細ペイロードで matchedClaimId、matchedClaimStatus、matchedClaimConfidence、evidenceKinds、evidenceSourceIds を返します。利用可能な場合、テキスト出力にはコンパクトな Claim: 行と Evidence: 行が含まれます。

エージェントツール

このプラグインは非排他的なメモリコーパス補足も登録するため、アクティブメモリプラグインがコーパス選択をサポートしている場合、共有 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: {            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,          },        },      },    },  },}

主なトグル:

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

これにより、QMD は Active Memory リコールを担い、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

完全なコマンドリファレンスについては CLI: wiki を参照してください。 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 なしでもネイティブモードで動作します。

推奨ワークフロー

関連ドキュメント

• メモリ概要
• CLI: memory
• CLI: wiki
• Plugin SDK 概要