OpenClaw History Ingest — Session & Memory Mining

ユーザーの OpenClaw エージェント履歴から知識を抽出し、それを Obsidian wiki に蒸留しています。OpenClaw は構造化された長期 MEMORY.md と セッションごとの JSONL トランスクリプトの両方を保存しています。運用テレメトリーではなく、永続的な知識に焦点を当ててください。

このスキルは直接呼び出すか、wiki-history-ingest ルーター (/wiki-history-ingest openclaw) を経由して呼び出すことができます。

開始前に

1. 設定の解決 — llm-wiki/SKILL.md の Config Resolution Protocol に従います (CWD を上歩行して .env → ~/.obsidian-wiki/config → プロンプト設定を確認)。これにより OBSIDIAN_VAULT_PATH と OPENCLAW_HISTORY_PATH (デフォルト: ~/.openclaw) が得られます
2. vault ルートの .manifest.json を読んで、既に取り込まれたものを確認します
3. vault ルートの index.md を読んで、wiki に既に含まれている内容を理解します

取り込みモード

Append Mode (デフォルト)

各ソースファイルについて .manifest.json をチェックします。次の場合のみ処理:

• manifest にないファイル (新しいセッションログ、更新された MEMORY.md または日次ノート)
• manifest の ingested_at より新しい変更時刻を持つファイル

このモードを定期的な同期に使用します。

Full Mode

manifest に関わらずすべてを処理します。wiki-rebuild の後またはユーザーが完全な再取り込みを明示的に要求した場合に使用します。

OpenClaw データレイアウト

OpenClaw はすべてのローカルアーティファクトを ~/.openclaw/ に保存します。

~/.openclaw/
├── openclaw.json                          # Global config
├── credentials/                           # Auth tokens (完全にスキップ)
├── workspace/                             # エージェント workspace
│   ├── MEMORY.md                          # 長期メモリー (毎セッション読み込み)
│   ├── DREAMS.md                          # オプション: dream diary / 要約
│   └── memory/
│       ├── YYYY-MM-DD.md                  # 日次ノート (今日と昨日は自動読み込み)
│       └── ...
└── agents/
    └── <agentId>/
        ├── agent/
        │   └── models.json                # エージェント設定 (スキップ)
        └── sessions/
            ├── sessions.json              # セッションインデックス
            └── <sessionId>.jsonl          # セッション トランスクリプト (JSONL, append-only)

価値でランク付けされた主要データソース

1. workspace/MEMORY.md — 最高信号; エージェントが蓄積した長期の永続的事実
2. workspace/memory/YYYY-MM-DD.md — 日次ノート; 最近のエントリーはアクティブなプロジェクトコンテキストを含むことが多い
3. agents/*/sessions/<id>.jsonl — セッション トランスクリプト; 豊富だがノイズがある
4. agents/*/sessions/sessions.json — セッションインデックス; インベントリーとタイムスタンプ用
5. workspace/DREAMS.md — オプションの要約; 存在する場合は取り込み

credentials/ は完全にスキップします。agents/*/agent/models.json (実行時設定であり、ユーザー知識ではない) はスキップします。

ステップ 1: 調査と差分計算

OPENCLAW_HISTORY_PATH をスキャンし、.manifest.json と比較します:

• ~/.openclaw/workspace/MEMORY.md
• ~/.openclaw/workspace/DREAMS.md (存在する場合)
• ~/.openclaw/workspace/memory/*.md
• ~/.openclaw/agents/*/sessions/sessions.json
• ~/.openclaw/agents/*/sessions/*.jsonl

各ファイルを分類します:

• New — manifest にない
• Modified — manifest にあるが、ファイルが ingested_at より新しい
• Unchanged — 既に取り込まれており変更されていない

深い解析を始める前に、簡潔な差分サマリーを報告します。

ステップ 2: MEMORY.md を最初に解析

MEMORY.md は最も価値の高いソースです。これはプレーン Markdown であり、人間が読める・編集できます。通常は以下を含みます:

• ユーザーの好み、環境、および繰り返されるパターンに関する永続的事実
• エージェントに記憶するよう指示された決定とコンテキスト
• エージェントが多くのセッションにわたって蓄積したプロジェクト固有のノート

全文を読んでコンセプトレベルの知識を抽出します。MEMORY.md エントリーごとに 1 つの wiki ページを作成しないでください — トピックでクラスタリングしてください。

ステップ 3: 日次ノートを解析

workspace/memory/YYYY-MM-DD.md ファイルにはその日のセッションからのタイムスタンプ付きノートが含まれています。最近のファイル (過去 30～90 日間) を優先します。次を抽出します:

• アクティブなプロジェクトコンテキストと実施された決定
• 発見されたパターンまたはテクニック
• 繰り返される課題またはソルベした問題

古い日次ノートは信号が低下しています — 1 行ずつ抽出するのではなく、一括で要約します。

ステップ 4: セッション JSONL を安全に解析

各セッションファイルは JSONL (append-only、1 行につき 1 つの JSON オブジェクト) です:

{"role": "user",      "content": "...", "timestamp": "..."}
{"role": "assistant", "content": "...", "timestamp": "..."}
{"role": "tool",      "name": "...",   "content": "...", "timestamp": "..."}

抽出ルール

• 結論、決定、またはパターンを述べるアシスタントターンを優先します
• 高信号ターンからユーザー意図を抽出; 低情報フォローアップはスキップ
• ツール呼び出しはコンテキストであり、主要な知識ではありません — 結果に再利用可能な洞察が含まれている場合のみ抽出
• 個別トランスクリプトを開く前に sessions.json インデックスを相互参照してセッション名/ラベルを取得します

重大なプライバシーフィルター

セッション トランスクリプトには注入された指示、ツールペイロード、および機密テキストが含まれる可能性があります。逐語的に取り込まないでください。

• API キー、トークン、パスワード、認証情報を削除
• 関連性があり、ユーザーが承認していない限り、個人識別子は編集
• 生のトランスクリプトを逐語的に引用するのではなく、要約

ステップ 5: トピック別にクラスタリング

セッションごと、または MEMORY.md エントリーごとに 1 つの wiki ページを作成しないでください。

• 安定したトピック (コンセプト、ツール、プロジェクト、テクニック) でグループ化
• 混合セッションを別々のテーマに分割
• 日付とエージェント全体で繰り返されるパターンをマージ
• セッション cwd または workspace パスを使用して、利用可能な場合はプロジェクトスコープを推定

ステップ 6: Wiki ページに蒸留

抽出した知識を既存の wiki 慣例を使用してルーティングします:

• プロジェクト固有のアーキテクチャ/プロセス → projects/<name>/...
• 一般的なコンセプト → concepts/
• 繰り返されるテクニック/デバッグプレイブック → skills/
• ツール/サービス/フレームワーク → entities/
• クロスセッションパターン → synthesis/

影響を受ける各プロジェクトについて、projects/<name>/<name>.md を作成/更新します。

書き込みルール

• 時系列ではなく、知識を蒸留
• 日付コンテキストが本質的でない限り、「日付 X に議論した」は回避
• 各新規/更新ページに summary: frontmatter を追加 (1～2 文、≤ 200 文字)
• すべての新規ページに確信度とライフサイクルフィールドを追加:

  base_confidence: 0.42
  lifecycle: draft
  lifecycle_changed: <ISO date today>
  

  更新時に lifecycle は変更しません。
• 出所マーカーを追加:
  • ^[extracted] 明示的なセッション/メモリーコンテンツに直接根拠がある場合
  • ^[inferred] 複数セッション全体でパターンを統合する場合
  • ^[ambiguous] セッションが矛盾する場合
• 変更されたページごとに provenance: frontmatter をミックスで追加/更新

ステップ 7: Manifest、ログ、インデックスを更新

.manifest.json を更新

処理した各ソースファイルについて:

• ingested_at, size_bytes, modified_at
• source_type: openclaw_memory | openclaw_daily_note | openclaw_session | openclaw_dreams
• agent_id: エージェント ディレクトリ名 (該当する場合)
• pages_created, pages_updated

トップレベルの要約ブロックを追加/更新:

{
  "openclaw": {
    "source_path": "~/.openclaw/",
    "last_ingested": "TIMESTAMP",
    "memory_updated_at": "TIMESTAMP",
    "daily_notes_ingested": 14,
    "sessions_ingested": 23,
    "pages_created": 6,
    "pages_updated": 18
  }
}

特別なファイルを更新

index.md と log.md を更新:

- [TIMESTAMP] OPENCLAW_HISTORY_INGEST memory=updated daily_notes=N sessions=M pages_updated=X pages_created=Y mode=append|full

hot.md — $OBSIDIAN_VAULT_PATH/hot.md を読みます (wiki-ingest のテンプレートから見つからない場合は作成)。Recent Activity を 1 行のサマリーで更新 — 例: 「OpenClaw MEMORY.md および 14 の日次ノートを取り込みました; 自動化パターンとマルチエージェント調整知識を表面化させました。」最後の 3 つの操作を保持します。updated タイムスタンプを更新します。

プライバシーと準拠

• 生のメモリーまたはトランスクリプトダンプを回避し、蒸留と統合
• 機密に見えるものすべてについてデフォルトで編集
• 個人情報または機密情報を保存する前にユーザーに確認
• 他の人への参照を最小限に、目的固有に保つ

リファレンス

フィールドレベルのノートと解析ガイダンスについては references/openclaw-data-format.md を参照してください。