mcpField
M
memory-management

memory-management

github.com/jzocbエージェントワークフロー39228 回インストール38 週間前に更新
リポジトリ

memory-management について

エージェントの記憶を、常時読み込む要点、検索可能な教訓、日々の生ログの三層で整理するスキルです。優先度別の保持期間とアーカイブ手順により、常用メモを簡潔に保ちます。

主な機能

  1. 01三層構造による記憶整理
  2. 02優先度タグと保持期間
  3. 03検索可能な構造化教訓ファイル
  4. 04janitor スクリプトによる自動アーカイブ
  5. 05記憶量の確認とドライラン

活用シーン

  1. 01エージェントの基本メモを簡潔に保つ
  2. 02期限切れのプロジェクト情報をアーカイブ
  3. 03保存したトラブル対処法を検索
  4. 04整理前に記憶内容を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jzocb/openclaw-memory-management --skill memory-management

インストール後、Claude Code で/memory-managementを入力して読み込まれたか確認します。

詳細

メモリ管理スキル

自動アーカイブ機能を備えた3層アーキテクチャを使用して、エージェントのメモリを効率的に管理します。

クイックセットアップ

  1. MEMORY.md を優先度タグ付きでフォーマットします:
- [P0] Core identity item (never expires)
- [P1][2026-02-10] Active project (90-day TTL)
- [P2][2026-02-10] Temporary item (30-day TTL)
  1. 自動アーカイブの cron を設定します:
0 4 * * * python3 ~/.openclaw/workspace/scripts/memory-janitor.py
  1. 教訓を memory/lessons/*.jsonl に保存します:
{"id": "lesson-001", "date": "2026-02-10", "category": "infra", "title": "Problem title", "problem": "What happened", "solution": "How to fix", "tags": ["tag1"]}

3層アーキテクチャ

レイヤー1:ホットメモリ(MEMORY.md)

  • 常に読み込まれます。200行以下にします
  • P0:中核となるアイデンティティ。有効期限はありません
  • P1:進行中のプロジェクト。TTL は90日です
  • P2:一時的な情報。TTL は30日です

レイヤー2:コールドメモリ(検索可能)

  • memory/lessons/*.jsonl — 構造化された教訓
  • memory/archive/ — 期限切れのコンテンツ
  • 思い出すには memory_search を使用します

レイヤー3:生ログ

  • memory/YYYY-MM-DD.md — 日次ログ
  • 自動では読み込まれません

優先度のガイドライン

優先度用途TTL
P0ユーザーのアイデンティティ、好み、安全ルールなし
P1進行中のプロジェクト、現在の戦略90日
P2デバッグメモ、一度限りの出来事30日

中核となる原則(AGENTS.md には最大5つ)

AGENTS.md には必須のルールだけを残します。それ以外の教訓は lessons/*.jsonl に保存します。

ルールの例(5つ):

  1. 実際のお金が関わる場合、速度より正確性を優先する
  2. 外部への操作には確認が必要
  3. 両方の cron システム(system と OpenClaw)を確認する
  4. 長時間実行プロセスには setsid による分離が必要
  5. 取引の前にプラットフォームのルールを読む

メモリが大きくなりすぎた場合

統計情報を付けて janitor を実行します:

python3 scripts/memory-janitor.py --stats

200行を超える場合:

  1. P0 の項目を見直します。本当にすべて恒久的な内容ですか?
  2. 日付がない P1/P2 の項目に日付を追加します
  3. 詳細な内容を lessons/*.jsonl に移動します
  4. --dry-run を実行してからアーカイブします

コメント