Providers
Fireworks
Fireworks は、OpenAI 互換 API を通じてオープンウェイトモデルとルーティングモデルを提供します。公式の Fireworks プロバイダー Plugin をインストールすると、事前にカタログ登録された 2 つの Kimi モデルに加え、任意の Fireworks モデルまたはルーター ID を実行時に使用できます。
| プロパティ | 値 |
|---|---|
| プロバイダー ID | fireworks(エイリアス: fireworks-ai) |
| パッケージ | @openclaw/fireworks-provider |
| 認証環境変数 | FIREWORKS_API_KEY |
| オンボーディングフラグ | --auth-choice fireworks-api-key |
| 直接指定する CLI フラグ | --fireworks-api-key <key> |
| API | OpenAI 互換(openai-completions) |
| ベース URL | https://api.fireworks.ai/inference/v1 |
| デフォルトモデル | fireworks/accounts/fireworks/routers/kimi-k2p5-turbo |
| デフォルトエイリアス | Kimi K2.5 Turbo |
はじめに
Plugin をインストールする
openclaw plugins install @openclaw/fireworks-providerFireworks API キーを設定する
openclaw onboard --auth-choice fireworks-api-keyopenclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"export FIREWORKS_API_KEY=fw-...オンボーディングでは、認証プロファイル内の fireworks プロバイダーにキーを保存し、Fire Pass Kimi K2.5 Turbo ルーターをデフォルトモデルに設定します。
モデルが利用可能か確認する
openclaw models list --provider fireworks一覧には Kimi K2.6 と Kimi K2.5 Turbo (Fire Pass) が含まれている必要があります。FIREWORKS_API_KEY を解決できない場合、openclaw models status --json は不足している認証情報を auth.unusableProfiles 配下に報告します。
非対話型セットアップ
スクリプトまたは CI によるインストールでは、すべてをコマンドラインで渡します。
openclaw onboard --non-interactive \ --mode local \ --auth-choice fireworks-api-key \ --fireworks-api-key "$FIREWORKS_API_KEY" \ --skip-health \ --accept-risk組み込みカタログ
| モデル参照 | 名前 | 入力 | コンテキスト | 最大出力 | 思考 |
|---|---|---|---|---|---|
fireworks/accounts/fireworks/models/kimi-k2p6 |
Kimi K2.6 | テキスト + 画像 | 262,144 | 262,144 | 強制的にオフ |
fireworks/accounts/fireworks/routers/kimi-k2p5-turbo |
Kimi K2.5 Turbo (Fire Pass) | テキスト + 画像 | 256,000 | 256,000 | 強制的にオフ(デフォルト) |
カスタム Fireworks モデル ID
OpenClaw は、任意の Fireworks モデルまたはルーター ID を実行時に受け付けます。Fireworks に表示されている正確な ID を使用し、先頭に fireworks/ を付けてください。動的解決では Fire Pass テンプレート(テキスト + 画像入力、OpenAI 互換 API、デフォルトコスト 0)を複製し、ID が Kimi のパターンに一致する場合は思考を自動的に無効化します。GLM の動的 ID は、画像入力を含むカスタムモデルエントリを設定しない限り、テキスト専用として扱われます。
{ agents: { defaults: { model: { primary: "fireworks/accounts/fireworks/models/<your-model-id>", }, }, },}モデル ID のプレフィックスの仕組み
OpenClaw のすべての Fireworks モデル参照は fireworks/ で始まり、その後に Fireworks プラットフォーム上の正確な ID またはルーターパスが続きます。例:
- ルーターモデル:
fireworks/accounts/fireworks/routers/kimi-k2p5-turbo - 直接指定モデル:
fireworks/accounts/fireworks/models/<model-name>
OpenClaw は API リクエストを構築する際に fireworks/ プレフィックスを取り除き、残りのパスを OpenAI 互換の model フィールドとして Fireworks エンドポイントに送信します。
Kimi の思考が強制的にオフになる理由
Fireworks は独立した推論チャネルなしで Kimi を提供するため、思考過程が表示される content ストリームに現れる可能性があります。OpenClaw は Fireworks Kimi へのすべてのリクエストで thinking: { type: "disabled" } を送信し、ペイロードから reasoning、reasoning_effort、reasoningEffort を取り除きます(extensions/fireworks/stream.ts)。プロバイダーポリシー(extensions/fireworks/thinking-policy.ts)は、Kimi モデル ID に対して off の思考レベルのみを公開するため、手動の /think 切り替えとプロバイダーポリシーの各画面は実行時の契約と一致した状態に保たれます。
Kimi の推論をエンドツーエンドで使用するには、Moonshot プロバイダーを設定し、同じモデルをそのプロバイダー経由でルーティングします。
デーモンでの環境変数の利用
Gateway が管理対象サービス(launchd、systemd、Docker)として実行されている場合、Fireworks キーは対話型シェルだけでなく、そのプロセスから参照できる必要があります。
OpenClaw は設定の読み込み時に ~/.openclaw/.env を読み込むため、そこに保存されたキーはすべてのプラットフォームで管理対象の Gateway サービスから利用できます。キーをローテーションした後は、Gateway を再起動するか、openclaw doctor --fix を再実行してください。