clawrouter

ClawRouter

ホスト型ゲートウェイを利用する LLM ルーターです。各リクエストを blockrun.ai ゲートウェイに転送し、9 社のプロバイダーが提供する 90 種類のモデル（無料のオープンウェイトモデル 7 種類）の中から、処理可能な最安モデルを選ぶことで、推論コストを 84% 削減します。請求はすべて 1 つの BlockRun 認証情報を通じて行われます。USDC ウォレットで呼び出しごとに x402 で支払う方法と、カードでチャージしたアカウント残高を使う BlockRun API キーの方法があります。どちらの場合も、プロバイダーの API キーを保有する必要はありません。

これはローカル推論ツールではありません。 ClawRouter はシンプルなローカルプロキシです。プロンプトは HTTPS 経由で blockrun.ai ゲートウェイに送信され、そこでモデルが実行されます。ワークロードの推論をマシンから一切外部に出せない場合は、Ollama などのローカルランタイムを使用してください。その用途には ClawRouter は適していません。

ソース：https://github.com/BlockRunAI/ClawRouter · npm：https://www.npmjs.com/package/@blockrun/clawrouter · ライセンス：MIT。

データフロー

Your app → localhost proxy (ClawRouter) → https://blockrun.ai/api  (or sol.blockrun.ai/api)
                                              ↓
                                        OpenAI / Anthropic / Google / etc.
                                              ↓
                                        Response → back through proxy → your app

リクエストごとに blockrun.ai へ送信されるもの： モデル名、プロンプト／メッセージ本文全体、サンプリングパラメーター（temperature、max_tokens、tools など）、および支払い認証情報です。ウォレットモードでは署名済み x402 USDC マイクロペイメントを含む X-PAYMENT ヘッダー、API キーモードでは Authorization: Bearer brk_live_… ヘッダーが送信されます。

送信されないもの： ウォレットの秘密鍵（送信されるのは分離された支払い署名のみです）、その他のローカルファイル、環境変数、このリクエストに必要な範囲を超える OpenClaw の設定です。

Blockrun のプライバシー方針： https://blockrun.ai/privacy。プロンプトは、ホスト型の LLM API（OpenAI、Anthropic など）に送信する場合と同様に扱ってください。サードパーティの API プロバイダーと共有できないデータは送信しないでください。

認証情報とローカルでのキー保存

ClawRouter は、サードパーティプロバイダーの API キーを収集も転送もしません。OpenAI、Anthropic、Google、DeepSeek、xAI、NVIDIA の認証情報を提供する必要はありません。これらの関係は blockrun.ai ゲートウェイが管理します。

models.providers.blockrun に保存される内容（全項目）：

フィールド	機密情報かどうか	用途
walletKey	ウォレットモードの場合のみ	x402 経由で USDC のマイクロペイメントに署名するための EVM 秘密鍵です。初回実行時にローカルで自動生成されます。ユーザーによる入力は不要です。ネットワーク経由で送信されることはありません。送信されるのは、分離された支払い署名のみです。BlockRun API キーが設定されている場合は、使用、読み取り、生成のいずれも行われません。
solanaKey	はい	Solana のキーペア（BIP-44 m/44'/501'/0'/0'）です。@scure/bip32 と @scure/bip39 を使用して、同じローカルニーモニックから自動的に導出されます。
gateway	いいえ	ゲートウェイ URL です。デフォルトは https://sol.blockrun.ai/api（Solana、新規インストール時のデフォルトチェーン）と https://blockrun.ai/api（Base、既存インストール時のデフォルト）です。
routing	いいえ	router-core 設定（ティアチェーン、strategy: "rules" へのロールバック、shadow 比較、スコアラーのキーワード）を任意で上書きします。

キーの保存方法と保存場所：

• キーは OpenClaw のユーザー設定ファイル（Linux では通常 ~/.config/openclaw/config.json、macOS では ~/Library/Application Support/openclaw/config.json、Windows では %APPDATA%\openclaw\config.json）の models.providers.blockrun パスに保存されます。
• POSIX システムでは、OpenClaw 標準の設定書き込み機能により、権限 0600（所有者のみ読み取り・書き込み可能）で書き込まれます。
• 平文で保存されます。OpenClaw のすべてのプロバイダーの API キーと同じ方式です。ClawRouter は追加の暗号化レイヤーを設けません。ファイルシステムのアクセス権限がセキュリティ境界となります。暗号化されたキーストアが必要な場合は、暗号化ボリューム（FileVault、LUKS、BitLocker）上で OpenClaw を実行するか、使用予定額のみを入金した専用の使い捨てウォレットを使用してください。
• 自動生成では @scure/bip39 を使用して 24 語のニーモニックを作成し、続いて両チェーンの BIP-44 導出を行います。ソースコード： src/wallet.ts。

運用上のガイダンス： ウォレットは長期的な価値の保管場所ではなく、少額をチャージした支払い用アカウントとして扱ってください。LLM 呼び出しに使う予定の金額を入金してください。ホストマシンが侵害された場合、ウォレットキーも侵害されます。キーをローテーションし、資金を払い戻してください。

サプライチェーンの完全性

• すべてのリリースに GitHub タグが付与されます：https://github.com/BlockRunAI/ClawRouter/releases
• すべてのリリースは、対応するバージョンで npm に公開されます：https://www.npmjs.com/package/@blockrun/clawrouter?activeTab=versions
• skills/release/SKILL.md の必須チェックリストにより、package.json のバージョン、対応する git タグ、GitHub リリース、npm 公開の一致が徹底されます。
• ローカルで確認するには、npm pack @blockrun/clawrouter@<version> を実行し、tarball の内容をタグ付けされたコミットと比較してください。

インストール

openclaw plugins install @blockrun/clawrouter

上記の構造化された install ブロックにより、OpenClaw は監査可能な npm パッケージ @blockrun/clawrouter をインストールします。すべてのバージョンのソースは GitHub で公開されており、各リリースにはタグが付けられています。

セットアップ

# Enable smart routing (auto-picks cheapest model per request)
openclaw models set blockrun/auto

# Or pin a specific model
openclaw models set openai/gpt-4o

ルーティングの仕組み

ルーティングは、ClawRouter にインライン化され、コミットに固定された @blockrun/router-core（Router Core V3.4、制約優先）によってローカルで行われます。ネットワーク呼び出しも、2つ目のモデルも不要で、リクエストあたり約0.25ミリ秒です。

1. 15次元の重み付きスコアラーが各リクエストを4つのティアのいずれかに分類し、タスク分類器が作業の種類（chat、extraction、code_edit、code_agent、tool_agent、reasoning_math、long_context、vision、…）にラベルを付けます。
2. リクエストを満たせないモデル（ツール呼び出し非対応、ビジョン非対応、コンテキストウィンドウや最大出力が小さすぎる、構造化出力との互換性がないモデル）は、スコアリングを行う前に除外されます。
3. 残ったモデルをタスク品質、機能、推定コスト、速度、信頼性に基づいて順位付けし、タイムアウトや5xxに備えたフォールバックチェーンとして、順位付きリスト全体を保持します。

デフォルトの auto プロファイルにおける、厳選されたプライマリモデル：

• SIMPLE — 事実の確認、あいさつ、翻訳 → gemini-2.5-flash
• MEDIUM — 要約、解説、データ抽出 → kimi-k2.7
• COMPLEX — コード生成、多段階の分析 → gemini-3.1-pro
• REASONING — 証明、形式論理、多段階の数学 → grok-4-1-fast-reasoning

実際に添付されたツールを必要とするターンは、エージェント向けに調整されたティア（gpt-4o-mini → kimi-k2.7 → claude-sonnet-4.6）に切り替わります。eco は無料ティア（nemotron-3.5-lightning）から開始し、premium は gpt-5.3-codex / claude-fable-5 / claude-sonnet-4.6 まで段階的に上がります。すべてのチェーンについては、docs/routing-profiles.md をご覧ください。

ティアごとの 節約率は、意図的に記載していません。公表されている数値は 明示されたワークロード構成全体での平均値であり、ティア別の数値を示すと、 誰も明記していないベースラインと比較されるおそれがあるためです。詳しくは savings-mix.json をご覧ください。

利用可能なモデル

90種類のモデルが含まれます。gpt-6-astra [GPT-6 フラグシップ、1M ctx]、gpt-6-sol、gpt-6.1-sol [更新版 Sol]、gpt-6-luna [高速]、gpt-5.6-terra [バランス型、安定したデフォルト]、gpt-5.6-sol [フラグシップ]、gpt-5.6-luna [コスト効率型]、gpt-5.6-sol/terra/luna-pro [プロ向け推論ティア]、gpt-5.5、gpt-5.5-pro [最大計算能力]、chat-latest [ChatGPT Instant]、gpt-5.4、gpt-5.1、gpt-4o、o3、claude-fable-5.1、claude-fable-5、claude-opus-5.5 [最新の Opus]、claude-opus-5 [1M ctx]、claude-opus-4.8、claude-opus-4.7、claude-opus-4.5、claude-sonnet-5.5、claude-sonnet-5、claude-sonnet-4.6、gemini-3.1-pro、gemini-3.6-flash、gemini-3.5-flash-lite、gemini-2.5-flash、deepseek-v4-pro、deepseek-chat、grok-4.7、grok-4.6、grok-4.5、grok-4.3、grok-build-0.1、glm-5.3 [Z.AI フラグシップ、1M ctx]、glm-5.3-flash [ネイティブなマルチモーダル対応、1M ctx]、glm-5.2、minimax-m3、kimi-k3 [1M ctx フラグシップ]、kimi-k2.7、qwen3.8-max [Qwen 3.8 フラグシップ、1M ctx]、qwen3.7-max、qwen3.7-plus、qwen3.7-flash、mimo [Xiaomi MiMo-V2.5 Pro、1M ctx]、mistral-large-4 [Mistral フラグシップ、512K ctx、ビジョン対応]、hy4-preview [Tencent、770B MoE]、laguna-s-2.1 [Poolside、コーディング]、および7種類の無料オープンウェイトモデル（nemotron-3.5-lightning [1M ctx、思考モード — 無料のデフォルト]、nemotron-3-ultra-550b [550B/55B MoE、1M ctx — 最大の無料モデル]、nemotron-3-nano-omni-30b-a3b-reasoning [256K ctx]、llama-3.2-11b-vision [Meta Llama]、north-mini-code [Cohere、コーディング、1秒未満]、laguna-xs-2.1 [Poolside、コーディング、約161 tok/s]、muse-glimmer-30b [Meta Muse、推論]）。無料ティアはテキスト専用です。画像を含むターンは、有料のビジョンモデルにルーティングされます。カタログ上でビジョン対応とされている2つの無料モデルは、どちらのチェーンでも単色画像のプローブに正しく応答できず、HTTP 200を返すためです。

モデル価格 — 最新情報を確認

モデル価格は変動するため（ベンダーによる価格改定やプロモーションの終了など）、このスキルにはモデル価格表を含めていません。呼び出しの予算を立てる前に、最新のカタログを確認してください：

curl -s https://blockrun.ai/api/v1/models       # Base
curl -s https://sol.blockrun.ai/api/v1/models   # Solana

data[] の各エントリには、id、billing_mode、pricing オブジェクトが含まれています。金額はすべて USD です。

billing_mode	pricing のフィールド	1 回の呼び出しの推定コスト
paid（チャット）	100 万トークンあたりの input、output、任意の cache_read / cache_write、任意の long_context	(input_tokens × input + output_tokens × output) / 1,000,000、最低 $0.001、さらに $0.001 の取引手数料
free	input: 0、output: 0	$0 — 支払い不要
per_image	per_image、transaction_fee	per_image × images + transaction_fee
per_second	per_second、per_call_surcharge、transaction_fee、default_duration_seconds	per_second × seconds + per_call_surcharge + transaction_fee
per_track	per_track、transaction_fee	per_track + transaction_fee
per_character	per_1k_chars、transaction_fee	per_1k_chars × characters / 1,000 + transaction_fee
per_generation	per_generation、transaction_fee	per_generation + transaction_fee

• キャッシュされたプロンプトトークンは、モデルに料金が記載されている場合、input の代わりに cache_read で請求されます（キャッシュへの書き込みには cache_write が適用されます）。
• long_context はティアのリストです。プロンプトがティアの threshold を超える場合（または inclusive が true なら同値の場合）、そのティアの input / output / cache_* 料金がリクエスト全体に適用されます。
• 画像サイズや品質、動画の解像度によって、メディア料金が記載された基本料金を上回る場合があります。
• 上記の金額は推定です。正確な金額は、署名の前に HTTP 402 チャレンジで提示されるため、呼び出しの決済額が提示額を超えることはありません。
• 人が読みやすい料金表：https://blockrun.ai/pricing

組み込みエージェントツール

LLM のルーティングに加えて、ClawRouter は BlockRun の x402 で保護されたデータ API を、すぐに使える OpenClaw ツールとして公開します。すべてのツールは同じ USDC ウォレットから支払われるため、追加の設定や API キーは不要です。

市場データ

すべての資産クラスにわたるリアルタイム価格と過去のOHLCデータを提供します。エージェントは金融サイトをスクレイピングする代わりに、これらを直接呼び出してください。

ツール	対応範囲	価格
blockrun_stock_price	12の主要市場：米国（NYSE/Nasdaq）、香港、日本、韓国、英国、ドイツ、フランス、オランダ、アイルランド、ルクセンブルク、中国、カナダ	$0.001 / call
blockrun_stock_history	1/5/15/60/240分、またはD/W/M単位のOHLCバー	$0.001 / call
blockrun_stock_list	市場ごとのティッカー検索／企業名検索	無料
blockrun_crypto_price	BTC-USD、ETH-USD、SOL-USDなど	無料
blockrun_fx_price	EUR-USD、GBP-USD、JPY-USDなど	無料
blockrun_commodity_price	XAU-USD（金）、XAG-USD（銀）、XPT-USD（プラチナ）	無料

画像・動画生成

ツール	目的	価格
blockrun_image_generation	12 種類の画像モデル — GPT Image 1/2/2.5（Flare、Sunburst）、Nano Banana / 2 / Pro、Seedream 5 Pro、Grok Imagine / 2.0 / Pro、CogView-4	モデルごと — モデルの価格を参照
blockrun_image_edit	既存の画像を編集／インペイントします（GPT Image 1/2、2.5 Sunburst、Nano Banana。model パラメーターで指定）	モデルごと — モデルの価格を参照
blockrun_video_generation	Grok Imagine と ByteDance Seedance（1.5-pro / 2.0-fast / 2.0）。720p、音声同期対応（デフォルトは t2v）、5〜10 秒。さらに、Azure 経由の OpenAI Sora 2（azure/sora-2、4/8/12 秒、t2v + i2v。参照画像に人物の顔が含まれる場合は拒否）。Seedance の料金は上流でトークン単位で設定されています（720p+音声のデフォルトでは約 20,256 トークン／秒 — 従来の 480p の 2 倍）。image_url（画像から動画への生成）の料金は、2026-06-01 以降 t2v と同じです。Seedance 2.0 の各バリアントでは、BytePlus RealFace によるキャラクターの一貫性維持に、オプションで real_face_asset_id（ta_…）を指定できます。この指定は image_url と併用できません。	モデルごと — モデルの価格を参照

電話と音声（Twilio + Bland.ai）

電話番号を確認し、AI を活用した発信通話を行います。実環境に影響する操作のため、blockrun_voice_call はユーザーから通話の発信を明示的に依頼された場合にのみ呼び出してください。サーバーでは緊急通報番号のブロックリストを適用しますが、ClawRouter では適用されません。

ツール	用途	料金
blockrun_phone_lookup	任意の E.164 番号のキャリアと回線種別（モバイル／固定電話／VoIP）	$0.01
blockrun_phone_lookup_fraud	SIM スワップと着信転送に関する不正利用のシグナル（SMS コードを使うフローの前に使用）	$0.05
blockrun_phone_numbers_buy	このウォレットに紐付けられた米国／カナダの番号を取得（30 日間のリース）	$5.00
blockrun_phone_numbers_renew	ウォレット所有の番号のリース期間を 30 日延長	$5.00
blockrun_phone_numbers_list	ウォレットが現在所有する番号と有効期限を一覧表示	$0.001
blockrun_phone_numbers_release	ウォレット所有の番号をプールに返却	無料
blockrun_voice_call	Bland.ai 経由の AI 発信通話 — 最大 30 分、文字起こし＋録音	一律 $0.54
blockrun_voice_status	通話のステータス／文字起こし／録音を確認	無料

音声通話はファイア・アンド・フォーゲット方式です。POST はすぐに call_id と poll_url を返し、通話自体はクラウド上で最大 30 分間実行されます。in_progress の間は 10～30 秒ごとに blockrun_voice_status をポーリングし、文字起こしを取得してください。スラッシュコマンド：/cr-call +1<E.164> "<task>" [--voice nat] [--max-duration 5]。CLI：clawrouter phone numbers list/buy/renew/release および clawrouter phone lookup/fraud <+E.164>。通話フローの全リファレンスについては、phone スキルを参照してください。

予測市場（Predexon）

Polymarket、Kalshi、Limitless、Opinion、Predict.Fun、dFlow に加え、暗号資産のローソク足データ向けの Binance を網羅する、予測市場向けの包括的なツールボックスです。57 個のエンドポイント（Predexon v2）を 9 個のエージェントツール（使いやすい名前付きラッパー 8 個＋汎用ツール 1 個）として公開しています。

• 市場と取引 — イベント、プラットフォーム別の市場一覧、プラットフォーム横断検索（markets/search）、オーダーブック、ローソク足（市場別およびトークン別）、取引、ポジション、取引高チャート。
• ランキングとスマートマネー — 全体および市場別のランキング、スマートマネーのポジション、上位保有者、スマートアクティビティのフィード。
• ウォレット分析 — ウォレットの完全なプロフィール、損益の時系列データ、市場別の内訳、類似ウォレットの検索、複数ウォレットの一括プロフィール、AND／OR フィルター。
• UMA オラクルとウォレット ID — UMA オプティミスティック・オラクルの解決状況（uma/markets、uma/market/{conditionId}）、ウォレット ID のラベル（ENS／Lens／取引所／リスクタグ）、一括 ID 取得、オンチェーンクラスターの検出。 | ツール | 対応範囲 | 価格 | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | | blockrun_predexon_events | 現在のオッズを含む Polymarket のライブイベント | $0.001 / call | | blockrun_predexon_markets | キーワードで Polymarket のマーケットを検索 | $0.001 / call | | blockrun_predexon_leaderboard | 利益順にランク付けされた Polymarket のトップトレーダー | $0.001 / call | | blockrun_predexon_smart_money | 特定マーケットにおけるスマートマネーのポジション | $0.005 / call | | blockrun_predexon_smart_activity | スマートマネーが現在活発に動いているマーケット | $0.005 / call | | blockrun_predexon_wallet | Polymarket ウォレットのプロフィール（PnL、勝率、ポジション） | $0.005 / call | | blockrun_predexon_wallet_pnl | ウォレットの損益時系列 | $0.005 / call | | blockrun_predexon_matching_markets | Polymarket ↔ Kalshi のマーケットペア（裁定取引の比較） | $0.005 / call | | blockrun_predexon_endpoint_call | 残りの49個のエンドポイントすべてに対応する汎用ツール — オーダーブック、ローソク足、上位保有者、UMA オラクル、ウォレットの識別情報／クラスター、Kalshi／Limitless／Opinion／Predict.Fun、dFlow、Binance Futures、取引所横断検索、スポーツ、正規マーケット。path と、任意の method／query／body を指定します。 | $0.001 / $0.005 / call |

料金：マーケットデータの呼び出しは1回あたり $0.001、分析／検索／ウォレットの呼び出しは1回あたり $0.005 です。すべてのエンドポイントのリファレンスについては、predexon スキルをご覧ください。

予測市場での取引（Polymarket）— 実資金

オッズの確認にとどまらず、ClawRouter は blockrun_polymarket ツールを使って、Polymarket（CLOB V2、Polygon）で実際に賭けを行い、管理し、精算できます。ここにある他のすべてのツールとは異なり、これは HTTP プロキシのラッパーではありません。CLOB 注文に（EIP-712 で）署名するローカルの取引エンジンを実行し、LLM の呼び出しに使うものと同じ ClawRouter ウォレットで署名して、Polymarket に注文を送信します（デフォルトでは BlockRun の東京の出口経由なので、ジオブロックされた地域でもそのまま利用できます）。

ツール	機能	費用
blockrun_polymarket	action: setup / fund / buy / sell / cancel / orders / positions / redeem / withdraw。すべての操作をまとめた単一のツールです。	無料のツール。賭けには pUSD を使用

• 資金：賭けには、キーから導出されたガス代不要の Polygon 入金ウォレットのボールトにある pUSD を使用します。action:"fund" を実行すると、Base の USDC → pUSD にガス代不要で両替できます（x402、手数料 $0.01、カストディなし）。当選金は withdraw で Base のネイティブ USDC に戻せます。
• 安全性：注文の実行や署名には confirm:true が必須です（省略するとドライランのプレビューが表示されます）。1 注文あたりの上限は POLYMARKET_MAX_BET_USD（デフォルトは $25）で、オプションで POLYMARKET_MAX_SESSION_USD も設定できます。賭け金は x402 API の予算から引き出されません。
• 設定不要：Polymarket アカウント、API キー、ガストークンは不要です。最初に setup を実行すると、ウォレットからすべてが自動で初期設定されます。まず blockrun_predexon_* データツールでトークン ID を確認してください。基本ルールと最初から最後までの手順については、polymarket-trading スキルを参照してください。

出力例

[ClawRouter] google/gemini-2.5-flash (SIMPLE, rules, confidence=0.92)
             Cost: $0.0025 | Baseline: $0.308 | Saved: 99.2%