English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Bundled plugin guides

メモリウィキ

Edit source

memory-wiki は、永続メモリをコンパイル済みの知識 vault に変換する同梱プラグインです。

これは Active Memory プラグインを置き換えるものではありません。Active Memory プラグインは引き続き、リコール、昇格、インデックス作成、Dreaming を担います。memory-wiki はその横に位置し、永続的な知識を、決定論的なページ、構造化された主張、出典、ダッシュボード、機械可読のダイジェストを備えたナビゲーション可能な wiki にコンパイルします。

メモリを Markdown ファイルの山ではなく、保守された知識レイヤーのように扱いたい場合に使用します。

追加されるもの

  • 決定論的なページレイアウトを持つ専用の wiki vault
  • 単なる散文ではない、構造化された主張と証拠メタデータ
  • ページ単位の出典、信頼度、矛盾、未解決の質問
  • エージェント/ランタイム利用者向けのコンパイル済みダイジェスト
  • wiki ネイティブの search/get/apply/lint ツール
  • Active Memory プラグインから公開アーティファクトをインポートする任意のブリッジモード
  • Obsidian に適した任意のレンダリングモードと CLI 連携

メモリとの関係

分担は次のように考えてください。

レイヤー 担うもの
Active Memory プラグイン (memory-core, QMD, Honcho など) リコール、セマンティック検索、昇格、Dreaming、メモリランタイム
memory-wiki コンパイル済み wiki ページ、出典が豊富な統合結果、ダッシュボード、wiki 固有の search/get/apply

Active Memory プラグインが共有リコールアーティファクトを公開している場合、OpenClaw は memory_search corpus=all で両方のレイヤーを一度に検索できます。

wiki 固有のランキング、出典、または直接のページアクセスが必要な場合は、代わりに wiki ネイティブのツールを使用します。

推奨されるハイブリッドパターン

ローカル優先のセットアップにおける強力なデフォルトは次の構成です。

  • リコールと広範なセマンティック検索のための Active Memory バックエンドとして QMD を使用する
  • 永続的に統合された知識ページのために memory-wiki を bridge モードで使用する

この分担は、各レイヤーが役割に集中できるためうまく機能します。

  • QMD は生のノート、セッションエクスポート、追加コレクションを検索可能に保つ
  • memory-wiki は安定したエンティティ、主張、ダッシュボード、ソースページをコンパイルする

実用的なルール:

  • メモリ全体に対して広範なリコールを 1 回実行したい場合は memory_search を使用する
  • 出典を考慮した wiki 結果が必要な場合は wiki_search と wiki_get を使用する
  • 共有検索を両方のレイヤーにまたがらせたい場合は memory_search corpus=all を使用する

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

ブリッジモードが有効で bridge.readMemoryArtifacts が有効な場合、openclaw wiki status、openclaw wiki doctor、openclaw wiki bridge import は実行中の Gateway 経由で読み取ります。これにより、CLI のブリッジチェックがランタイムのメモリプラグインコンテキストと一致します。ブリッジが無効な場合、またはアーティファクト読み取りが無効な場合、これらのコマンドはローカル/オフライン動作を維持します。

Vault モード

memory-wiki は 3 つの vault モードをサポートします。

isolated

独自の vault、独自のソースを持ち、memory-core への依存はありません。

wiki を独自にキュレーションされた知識ストアにしたい場合に使用します。

bridge

公開 Plugin SDK の接合点を通じて、Active Memory プラグインから公開メモリアーティファクトとメモリイベントを読み取ります。

プライベートなプラグイン内部に到達せずに、メモリプラグインがエクスポートしたアーティファクトを wiki にコンパイルして整理したい場合に使用します。

ブリッジモードは次をインデックス化できます。

  • エクスポート済みメモリアーティファクト
  • dream レポート
  • デイリーノート
  • メモリルートファイル
  • メモリイベントログ

unsafe-local

ローカルのプライベートパス向けの、明示的な同一マシンの脱出口です。

このモードは意図的に実験的かつ非ポータブルです。信頼境界を理解しており、ブリッジモードでは提供できないローカルファイルシステムアクセスが明確に必要な場合にのみ使用してください。

Vault レイアウト

プラグインは次のように vault を初期化します。

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

管理対象コンテンツは生成ブロック内に保持されます。人間のノートブロックは保持されます。

主なページグループは次のとおりです。

  • sources/: インポートされた生素材とブリッジに支えられたページ用
  • entities/: 永続的なもの、人、システム、プロジェクト、オブジェクト用
  • concepts/: アイデア、抽象化、パターン、ポリシー用
  • syntheses/: コンパイル済みの要約と保守されたロールアップ用
  • reports/: 生成されたダッシュボード用

構造化された主張と証拠

ページは自由形式のテキストだけでなく、構造化された claims frontmatter を持つことができます。

各主張には次を含められます。

  • id
  • text
  • status
  • confidence
  • evidence[]
  • updatedAt

証拠エントリには次を含められます。

  • kind
  • sourceId
  • path
  • lines
  • weight
  • confidence
  • privacyTier
  • note
  • updatedAt

これにより、wiki は受動的なノート置き場ではなく、信念レイヤーのように機能します。主張は追跡、スコアリング、異議申し立て、ソースへの解決が可能です。

エージェント向けエンティティメタデータ

エンティティページは、エージェント利用向けのルーティングメタデータも持てます。これは汎用 frontmatter なので、人、チーム、システム、プロジェクト、その他任意のエンティティタイプに使えます。

一般的なフィールドは次のとおりです。

  • entityType: 例: person、team、system、project
  • canonicalId: エイリアスやインポート全体で使用される安定した識別キー
  • aliases: 同じページに解決されるべき名前、ハンドル、ラベル
  • privacyTier: public、local-private、sensitive、confirm-before-use
  • bestUsedFor / notEnoughFor: コンパクトなルーティングヒント
  • lastRefreshedAt: ページ編集時刻とは別のソース更新タイムスタンプ
  • personCard: ハンドル、ソーシャル、メール、タイムゾーン、レーン、依頼対象、依頼を避ける対象、信頼度、プライバシーを含む任意の人物固有ルーティングカード
  • relationships: 対象、種類、重み、信頼度、証拠種別、プライバシーティア、ノートを持つ関連ページへの型付きエッジ

人物 wiki では、エージェントは通常 reports/person-agent-directory.md から開始し、連絡先詳細や推定された事実を使用する前に wiki_get で人物ページを開くべきです。

例:

yaml
pageType: entityentityType: personid: entity.brad-grouxcanonicalId: maintainer.brad-grouxaliases:  - Brad  - bgrouxprivacyTier: local-privatebestUsedFor:  - Microsoft Teams and Azure routingnotEnoughFor:  - legal approvallastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:  handles:    - "@bgroux"  socials:    - "https://x.example/bgroux"  emails:    - brad@example.com  timezone: America/Chicago  lane: Microsoft ecosystem  askFor:    - Teams rollout questions  avoidAskingFor:    - unrelated billing decisions  confidence: 0.8  privacyTier: confirm-before-userelationships:  - targetId: entity.alice    targetTitle: Alice    kind: collaborates-with    confidence: 0.7    evidenceKind: discrawl-statclaims:  - id: claim.brad.teams    text: Brad is useful for Microsoft Teams 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 ページをスクレイピングする必要がありません。

コンパイル済み出力は次も支えます。

  • search/get フローのための初回 wiki インデックス作成
  • 主張 ID から所有ページへの逆引き
  • コンパクトなプロンプト補足
  • レポート/ダッシュボード生成

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

render.createDashboards が有効な場合、コンパイルは 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

これらのレポートは次のようなものを追跡します。

  • 矛盾ノートのクラスター
  • 競合する主張のクラスター
  • 構造化された証拠が欠けている主張
  • 信頼度の低いページと主張
  • 古い、または鮮度が不明なもの
  • 未解決の質問があるページ
  • 人物/エンティティのルーティングカード
  • 構造化された関係エッジ
  • 証拠クラスのカバレッジ
  • 使用前にレビューが必要な非公開プライバシーティア

検索と取得

memory-wiki は 2 つの検索バックエンドをサポートします。

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

また、3 つのコーパスをサポートします。

  • wiki
  • memory
  • all

重要な動作:

  • wiki_search と wiki_get は、可能な場合コンパイル済みダイジェストを初回パスとして使用します
  • 主張 ID は所有ページへ解決できます
  • 異議のある/古い/新鮮な主張はランキングに影響します
  • 出典ラベルは結果に引き継がれる場合があります
  • 検索モードは人物検索、質問ルーティング、ソース証拠、または生の主張に向けてランキングを偏らせることができます

実用的なルール:

  • 広範なリコールを 1 回実行するには memory_search corpus=all を使用する
  • wiki 固有のランキング、出典、またはページ単位の信念構造を重視する場合は wiki_search + wiki_get を使用する

検索モード:

  • auto: バランスの取れたデフォルト
  • find-person: 人物らしいエンティティ、エイリアス、ハンドル、ソーシャル、正規 ID を強化する
  • route-question: エージェントカード、依頼対象ヒント、最適用途ヒント、関係コンテキストを強化する
  • source-evidence: ソースページと構造化された証拠メタデータを強化する
  • raw-claim: 一致する構造化された主張を強化し、結果に主張/証拠メタデータを返す

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

エージェントツール

プラグインは次のツールを登録します。

  • wiki_status
  • wiki_search
  • wiki_get
  • wiki_apply
  • wiki_lint

それぞれの役割:

  • wiki_status: 現在の vault モード、健全性、Obsidian CLI の可用性
  • wiki_search: wiki ページと、構成されている場合は共有メモリコーパスを検索する。人物検索、質問ルーティング、ソース証拠、生の主張の掘り下げのために mode を受け付ける
  • wiki_get: id/path で wiki ページを読み取る、または共有メモリコーパスにフォールバックする
  • wiki_apply: 自由形式のページ手術なしに、狭い範囲の統合/メタデータ変更を行う
  • wiki_lint: 構造チェック、出典の欠落、矛盾、未解決の質問

プラグインは非排他的なメモリコーパス補足も登録するため、Active Memory プラグインがコーパス選択をサポートしている場合、共有 memory_search と memory_get は wiki に到達できます。

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

context.includeCompiledDigestPrompt が有効な場合、メモリプロンプトセクションは agent-digest.json からコンパクトなコンパイル済みスナップショットを追加します。

そのスナップショットは意図的に小さく、高シグナルです。

  • 上位ページのみ
  • 上位主張のみ
  • 矛盾数
  • 質問数
  • 信頼度/鮮度の修飾子

これはプロンプト形状を変更するためオプトインであり、主にメモリ補足を明示的に消費するコンテキストエンジンやレガシーのプロンプト組み立てに有用です。

設定

設定は plugins.entries.memory-wiki.config 配下に置きます。

json5
{  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,          },          ingest: {            autoCompile: true,            maxConcurrentJobs: 1,            allowUrlIngest: true,          },          search: {            backend: "shared",            corpus: "wiki",          },          context: {            includeCompiledDigestPrompt: false,          },          render: {            preserveHumanBlocks: true,            createBacklinks: true,            createDashboards: true,          },        },      },    },  },}

主な切り替え:

  • vaultMode: isolated、bridge、unsafe-local
  • vault.renderMode: native または obsidian
  • bridge.readMemoryArtifacts: Active Memory Plugin の公開アーティファクトをインポートする
  • bridge.followMemoryEvents: ブリッジモードでイベントログを含める
  • search.backend: shared または local
  • search.corpus: wiki、memory、または all
  • context.includeCompiledDigestPrompt: コンパクトなダイジェストスナップショットをメモリプロンプトセクションに追加する
  • render.createBacklinks: 決定論的な関連ブロックを生成する
  • render.createDashboards: ダッシュボードページを生成する

例: QMD + ブリッジモード

想起に QMD を使い、保守された知識レイヤーに memory-wiki を使いたい場合に使用します:

json5
{  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

memory-wiki はトップレベルの CLI サーフェスも公開します:

bash
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 を参照してください。

Obsidian サポート

vault.renderMode が obsidian の場合、Plugin は Obsidian に適した Markdown を書き込み、任意で公式の obsidian CLI を使用できます。

サポートされるワークフローには次のものがあります:

  • ステータス調査
  • vault 検索
  • ページを開く
  • Obsidian コマンドの呼び出し
  • デイリーノートへのジャンプ

これは任意です。wiki は Obsidian なしでもネイティブモードで動作します。

推奨ワークフロー

  1. 想起/昇格/Dreaming 用に Active Memory Plugin を維持します。
  2. memory-wiki を有効化します。
  3. ブリッジモードを明示的に必要としない限り、isolated モードから始めます。
  4. 来歴が重要な場合は wiki_search / wiki_get を使います。
  5. 範囲の狭い統合やメタデータ更新には wiki_apply を使います。
  6. 意味のある変更の後に wiki_lint を実行します。
  7. 古くなった情報や矛盾を可視化したい場合は、ダッシュボードを有効にします。

関連ドキュメント

Was this useful?