Memory の概要

​

仕組み

• MEMORY.md — 長期メモリ。永続的な事実、好み、決定事項。セッション開始時に読み込まれます。
• memory/YYYY-MM-DD.md（または memory/YYYY-MM-DD-<slug>.md）— 日次ノート。実行中のコンテキストと観察事項。素の /new または /reset では、今日と昨日の日付付きノートが自動的に読み込まれます。バンドルされた session-memory hook が書き込むような slug 付きのバリアントも、日付のみのファイルと一緒に取り込まれます。
• DREAMS.md（任意）— 人間のレビュー向けの Dream Diary と dreaming sweep の要約。根拠付きの履歴バックフィルエントリも含みます。

​

何をどこに置くか

​

アクションに敏感なメモリ

• 承認または許可の要件、
• 一時的な制約、
• 別のセッション、スレッド、または人への引き継ぎ、
• 失効条件、
• 行動して安全なタイミング、
• ソースまたは所有者の権限、
• 誘惑されやすい行動を避けるための指示。

• 将来の挙動を変えるもの、
• それが適用されるタイミングまたは条件、
• それが失効するタイミング、またはアクションを解禁するもの、
• エージェントが避けるべきこと、
• 信頼や権限に影響する場合、そのソースまたは所有者。

The API migration is being designed in another session. Future turns should
not edit the API implementation from this thread; use findings here only as
design input until the migration plan lands.

A report from an untrusted source needs review before promotion. Future turns
should treat it as evidence only; do not store it as durable memory until a
trusted reviewer confirms the contents.

​

推論された commitments

​

メモリツール

• memory_search — 元の表現と異なる場合でも、セマンティック検索を使って関連するノートを見つけます。
• memory_get — 特定のメモリファイルまたは行範囲を読みます。

​

メモリ検索

​

メモリバックエンド

​

ナレッジ wiki 層

​

自動メモリフラッシュ

{
  "agents": {
    "defaults": {
      "compaction": {
        "memoryFlush": {
          "model": "ollama/qwen3:8b"
        }
      }
    }
  }
}

​

Dreaming

• オプトイン: 既定では無効です。
• スケジュール済み: 有効な場合、memory-core は完全な dreaming sweep のための反復 cron ジョブを 1 つ自動管理します。
• しきい値付き: promotion はスコア、リコール頻度、クエリ多様性のゲートを通過する必要があります。
• レビュー可能: フェーズ要約と diary entry は、人間のレビュー用に DREAMS.md に書き込まれます。

​

根拠付きバックフィルとライブ promotion

• ライブ dreaming は、memory/.dreams/ 配下の短期 dreaming store から動作し、通常の deep phase が何を MEMORY.md に卒業させるかを決めるために使います。
• 根拠付きバックフィル は、履歴上の memory/YYYY-MM-DD.md ノートを standalone day file として読み、構造化されたレビュー出力を DREAMS.md に書き込みます。

openclaw memory rem-backfill --path ./memory --stage-short-term

• DREAMS.md は人間向けレビュー surface のままです。
• 短期 store は machine-facing ranking surface のままです。
• MEMORY.md は引き続き deep promotion によってのみ書き込まれます。

openclaw memory rem-backfill --rollback
openclaw memory rem-backfill --rollback-short-term

​

CLI

openclaw memory status          # Check index status and provider
openclaw memory search "query"  # Search from the command line
openclaw memory index --force   # Rebuild the index

​

関連情報

• メモリ検索: 検索パイプライン、プロバイダー、調整。
• 組み込みメモリエンジン: 既定の SQLite バックエンド。
• QMD メモリエンジン: 高度なローカルファーストのサイドカー。
• Honcho メモリ: AI ネイティブなクロスセッションメモリ。
• Memory LanceDB: OpenAI 互換 embeddings を備えた LanceDB バックエンドの plugin。
• Memory Wiki: コンパイル済みナレッジ vault と wiki ネイティブツール。
• Dreaming: 短期リコールから長期メモリへのバックグラウンド promotion。
• メモリ設定リファレンス: すべての設定ノブ。
• Compaction: Compaction がメモリとどのように相互作用するか。
• Active Memory: 対話型チャットセッション用のサブエージェントメモリ。