OpenCLAWのメモリの実際の仕組み

OpenCLAWエージェントは会話間で永続的なメモリを持ちません。メッセージを送信するたびに、エージェントはいくつかのファイル（SOUL.md、USER.md、MEMORY.md、および最近のセッション履歴）を読み取り、その「メモリ」を一から構築します。それは記憶しているのではなく、メモを読んでいるのです。

エージェントが物事を忘れる5つの理由

理由1: セッションが古すぎる

現在のセッションのすべてのメッセージは、新しいAPI呼び出しごとに含まれます。2〜3週間後には、これが数千のトークンになります。モデルはコンテキスト制限に達するか（初期の会話が黙って切り捨てられる）、またはOpenCLAWが圧縮を実行してすべてを要約しますが、詳細が失われます。

修正: 定期的に/newを使用してください - 少なくとも毎日、そして大きなタスクの前には必ず。これにより、すべてのファイルをそのままにしながら、会話バッファがクリアされます。

理由2: 重要な情報がチャット履歴にあり、ファイルにない

3週間前に会話でエージェントに何かを伝えた場合、その情報は切り捨てられるセッション履歴にあります。エージェントが常に知っておくべきことは、チャットではなくファイルにある必要があります。

修正: 永続的な情報をUSER.mdに入れてください:

# 私について
- 名前: [あなたの名前]
- パートナー: [名前]
- 場所: [都市]
- 仕事: [役職]
- タイムゾーン: [タイムゾーン]

好み

コミュニケーション: 直接的、無駄なし
朝のルーティン: 8時にブリーフィング
10時前の会議は決してスケジュールしない
コーヒーの注文: [それが何であれ、真剣に]

理由3: MEMORY.mdが肥大化した混乱状態

ほとんどの人はMEMORY.mdを構造化しません。1か月後には、モデルが読む代わりにざっと見るだけの巨大なテキストの壁になります。重要な事実は無関係な詳細の下に埋もれてしまいます。

修正: MEMORY.mdを明確なセクションに構造化してください:

# 人物
- サラ（妻）: [会社]で働く、誕生日6月12日
- マイク（同僚）: フロントエンドを担当、メールよりSlackを好む

進行中のプロジェクト

キッチンリフォーム: 請負業者はデイブ、予算15,000ドル、4月開始
Q2プレゼンテーション: 3月28日締切、マイクからの売上データが必要

決定事項

3月5日にopusからsonnetに切り替え（コストの理由）
googleの代わりにbrave search APIを使用（無料枠で十分）

定期的なタスク

毎日8時にブリーフィング（カレンダー+メール+天気）
毎週日曜日18時に食料品リスト

理由4: メモリメンテナンスのルーティンがない

メモリファイルは永遠に成長します。2か月後には、MEMORY.mdは300行になり、その半分は時代遅れまたは無関係です。モデルは完了したプロジェクトについて読むためにトークンを浪費します。

修正: 毎晩のメモリcronを設定してください。これをエージェントの指示に追加します:

毎晩23時:
1. 今日の会話を確認する
2. 新しい事実、決定、または約束を抽出する
3. それらをMEMORY.mdの正しいセクションに追加する
4. もはや関連性のないものを削除する
5. 新しいセッションを開始する

理由5: セッションメモリと長期記憶を混同している

階層を理解してください:

• SOUL.md: アイデンティティと人格。毎回読み込まれる。変更しない限り変更されない。
• USER.md: あなたに関する事実。毎回読み込まれる。生活が変わったときに更新する。
• MEMORY.md: 進行中のコンテキスト。毎回読み込まれる。成長し、剪定される。