🐾 claw-stack

最終更新:2026年3月

永続メモリシステム

Claw-Stack の永続メモリシステムは AI エージェントに 3 つの異なるメモリ層を提供します——即時リコール、構造化ナレッジ、セマンティック検索——毎回最初からやり直すのではなく、セッションをまたいで専門知識を蓄積できます。

3つのパラダイムの融合

メモリアーキテクチャは 3 つの研究パラダイムに基づいており、それぞれが保持問題の異なる部分を解決します:

Mem0 — ファクト抽出

各セッション後、抽出パスが保持する価値のある個別のファクトを識別します:ユーザーの好み、プロジェクトの状態、学んだ教訓、オープンなタスク。これらはソース帰属と信頼スコア付きの構造化エントリとして保存されます。

Zep — 時間的減衰

メモリエントリには生存時間(TTL)値があります。高頻度のファクトは無期限に新鮮に保たれます。古いまたは低関連度のエントリは減衰し、最終的にアーカイブされます——削除ではありません。週次のクリーンアップは期限切れエントリをアーカイブ前に教訓にまとめます。

MemGPT — エージェント自己管理

エージェントは自身のメモリファイルを直接読み書きできます。各エージェントは前日の作業から教訓を抽出し、個人メモリを更新する日次の自己レビューを実行します。これにより良好なサイクルが生まれます:昨日間違いを犯したエージェントは明日それを覚えています。

3つのメモリ層

第1層 — MEMORY.md(即時リコール)

トップレベルの MEMORY.md ファイルはすべてのエージェントのコンテキストウィンドウにセッション開始時にロードされます。コンテキストバジェットを占有しすぎないよう、意図的に短く(200 行以内)保たれます。最も重要で頻繁にアクセスされるファクトのみを含みます:現在のプロジェクト、アクティブタスク、重要な連絡先、システム状態。

第2層 — memory/*.md(構造化ナレッジ)

memory/ ディレクトリにはエージェントがオンデマンドで読み取れるトピック別 Markdown ファイルが含まれます。トピックは personal/projects/agents/system/ のカテゴリに分類されます。完全な履歴を検索するのではなく、関連するトピックファイルを読み取ります。

第3層 — セマンティックベクターインデックス(ディープリトリーバル)

日次メモリ同期パイプラインは完全な抽出パスを実行します:生のメモリファイルをスキャンし、エントリをベクターストアに埋め込み、重複エントリをデデュプリケートし、カテゴリ別に分類して検索インデックスにエクスポートします。「3ヶ月前に X について何を決定しましたか?」という質問に対し、セマンティック検索はキーワード一致ではなく埋め込み類似度でランク付けされた関連エントリを返します。

日次メモリパイプライン

[日次 Cron]
  → 生のメモリファイルをスキャン
  → LLM ファクト抽出(構造化 JSON)
  → 重複エントリのデデュプリケーション
  → 分類:personal / tasks / agents / system
  → TTL 値を割り当て
  → ベクターストアに埋め込みとインデックス
  → MEMORY.md を更新(古い最上位ファクトを削除)

[週次 Cron — 日曜午前 4:00]
  → 期限切れエントリに減衰エンジンを実行
  → 期限切れエントリを教訓にまとめる
  → lessons.md にアーカイブ(検索可能、不変)
  → アクティブインデックスから削除
          

よくある質問

メモリはエージェント間で共有されますか?

デフォルトでは、各エージェントは自身の個人メモリスペースを持ちます。すべてのエージェントが読み取れる共有システムメモリもあります。エージェントは他のエージェントの個人メモリに書き込めません——自分のメモリのみです。

セッション開始時に MEMORY.md をロードするトークンコストは?

MEMORY.md ファイルは 200 行に制限されており、コンテンツの密度によって通常 800〜1500 の入力トークンかかります。これは意図的な設計です:ファイルは大きなタスク記述のあるセッションでコンテキストバジェットを支配しない程度に小さく保つ必要があります。

メモリエントリは手動で編集できますか?

はい。すべてのメモリファイルはディスク上のプレーン Markdown です。直接編集、削除、または再編成できます。メモリバスはファイルをロックしません。次のパイプライン実行時に変更が取得され、ベクターインデックスが更新されます。

Authors: Qiushi Wu & Orange 🍊