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-k2p6-turbo |
| デフォルトエイリアス | Kimi K2.6 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.6 Turbo ルーターをデフォルトモデルに設定します。
モデルが利用可能か確認する
openclaw models list --provider fireworks一覧には Kimi K2.6 と Kimi K2.6 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組み込みカタログ
| モデル参照 | 名前 | 入力 | コンテキスト | 最大出力 | Thinking |
|---|---|---|---|---|---|
fireworks/accounts/fireworks/models/kimi-k2p6 |
Kimi K2.6 | テキスト + 画像 | 262,144 | 262,144 | 強制的にオフ |
fireworks/accounts/fireworks/routers/kimi-k2p6-turbo |
Kimi K2.6 Turbo (Fire Pass) | テキスト + 画像 | 256,000 | 256,000 | 強制的にオフ(デフォルト) |
カスタム Fireworks モデル ID
OpenClaw は、実行時に任意の Fireworks モデルまたはルーター ID を受け入れます。Fireworks に表示される正確な ID を使用し、先頭に fireworks/ を付けてください。動的解決では Fire Pass テンプレート(テキスト + 画像入力、OpenAI 互換 API、デフォルトコストはゼロ)を複製し、ID が Kimi パターンに一致する場合は Thinking を自動的に無効にします。GLM の動的 ID は、画像入力を含むカスタムモデルエントリを構成しない限り、テキスト専用としてマークされます。
{ agents: { defaults: { model: { primary: "fireworks/accounts/fireworks/models/<your-model-id>", }, }, },}モデル ID のプレフィックスの仕組み
OpenClaw のすべての Fireworks モデル参照は fireworks/ で始まり、その後に Fireworks プラットフォームの正確な ID またはルーターパスが続きます。例:
- ルーターモデル:
fireworks/accounts/fireworks/routers/kimi-k2p6-turbo - 直接モデル:
fireworks/accounts/fireworks/models/<model-name>
OpenClaw は API リクエストを構築する際に fireworks/ プレフィックスを削除し、残りのパスを OpenAI 互換の model フィールドとして Fireworks エンドポイントに送信します。
Kimi で Thinking が強制的にオフになる理由
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 Thinking レベルのみを公開するため、手動の /think 切り替えとプロバイダーポリシーのサーフェスは、実行時の契約との整合性を保ちます。
Kimi の推論をエンドツーエンドで使用するには、Moonshot プロバイダーを構成し、同じモデルを経由させます。
デーモンでの環境変数の利用
Gateway が管理対象サービス(launchd、systemd、Docker)として実行されている場合、Fireworks キーは対話型シェルだけでなく、そのプロセスから参照できる必要があります。
OpenClaw は構成の読み込み時に ~/.openclaw/.env を読み込むため、そこに保存されたキーは、すべてのプラットフォームで管理対象の Gateway サービスに渡されます。キーをローテーションした後は、Gateway を再起動する(または openclaw doctor --fix を再実行する)必要があります。