> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 長期記憶

> CowAgent の長期記憶システム — ファイル永続化、自動書き込み、ハイブリッド検索

長期記憶はワークスペースのファイルに保存され、セッション間で永続化されます。Agent は会話中に検索ツールを通じて過去の記憶をオンデマンドで読み込み、コンテキストのトリミング時に会話の要約を自動的に長期記憶に書き込みます。

<img src="https://cdn.link-ai.tech/doc/memory-architecture-en.jpg" alt="Memory Architecture" />

## 記憶の種類

### コア記憶（MEMORY.md）

`~/cow/MEMORY.md` に保存され、長期的なユーザーの好み、重要な決定、主要な事実など、時間が経っても薄れない情報を含みます。Agent はツールを通じてこのファイルを読み書きし、長期的な知識を維持します。

### 日次記憶（memory/YYYY-MM-DD.md）

`~/cow/memory/` ディレクトリに保存され、日付で命名されます（例：`2026-03-08.md`）。日々の会話の要約と主要なイベントを記録します。空ファイルの生成を避けるため、最初の書き込み時にのみファイルが作成されます。

### 夢日記（memory/dreams/YYYY-MM-DD.md）

Deep Dream（記憶蒸留）プロセスの副産物で、各整理で発見された重複、統合操作、新しい洞察を記録します。`~/cow/memory/dreams/` ディレクトリに日付で命名されて保存されます。

## 自動書き込み

Agent は以下のメカニズムにより、会話内容を長期記憶に自動的に永続化します：

* **コンテキストトリミング時** — 会話ターン数またはトークン数が設定上限を超えた場合、最も古い半分のコンテキストがトリミングされ、LLM によって要約されて日次記憶ファイルに書き込まれます。要約は保持されたコンテキストにも非同期で注入され、会話の連続性を維持します
* **毎日のスケジュール要約** — 毎日 23:55 に自動的にフル要約がトリガーされ、アクティビティが少ない日でも記憶が保存されます（内容が変更されていない場合はスキップ）
* [夢境蒸留（Deep Dream）](/ja/memory/deep-dream) — 毎日の要約完了後に自動実行され、日次記憶を MEMORY.md に蒸留し、夢日記を生成します
* **API コンテキストオーバーフロー時** — モデル API がコンテキストオーバーフローエラーを返した場合、緊急措置として現在の会話要約が保存されます

すべての記憶書き込みはバックグラウンドスレッドで非同期に実行され（LLM の要約 + ファイル書き込み）、通常の会話応答をブロックしません。

## 関連ファイル

ワークスペース（デフォルト `~/cow`）内の記憶関連ファイル：

| ファイル                          | 説明                    |
| ----------------------------- | --------------------- |
| `AGENT.md`                    | Agent のパーソナリティと動作設定   |
| `USER.md`                     | ユーザーの身元情報と好み          |
| `RULE.md`                     | カスタムルールと制約            |
| `MEMORY.md`                   | コア記憶（長期）              |
| `memory/YYYY-MM-DD.md`        | 日次記憶（オンデマンドで作成）       |
| `memory/dreams/YYYY-MM-DD.md` | 夢日記（Deep Dream で自動生成） |

## Web コンソール

Web コンソールの記憶管理ページで、記憶ファイルと夢日記を閲覧できます。タブ切り替えに対応：

<Frame>
  <img src="https://cdn.link-ai.tech/doc/20260414171014.png" width="800" />
</Frame>

## 設定

| パラメータ                      | 説明                                    | デフォルト   |
| -------------------------- | ------------------------------------- | ------- |
| `agent_workspace`          | ワークスペースパス、記憶ファイルはこのディレクトリ配下に保存されます    | `~/cow` |
| `agent_max_context_tokens` | 最大コンテキストトークン数。超過時にトリミングされ、記憶として要約されます | `50000` |
| `agent_max_context_turns`  | 最大コンテキストターン数。超過時にトリミングされ、記憶として要約されます  | `20`    |