Plugins

メモリウィキ

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 を初期化します。

<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 で人物ページを開くべきです。

例:

pageType: entity
entityType: person
id: entity.brad-groux
canonicalId: maintainer.brad-groux
aliases:
  - Brad
  - bgroux
privacyTier: local-private
bestUsedFor:
  - Microsoft Teams and Azure routing
notEnoughFor:
  - legal approval
lastRefreshedAt: "2026-04-29T00:00:00.000Z"
personCard:
  handles:
    - "@bgroux"
  socials:
    - "https://x.example/bgroux"
  emails:
    - [email protected]
  timezone: America/Chicago
  lane: Microsoft ecosystem
  askFor:
    - Teams rollout questions
  avoidAskingFor:
    - unrelated billing decisions
  confidence: 0.8
  privacyTier: confirm-before-use
relationships:
  - targetId: entity.alice
    targetTitle: Alice
    kind: collaborates-with
    confidence: 0.7
    evidenceKind: discrawl-stat
claims:
  - 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 配下に置きます。

{
  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 を使いたい場合に使用します:

{
  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 サーフェスも公開します:

openclaw wiki status
openclaw wiki doctor
openclaw wiki init
openclaw wiki ingest ./notes/alpha.md
openclaw wiki compile
openclaw wiki lint
openclaw wiki search "alpha"
openclaw wiki get entity.alpha
openclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alpha
openclaw wiki bridge import
openclaw wiki obsidian status

完全なコマンドリファレンスは CLI: wiki を参照してください。

Obsidian サポート

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

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

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

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

推奨ワークフロー

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

メモリウィキ

追加されるもの

メモリとの関係

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

Vault モード

`isolated`

`bridge`

`unsafe-local`

Vault レイアウト

構造化された主張と証拠

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

コンパイルパイプライン

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

検索と取得

エージェントツール

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

設定

例: QMD + ブリッジモード

CLI

Obsidian サポート

推奨ワークフロー

関連ドキュメント

Ask OpenClaw

# 追加されるもの

# メモリとの関係

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

# Vault モード

# isolated

# bridge

# unsafe-local

# Vault レイアウト

# 構造化された主張と証拠

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

# コンパイルパイプライン

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

# 検索と取得

# エージェントツール

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

# 設定

# 例: QMD + ブリッジモード

# CLI

# Obsidian サポート

# 推奨ワークフロー

# 関連ドキュメント

追加されるもの

メモリとの関係

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

Vault モード

`isolated`

`bridge`

`unsafe-local`

Vault レイアウト

構造化された主張と証拠

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

コンパイルパイプライン

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

検索と取得

エージェントツール

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

設定

例: QMD + ブリッジモード

CLI

Obsidian サポート

推奨ワークフロー

関連ドキュメント