token-optimizer

OpenClaw Token Optimizer v3.2.0

Asif2BD が現在の OpenClaw 2026.6.x エージェント向けに開発 · GitHub · セキュリティに関する注意事項

セキュリティに関する注意： ローカル専用の最適化ツールキットです。Python スクリプトはネットワークリクエストを行わず、動的コードも実行しません。ファイルを書き込むコマンドは明示され、ドキュメント化されており、バックアップで保護されます。

---

インストール

openclaw skills install @asif2bd/openclaw-token-optimizer

---

v3.2 の新機能

最新の ClawHub カード

スキルカードでは、従来の長文形式だった v3.0 の説明に代わり、より明確な製品の特長、現在の OpenClaw との互換性、セキュリティ体制、実用的なコマンドを先に示すようになりました。

最新の OpenClaw モデルルーティング

通常の Anthropic の作業は anthropic/claude-sonnet-4-5 に割り当て、明示的に複雑な推論が必要な場合にのみ anthropic/claude-opus-4-5 にルーティングします。

監査に配慮した書き込み

• context_optimizer.py generate-agents は、デフォルトで標準出力に出力します。
• 最適化した AGENTS.md を書き込むには、--output または --workspace-output が必要です。
• ./scripts/optimize.sh heartbeat は、デフォルトではプレビューのみを行います。
• ./scripts/optimize.sh heartbeat install は、既存のファイルをバックアップしてから HEARTBEAT.md を書き込みます。

---

最適化する内容

コンテキストの読み込み

すべてのワークスペースファイルをすべてのセッションで読み込むのをやめます。現在のプロンプトに必要なコンテキストだけを推奨します。

python3 scripts/context_optimizer.py recommend "hi"

一般的な結果：挨拶には SOUL.md と IDENTITY.md のみを使用します。

モデルルーティング

標準的な作業には Sonnet を使い、深い推論が必要な場合に限って Opus を使用します。

python3 scripts/model_router.py "thanks!"
python3 scripts/model_router.py "design a multi-agent architecture"

ハートビートのスケジュール設定

期限が来たチェックのみを実行し、静穏時間を守り、ハートビートのタイミングをプロンプトキャッシュの TTL に合わせます。

python3 scripts/heartbeat_optimizer.py plan
python3 scripts/heartbeat_optimizer.py cache-ttl

トークン予算

ローカルで日次予算の状態を追跡し、支出が急増する前に警告を提示します。

python3 scripts/token_tracker.py check

---

クイックスタート

1. リクエストに必要な最小限のコンテキストを確認する

python3 scripts/context_optimizer.py recommend "write a deployment checklist"

2. 最適化した AGENTS.md をプレビューする

python3 scripts/context_optimizer.py generate-agents

明示的に依頼した場合にのみ、レビュー用コピーを保存します。

python3 scripts/context_optimizer.py generate-agents --output ~/.openclaw/workspace/AGENTS.md.optimized

3. ハートビートのインストールをプレビューする

./scripts/optimize.sh heartbeat

バックアップ保護付きでインストールします。

./scripts/optimize.sh heartbeat install

4. タスクをルーティングする

python3 scripts/model_router.py "debug this error"

---

節約の概要

領域	一般的な無駄	オプティマイザーのアプローチ
起動時のコンテキスト	毎回、ドキュメント、メモリ、ツール、古いログを読み込む	プロンプトに必要なものだけを遅延読み込みする
通常のモデル使用	簡単な返信や単純な確認にも Opus を使う	通常の作業には Sonnet、複雑な推論には Opus を使う
ハートビート	すべてのチェックを毎回のハートビートで実行する	期限チェックプランナー + 静穏時間
キャッシュ TTL	アイドル状態のセッションが高コストなキャッシュの再書き込みを引き起こす	キャッシュ TTL が 1 時間の場合、55 分間隔のハートビートを推奨
予算管理	支出額を後から把握する	高コストの作業の前にローカルで予算を確認する

節約の見込み：コンテキストを多用する OpenClaw ワークスペースでは 50～80%。通常、コンテキストの最適化が最も大きな効果をもたらします。

---

ファイル

スクリプト

• scripts/context_optimizer.py — プロンプトの分類とコンテキストバンドルの推奨
• scripts/model_router.py — Sonnet／Opus を考慮したタスクルーティング
• scripts/heartbeat_optimizer.py — 期限チェックの計画、静穏時間、キャッシュ TTL に基づく間隔の推奨
• scripts/token_tracker.py — ローカルでの予算追跡
• scripts/optimize.sh — 同梱スクリプトを使いやすくするラッパー

アセット

• assets/HEARTBEAT.template.md — バックアップに配慮したハートビートテンプレート
• assets/cronjob-model-guide.md — スケジュール済みタスクのモデルに関するガイダンス
• assets/config-patches.json — ネイティブ設定と任意設定の例

参考資料

• references/PROVIDERS.md — 外部プロバイダー戦略に関する任意のメモ
• SECURITY.md — セキュリティとデータの取り扱いに関する詳細

---

セキュリティ体制

• 実行可能なスクリプトからネットワークへの呼び出しはありません
• eval、動的インポート、シェルコマンドの実行、ダウンロード処理はありません
• ローカルの JSON 状態は、OpenClaw ワークスペースのメモリディレクトリ内にのみ保存されます
• ワークスペースへの書き込みには、明示的なコマンドが必要です
• 既存の HEARTBEAT.md は、置き換える前にバックアップされます
• .clawhubsafe は、公開されるすべてのファイルを SHA256 ハッシュで対象にします

ローカルで確認します：

sha256sum -c .clawhubsafe

---

OpenClaw のネイティブ診断

このスキルと併せて、OpenClaw の組み込みコンテキストコマンドと使用状況コマンドを使います：

/context list
/context detail
/usage tokens
/usage cost

組み込み機能でトークンの使用状況を確認し、Token Optimizer で繰り返し発生する無駄を減らします。

---

最適な用途

• 大きな指示ファイルを持つ、複数エージェントの OpenClaw ワークスペース
• ハートビートやスケジュールされたチェックを実行するエージェント
• 日常的な作業ではなく、難しい作業に Opus を使い続けたいチーム
• ユーザー間で節約したプロンプトトークンの効果が積み重なる、xCloud、MissionDeck などのホスト型 OpenClaw デプロイ

---

Asif2BD のその他の作品

openclaw skills install @asif2bd/jarvis-mission-control
openclaw skills search asif2bd