コンテンツへスキップ
ガイド

OpenClawのメモリwiki

メモリプラグインと並んで動く、主張、根拠、出所、ダッシュボードを備えたコンパイル済みのナレッジ保管庫

6分で読めます

通常のメモリノートは、エージェントが何を覚えているかには答えますが、それをどの程度確信しているのか、事実がどこから来たのか、どの2つのノートが互いに矛盾しているのかは教えてくれません。OpenClawに同梱されているmemory-wikiプラグインは、その層を追加します。永続的な知識を、決定論的なページ、根拠付きの構造化された主張、出所、ダッシュボード、機械可読なダイジェストからなる、たどりやすいwikiにコンパイルし、アクティブなメモリプラグインを置き換えるのではなくその隣に位置します。想起、昇格、インデックス作成、ドリーミングは、設定されたメモリプラグインが引き続き担います。以下では、保管庫モード、レイアウト、主張のモデル、コンパイルのパイプライン、レポート、ツール、エージェントごとの保管庫に関する注意点を紹介します。

モード、スコープ、レイアウト

  • 保管庫モードは3つあります。デフォルトのisolatedは独自の保管庫とソースを持ち、メモリプラグインに依存しません。bridgeは、公開されたプラグインSDKの接点を通じてアクティブなメモリプラグインの公開メモリアーティファクトとイベントログを読み取り、トグルに応じてエクスポートされたアーティファクト、デイリーノート、ドリームレポート、メモリイベントログをインデックス化します。unsafe-localは、プライベートなパスのための同一マシン上の明示的な抜け道で、実験的かつ移植性がありません。
  • 保管庫のスコープは別の選択です。デフォルトのglobalは共有の保管庫を一つ保持し、agentスコープは各エージェントに子保管庫を与えるため、エージェント同士でページ、ダイジェスト、検索結果、書き込みを共有できません。agentスコープはunsafe-localモードと組み合わせることができず、バリデーションで拒否されます。
  • 保管庫には、最上位のエージェントノートとwikiノート、インデックスと受信箱、そしてエンティティ、コンセプト、シンセシス、ソース、レポート、添付ファイル、ビューのフォルダーがあります。管理されるコンテンツは生成されたブロックの中にとどまり、人が書いたノートのブロックは再生成後も残ります。
  • Open Knowledge Formatのバンドルはコンセプトページとしてインポートされ、元のコンセプトのid、type、resource、tags、timestamp、producerのフロントマターが保持されます。内部リンクはwikiページへのリンクに書き換えられ、構造化された関係として出力されます。
これにより、wikiは受け身のノート置き場ではなく、信念の層として振る舞います。

主張、エンティティ、コンパイル

ページはフロントマターに構造化された主張を持ち、各主張にはid、テキスト、ステータス、確信度、根拠のエントリー、更新時刻があります。根拠には種類、ソースID、パス、行、重み、確信度、プライバシー階層、メモが含まれます。主張は追跡し、スコアを付け、異議を唱え、ソースに遡って解決できます。エンティティページは、人、チーム、システム、プロジェクトに使えるルーティング用のメタデータを追加します。エンティティタイプ、正規ID、エイリアス、プライバシー階層(public以外はレビュー対象としてフラグが立ちます)、best-used-forとnot-enough-forのヒント、更新タイムスタンプ、ハンドル、SNS、メールアドレス、タイムゾーン、担当領域、ask-forとavoid-asking-forのリストを含む任意の人物カード、そして型付きの関係です。コンパイルはページを読み込み、要約を正規化し、機械向けのスナップショットをOpenClawの共有SQLiteプラグインステートに保存します。ランタイムのプロンプト準備はそのスナップショットを非同期で読み込み、Markdownをスクレイピングしたりキャッシュファイルを読んだりすることはありません。ソースの編集が機械向けに反映されるのは次のコンパイルの後で、因果的に連鎖したコンパイルの公開により、ライフサイクルのリフレッシュは、より新しくロールバックされた状態からのスナップショットを拒否できます。コンパイル済みのキャッシュは再構築可能で、移行されるのではなく置き換えられます。

レポート、検索、ツール

  • ダッシュボードを有効にすると、コンパイルは次のレポートを維持します。未解決の質問、矛盾、確信度の低いページと主張、構造化された根拠のない主張、古くなったページ、人物とエージェントのディレクトリ、関係グラフ、出所のカバレッジ、public以外の階層のプライバシーレビューです。
  • 検索には、利用可能な場合はメモリ検索のフローを使う共有バックエンドと、wikiだけを検索するローカルバックエンドがあります。コーパスはwiki、memory、allの3つ、モードはauto、find-person、route-question、source-evidence、raw-claimの5つです。構造化された主張にヒットすると、主張のid、ステータス、確信度、根拠の種類、ソースIDが返され、異議のある主張、古い主張、新しい主張はランキングに影響します。
  • エージェントツールは5つです。wiki status、wiki search、wiki get、自由形式のページ編集を伴わない限定的なシンセシスとメタデータの変更を行うwiki apply、そして構造チェック、出所の欠落、矛盾、未解決の質問を調べるwiki lintです。また、プラグインは非排他的なコーパス補完も登録するため、メモリプラグインがコーパスの選択に対応していれば、共有のメモリ検索とgetがwikiにも届きます。

このプラグインが隣に位置する層についてはOpenClawのメモリの仕組みを、ドキュメントが今でも最初に行うよう推奨している幅広い想起のパスについてはOpenClawのメモリ検索をご覧ください。

UIと注意点

コントロールUIでは、メモリページのdreamsタブとdiaryタブの下からコンパイル済みのwikiを閲覧できます。シンセシス、エンティティ、コンセプトのページをページごとの件数とともにまとめて表示し、getツールと同じ検索処理でコンテンツをインラインで開き、各ダッシュボードを最新の2,500枚のカードに制限し、生の保管庫ページをスキャンしたり完全なコンパイルを待ったりすることはありません。コンパイル済みのダイジェストは、上位のページと上位の主張を矛盾と質問の件数とともにメモリのプロンプトセクションに追記できますが、プロンプトの形が変わるためオプトインになっています。保管庫のスコープを変更しても既存の保管庫がコピーされたり分割されたりすることはありません。また、エージェントごとの保管庫は同一プロセス内の知識の境界であって、OSレベルの境界ではありません。ホストのファイルシステムにアクセスできるサンドボックス化されていないツールは、他のエージェントのディレクトリを読めてしまうためです。bridgeモードがインデックス化できるメモリプラグイン自身の統合処理についてはOpenClawのドリーミングを、エージェント同士が互いを信頼しない場合にドキュメントが示す境界についてはOpenClawのサンドボックスの仕組みをご覧ください。

Dialiでは

Dialiでは、このプラグインはランタイムイメージに同梱されており、有効にすると保管庫はアシスタントの永続ボリューム上のステートディレクトリの下に置かれます。各インスタンスがそれぞれ独自のアシスタントを実行するため、ここではエージェントごとの境界はそれほど重要ではありません。アシスタントについてはDialiのマネージドOpenClawホスティングを、同梱プラグインを有効にする方法についてはOpenClawのプラグインをご覧ください。

  • メモリの代わりではなく、メモリの隣に置かれる信念の層です。
  • 根拠付きの主張をSQLiteにコンパイルし、ダッシュボードでレポートします。
  • デフォルトはisolatedで、メモリがエクスポートするものをインデックス化するにはbridgeを使います。
今すぐ始める

読むだけでなく、作ってみましょう

エージェントを設定してチャネルを選べば、いつも開いているアプリの中でエージェントが働き始めます。