Openclaw向けSession Compactor

初期のメッセージ履歴を簡潔で高密度な要約に圧縮し、トークン消費を最適化する自動セッション管理ツール。

fangbb-coder
v1.0.0
Apr 2, 2026
0
754
0

インストール&ダウンロード

1. ClawHub CLI

レジストリから直接スキルをインストールする最速の方法です。

npx clawhub@latest install session-compactor

2. 手動インストール

スキルフォルダを以下のいずれかの場所にコピーしてください

グローバル
~/.openclaw/skills/
ワークスペース
<project>/skills/

優先順位:ワークスペース > ローカル > バンドル

3. プロンプトのインストール

このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。

Clawhubを使って session-compactor をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください(npm i -g clawhub)。

ダウンロードをご希望ですか?

ZIPアーカイブで生のスキルファイルを取得します。

Session Compactor とは?

Session Compactor は、AI Agent との長期間の対話を管理するために設計された専用ユーティリティです。対話が長くなると、コンテキストウィンドウを大量に消費し、運用コストが増大します。このスキルは、トークン数を監視し、古いメッセージを構造化された要約にプログラムで置き換えることで、これらの課題に対処します。これにより、Agent は重要なコンテキスト、ツール実行履歴、主要な事実を保持しながら、新しいやり取りのためのスペースを確保できます。Session Compactor を Openclaw Skills スイートに統合することで、長期間にわたってコスト効率とコンテキスト認識を維持する高性能な AI ワークフローを実現できます。

Session Compactor のユースケース

  • メッセージ数が 30 を超え、モデルのコンテキスト制限に近づいているセッションの管理。
  • 長文の対話における繰り返しのトークン送信を最小限に抑え、運用コストを削減。
  • 重要度の低い冗長なチャット履歴を破棄しつつ、重要なツール実行結果を保存。
  • 複雑な推論やコーディングタスクを開始する前に、会話履歴を手動で最適化。

Session Compactor の仕組み

  1. トークン推定:このスキルはヒューリスティック手法(1 トークンあたり約 4 文字)を使用して、現在のセッション長を計算します。
  2. しきい値検出:現在のトークン数がユーザー定義の maxTokens 制限を超えていないか常にチェックします。
  3. 対象選択:アルゴリズムは圧縮対象の古いメッセージを特定し、最新のメッセージがそのまま保持されるようにします。
  4. 要約生成:セッションの核心目標、ツール呼び出しの結果、重要な事実を 1 つの構造化された要約に抽出します。
  5. メッセージ置換:初期の履歴は、要約を含むシステムメッセージに永久的に置き換えられ、トークンのフットプリントを大幅に削減します。

Session Compactor のセットアップ

このスキルを有効にするには、openclaw.config.json 設定ファイルを更新してください:

{
  "skills": {
    "session-compactor": {
      "enabled": true,
      "maxTokens": 3000,
      "minMessagesToKeep": 5,
      "autoCompact": true
    }
  }
}

CLI を介して手動でセッション圧縮をトリガーするには、次のコマンドを使用します:

openclaw tools call compact_session '{"force": true}'

Session Compactor のデータスキーマとタクソノミー

このスキルは、以下のパラメーターとメタデータ分類法を通じてセッションデータを整理します:

パラメーター 型 デフォルト 説明
maxTokens number 3000 自動圧縮をトリガーするトークンのしきい値。
minMessagesToKeep number 5 詳細を保持する最近のメッセージの最小数。
autoCompact boolean true セッション更新時のバックグラウンド圧縮の有効/無効を切り替えます。
force boolean false トークン数に関係なく、手動でセッション圧縮を強制的に実行します。

Session Compactor の高度な機能

  • ヒューリスティック最適化:外部 API 呼び出しなしでトークン使用量を正確に推定する、高性能な実装に基づいたロジックを使用。
  • 自動ライフサイクル管理:シームレスなバックグラウンド実行により、ユーザーの介入なしで Openclaw Skills をコンテキスト制限内に維持。
  • 不可逆圧縮:初期のメッセージ詳細が要約された後、永久に削除することでスペースを最大化。
  • 構造化された事実の保持:汎用的な要約ツールでは失われる可能性のあるツール呼び出し構造と主要なメタデータを保持するように特別に設計。

SKILL.md


ローディング

関連するOpenclawのスキル

METADATA

Github Stars: 0
forks: 0

特徴*