lossless-claw – OpenClawのためのロスレス・コンテキスト管理

概要

• OpenClaw AIエージェントプラットフォーム用のプラグインで、デフォルトの固定ウィンドウによるコンテキスト切り捨てを「ロスレス・コンテキスト管理」(LCM) システムに置き換えます。
• すべてのメッセージをSQLiteデータベースに保存し、階層的な要約のDAGを構築するため、トークンウィンドウを超えてもモデルが情報を失うことはありません。

主要な概念

1. 永続化 – すべての生メッセージは lcm.db (SQLite) に書き込まれ、削除されることはありません。
2. 要約 – 古いチャンクは設定されたLLMによって要約され、要約はさらに高レベルのノードに凝縮されて有向非巡回グラフ (DAG) を形成します。
3. コンテキスト構築 – プラグインは各ターンで、最近の生メッセージと適切な要約ノードを取得し、モデルのトークン制限内に収めます。
4. リコールツール – lcm_grep、lcm_describe、lcm_expand などのコマンドにより、エージェントは圧縮された履歴を検索し、元のメッセージに遡ることができます。

操作方法

• CLI (lcm) – データベースを読み取り専用で操作するシェルスタイルのインターフェース。ステータスの確認、会話のリスト表示、メッセージの追跡、要約の表示、設定値 (freshTailCount) の調整が可能です。
• OpenClaw スラッシュコマンド – /lossless、/lossless backup、/lossless doctor、/lossless status などのチャット内コマンドで、診断、バックアップ作成、ヘルスチェック、メンテナンス操作を実行できます。
• プログラム用コントラクト – コンテキストエンジン制御をサポートするOpenClawゲートウェイ向けの最小限のホスト側API (status, doctor)。
• 移行ツール – lossless-claw-migrate-sessions を使用して、既存のOpenClaw JSONLセッションファイルをLCMデータベースにインポートします（ドライランがデフォルト、オプションで --apply）。

インストールとセットアップ

# 推奨 – OpenClawのプラグインインストーラーを使用
openclaw plugins install @martian-engineering/lossless-claw@latest

• plugin-context-engineをサポートするOpenClaw ≥ 2026.9.2 が必要です。
• Node 22+ が必要です。
• OpenClawでLLMプロバイダーを設定する必要があります。プラグインはそのプロバイダーを呼び出して要約を生成します。

設定

• OpenClawのJSON設定ファイルの plugins.entries に lossless-claw エントリを追加します（完全な例はREADMEを参照）。重要な設定項目：
  • freshTailCount – 要約から保護される最近のメッセージ数。
  • leafChunkTokens – リーフチャンクの要約をトリガーするトークン制限。
  • summaryModel / expansionModel – 要約および要約展開に使用するモデル。
  • 各種しきい値 (LCM_CONTEXT_THRESHOLD, LCM_PROACTIVE_THRESHOLD_COMPACTION_MODE など) – 圧縮の実行タイミングや、インラインか遅延実行かを制御します。
• 環境変数（LCM_ プレフィックス）でも同様の設定が可能です。

メンテナンスワークフロー

• 会話がトークンウィンドウを超えると、プラグインは「圧縮負債」(compaction debt) を記録します。
• /lossless doctor maintenance で負債をリストアップし、/lossless doctor apply … でバックアップ後に壊れた要約の修復や非アクティブな負債のクローズを試みます。
• データベースを変更する可能性のある書き込み操作の前に、自動的にバックアップが作成されます。

なぜ重要なのか

• 従来のエージェントは古いターンを失うため、長期的な対話や調査的な対話が中断される可能性があります。
• lossless-claw は完全な会話履歴を検索可能な状態で保持しつつモデルの制限内に収めるため、「決して忘れない」エージェントを実現します。
• DAG要約アプローチは軽量（SQLite + LLM呼び出し）で、OpenClawのプラグインアーキテクチャとクリーンに統合されます。

詳細情報

• アニメーションによる視覚化: https://losslesscontext.ai
• CLIドキュメント: docs/cli.md
• コンテキストエクスプローラーUI: OpenClawの Settings → Labs → Custom plugin UI。

---

上記の詳細はすべてリポジトリのREADMEから直接引用しています。