---

name: session-cleanup description: Clawdbotのセッションファイルを安全にクリーンアップし、パフォーマンスとAPI利用量を最適化するスキル。高トークン消費セッション・エラーセッションのアーカイブ、手順書と半自動化スクリプト付き。「セッションクリーンアップ」「API利用量削減」「パフォーマンス最適化」「セッションアーカイブ」などの作業に使う。

Session Cleanup Skill

Clawdbotのセッションファイルを安全にクリーンアップし、パフォーマンスとAPI利用量を最適化するスキル。

概要

Clawdbotは全ての会話履歴を ~/.openclaw/agents/*/sessions/ にJSONLファイルで永続化している。時間が経つにつれ、以下の問題が発生する：

• 高トークン消費セッション（10万tokens超）の蓄積
• エラー状態セッション（API制限等で動作不能）
• 完了済みタスクセッション（継続不要）
• パフォーマンス低下（sessions_listの応答遅延）

このスキルでは、重要なセッションを残しつつ、不要なセッションを安全にアーカイブする。

よくある落とし穴

• バックアップせずにセッションを削除する: 完全にバックアップしてから実行すること。アーカイブファイルは復旧可能な場所（~/.openclaw/sessions_archive/）に保存する
• 進行中プロジェクトのセッションを消す: 進行中プロジェクトのセッションは絶対に削除しない。メインチャンネルセッションも慎重に判断する。削除前に displayName と updatedAt で内容と最終更新を確認する
• sessions.json リネーム後に復旧方法を忘れる: リネーム（sessions.json_YYYYMMDD_HHMMSS）は最も効果的な手法だが、復旧が必要になった場合に備えてタイムスタンプを控えておく。ls -la ~/.openclaw/agents/*/sessions/sessions.json_* で確認可能
• Gateway 再起動を忘れる: セッションのアーカイブや sessions.json リネーム後は Gateway 再起動が推奨。再起動しないと古いセッション情報がメモリに残る場合がある

最も効果的な方法: sessions.json リネーム

2026-02-04 けいた発見: sessions.jsonファイルのサイズがClawdbotパフォーマンスに最も影響度が大きいことが判明。

sessions.jsonアーカイブ（推奨第一手順）

スクリプトで一括実行: scripts/archive-sessions-json.sh

効果: 一気にセッション情報が軽くなり、パフォーマンスが大幅改善。

復旧: scripts/restore-sessions-json.sh <timestamp> [agent-name]

事前分析

1. 現在のセッション状況確認

// sessions_listでセッション一覧を取得
sessions_list({
  limit: 50,
  messageLimit: 1
})

確認ポイント:

• totalTokens（高い順にソート）
• abortedLastRun: false（エラー状態）
• updatedAt（最終更新時刻）
• displayName（内容の推定）

2. クリーンアップ対象の特定

削除対象（優先順）:

1. エラー状態: "errorMessage"がある、または明らかに動作不能
2. 高トークン消費: 15万tokens以上（コンテキスト制限近い）
3. 完了済みタスク: 記事作成・プロジェクト完了報告済み
4. 7日以上非アクティブ: 重要性の低い古いセッション

保持対象:

• メインチャンネル（継続的会話）
• 進行中プロジェクト
• 重要な設定・決定記録
• 直近3日の主要セッション

アーカイブ手順

個別セッションのアーカイブは以下のいずれかで実行:

• スクリプト: scripts/archive-sessions.sh <session-id> <agent-name>
• 半自動化: cleanup-script.sh（対話的に実行）
• 手動手順の詳細: references/archive-procedure.md 参照

効果確認

1. セッション数の変化: sessions_list({limit: 50}) で確認
2. API利用量: session_status() で確認
3. パフォーマンステスト: sessions_listの応答時間、Gateway再起動時間、メモリ使用量

実績

2026-02-04（sessions.jsonリネーム手法発見）

• 最大の効果: sessions.jsonファイルサイズがパフォーマンス最大要因と判明
• リネーム効果: 一気にセッション情報が軽量化、レスポンス大幅改善
• 影響範囲: /Users/satokeita/.openclaw/agents/main/session/sessions.jsonが最重要

従来手法の実績（参考）

• セッション数: 50個 → 20個（60%削減）
• アーカイブファイル: 31個
• 週間API利用量: 59% → 25-30%（予想）
• エラーセッション: 全て除去
• 最大セッション: 162K tokens → 121K tokens以下

実行タイミング・優先順位

第一選択: sessions.jsonリネーム

以下の症状が出たら即座に実行：

• sessions_listの応答が遅い（3秒以上）
• Gateway起動時間が長い
• Clawdbot全体のレスポンス低下

第二選択: 個別セッションアーカイブ

推奨頻度: 月1回または以下の状況時

• 週間API利用量が50%を超えた
• エラーセッションが蓄積している
• 特定エージェントのトークン使用量が異常に高い

実行前チェック

• 重要プロジェクトの進行状況確認
• 最近の主要会話の識別
• sessions.jsonの現在サイズ確認: ls -lah ~/.openclaw/agents/*/sessions/sessions.json

カスタマイズ

環境に応じて以下をカスタマイズ：

1. トークン閾値: 15万tokens → 10万tokensに調整
2. 保持期間: 7日 → 3日または14日に調整
3. アーカイブ場所: 外部ストレージへの移動
4. 自動化: cronジョブでの定期実行

トラブルシューティング

詳細は references/troubleshooting.md を参照。