name: session-cleanup
Clawdbotのセッションファイルを安全にクリーンアップし、パフォーマンスとAPI利用量を最適化するスキル。
Clawdbotは全ての会話履歴を ~/.openclaw/agents/*/sessions/ にJSONLファイルで永続化している。時間が経つにつれ、以下の問題が発生する:
sessions_listの応答遅延)このスキルでは、重要なセッションを残しつつ、不要なセッションを安全にアーカイブする。
~/.openclaw/sessions_archive/)に保存するdisplayName と updatedAt で内容と最終更新を確認するsessions.json_YYYYMMDD_HHMMSS)は最も効果的な手法だが、復旧が必要になった場合に備えてタイムスタンプを控えておく。ls -la ~/.openclaw/agents/*/sessions/sessions.json_* で確認可能2026-02-04 けいた発見: sessions.jsonファイルのサイズがClawdbotパフォーマンスに最も影響度が大きいことが判明。
スクリプトで一括実行: scripts/archive-sessions-json.sh
効果: 一気にセッション情報が軽くなり、パフォーマンスが大幅改善。
復旧: scripts/restore-sessions-json.sh <timestamp> [agent-name]
// sessions_listでセッション一覧を取得
sessions_list({
limit: 50,
messageLimit: 1
})
確認ポイント:
totalTokens(高い順にソート)abortedLastRun: false(エラー状態)updatedAt(最終更新時刻)displayName(内容の推定)削除対象(優先順):
"errorMessage"がある、または明らかに動作不能保持対象:
個別セッションのアーカイブは以下のいずれかで実行:
scripts/archive-sessions.sh <session-id> <agent-name>cleanup-script.sh(対話的に実行)references/archive-procedure.md 参照sessions_list({limit: 50}) で確認session_status() で確認sessions_listの応答時間、Gateway再起動時間、メモリ使用量sessions.jsonファイルサイズがパフォーマンス最大要因と判明/Users/satokeita/.openclaw/agents/main/session/sessions.jsonが最重要以下の症状が出たら即座に実行:
sessions_listの応答が遅い(3秒以上)推奨頻度: 月1回または以下の状況時
ls -lah ~/.openclaw/agents/*/sessions/sessions.json環境に応じて以下をカスタマイズ:
詳細は references/troubleshooting.md を参照。