mcpField
T
token-optimizer

token-optimizer

github.com/smartpeopleconnectedエージェントワークフロー771 回インストール36 週間前に更新
リポジトリ

token-optimizer について

token-optimizerは、モデルの振り分け、ハートビートの接続先選択、セッションコンテキスト管理、キャッシュでOpenClawのトークン使用量を抑えるコマンドラインスキルです。設定のプレビュー、バックアップの復元、ヘルスチェック、削減レポートにも対応します。

主な機能

  1. 01タスクに応じたモデルの振り分け
  2. 02複数のハートビート接続先または無効化
  3. 03セッションコンテキストの縮小
  4. 04キャッシュによるプロンプト再利用
  5. 05変更のプレビューと設定バックアップの復元
  6. 06ヘルスチェックと削減レポート

活用シーン

  1. 01タスクに合わせたOpenClawのモデル選択
  2. 02Ollama、LM Studio、Groqへのハートビート振り分け
  3. 03適用前の設定変更プレビュー
  4. 04以前のOpenClaw設定の復元

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/smartpeopleconnected/openclaw-token-optimizer --skill token-optimizer

インストール後、Claude Code で/token-optimizerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.clawhubignore
_meta.json
setup.py
.gitignore
README.md
LICENSE
CHANGELOG.md
cli.py
requirements.txt
skill.json
.github/
FUNDING.yml
src/
__init__.py
colors.py
analyzer.py
optimizer.py
verify.py
templates/
openclaw-config-optimized.json
OPTIMIZATION-RULES.md
USER.md
SOUL.md
test/
simulation_test.py

詳細

OpenClaw 向けトークンオプティマイザー

AI のコストを月額 1,500 ドル以上から 50 ドル未満に削減します。

問題

OpenClaw のデフォルト設定は、コストよりも性能を優先します。Haiku で十分に処理できるタスクに高価な Sonnet／Opus のトークンを消費し、ローカルで無料実行できる API ハートビートに料金を払い、8 KB で足りるコンテキストに 50 KB を読み込んでいます。

解決策

4 つの主要な最適化と、強力なツールを提供します。

モデルルーティング（92％の節約）

デフォルトでは Haiku を使用し、必要な場合にのみ Sonnet／Opus を使用します

マルチプロバイダーのハートビート（100％の節約）

ハートビートを Ollama、LM Studio、Groq にルーティングするか、完全に無効にできます。プロバイダーを 1 つに限定しません。

セッション管理（80％の節約）

コンテキストの読み込みを 50 KB から 8 KB に削減します

キャッシュ（90％の節約）

プロンプトを再利用し、コストを 10％に抑えます

v1.0.8 の新機能
  • ロールバック - 設定バックアップの一覧表示と復元をすぐに実行
  • ヘルスチェック - 1 つのコマンドでシステムの状態をすばやく確認
  • 差分プレビュー - 適用前に変更内容を正確に確認
  • --no-color - CI／パイプラインに適した出力

コスト比較

期間導入前導入後
日額2～3 ドル0.10 ドル
月額70～90 ドル3～5 ドル
年額800 ドル以上40～60 ドル

内容

  • 差分プレビュー付きのワンコマンド最適化ツール
  • マルチプロバイダーのハートビート（Ollama、LM Studio、Groq）
  • 設定のロールバックとヘルスチェックのコマンド
  • すぐに使える設定テンプレート
  • SOUL.md と USER.md のテンプレート
  • エージェントのプロンプト向け最適化ルール
  • 検証レポートと節約レポート

このツールが変更する内容

すべての変更は ~/.openclaw/ 配下に書き込まれます。変更前にバックアップが作成されます。

パス用途
~/.openclaw/openclaw.jsonOpenClaw のメイン設定（モデルルーティング、ハートビート、予算）
~/.openclaw/backups/タイムスタンプ付きの設定バックアップ（自動作成）
~/.openclaw/workspace/テンプレートファイル（SOUL.md、USER.md、IDENTITY.md）
~/.openclaw/prompts/エージェントのプロンプト最適化ルール
~/.openclaw/token-optimizer-stats.json節約レポート用の使用状況統計

デフォルトで安全 - すべてのコマンドはドライラン（プレビュー）モードで実行されます。変更を書き込むには --apply を渡してください。

クイックスタート

# Install
clawhub install token-optimizer

# Analyze current setup
python cli.py analyze

# Preview changes (dry-run by default)
python cli.py optimize

# Apply all optimizations
python cli.py optimize --apply

# Verify setup
python cli.py verify

# Quick health check
python cli.py health

# Configure heartbeat provider (preview)
python cli.py setup-heartbeat --provider ollama

# Configure heartbeat provider (apply)
python cli.py setup-heartbeat --provider ollama --apply

# List and restore backups
python cli.py rollback --list
python cli.py rollback --to <backup-file>

生成される設定

{
  "agents": {
    "defaults": {
      "model": { "primary": "anthropic/claude-haiku-4-5" },
      "cache": { "enabled": true, "ttl": "5m" }
    }
  },
  "heartbeat": {
    "provider": "ollama",
    "model": "ollama/llama3.2:3b"
  },
  "budgets": {
    "daily": 5.00,
    "monthly": 200.00
  }
}

リンク

作者

Smart People Connected

ライセンス

MIT License - 自由に使用、変更、配布できます。

セットアップは 5 分。コストを 97％削減。トークンの浪費をやめて、開発を始めましょう。

コメント

Markdown 対応