メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Fireworks は、OpenAI 互換 API を通じてオープンウェイトモデルとルーティングされたモデルを公開しています。OpenClaw には、事前にカタログ化された 2 つの Kimi モデルを同梱し、実行時に任意の Fireworks モデルまたはルーター ID を受け付ける、バンドル済みの Fireworks プロバイダー Plugin が含まれています。
プロパティ値
プロバイダー IDfireworks (エイリアス: fireworks-ai)
Pluginバンドル済み、enabledByDefault: true
認証環境変数FIREWORKS_API_KEY
オンボーディングフラグ--auth-choice fireworks-api-key
直接 CLI フラグ--fireworks-api-key <key>
APIOpenAI 互換 (openai-completions)
ベース URLhttps://api.fireworks.ai/inference/v1
デフォルトモデルfireworks/accounts/fireworks/routers/kimi-k2p5-turbo
デフォルトエイリアスKimi K2.5 Turbo

​
はじめに

1

Fireworks API キーを設定する

openclaw onboard --auth-choice fireworks-api-key
オンボーディングは、認証プロファイル内の fireworks プロバイダーに対してキーを保存し、Fire Pass Kimi K2.5 Turbo ルーターをデフォルトモデルとして設定します。
2

モデルが利用可能であることを確認する

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

​
組み込みカタログ

モデル参照名前入力コンテキスト最大出力Thinking
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6テキスト + 画像262,144262,144強制的にオフ
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)テキスト + 画像256,000256,000強制的にオフ (デフォルト)
Fireworks は本番環境で Kimi の thinking パラメーターを拒否するため、OpenClaw はすべての Fireworks Kimi モデルを thinking: off に固定します。同じモデルを Moonshot 経由で直接ルーティングすると、Kimi の reasoning 出力が保持されます。プロバイダー間の切り替えについては、thinking モード を参照してください。

​
カスタム Fireworks モデル ID

OpenClaw は実行時に任意の Fireworks モデルまたはルーター ID を受け付けます。Fireworks に表示される正確な ID を使い、先頭に fireworks/ を付けてください。動的解決は Fire Pass テンプレート (テキスト + 画像入力、OpenAI 互換 API、デフォルトコスト 0) を複製し、ID が Kimi パターンに一致する場合は thinking を自動的に無効化します。 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-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 エンドポイントに送信します。
Fireworks K2.6 は、Kimi が Moonshot 独自の API 経由では thinking をサポートしているにもかかわらず、リクエストに reasoning_* パラメーターが含まれていると 400 を返します。バンドル済みポリシー (extensions/fireworks/thinking-policy.ts) は、Kimi モデル ID に対して off thinking レベルのみを公開するため、手動の /think 切り替えとプロバイダーポリシーの表示が実行時コントラクトと一致したままになります。Kimi reasoning をエンドツーエンドで使用するには、Moonshot プロバイダー を設定し、同じモデルをそこからルーティングしてください。
Gateway が管理サービス (launchd、systemd、Docker) として実行されている場合、Fireworks キーは対話型シェルだけでなく、そのプロセスからも見えている必要があります。
~/.profile にだけ置かれたキーは、その環境もそこに取り込まれていない限り、launchd または systemd デーモンには役立ちません。Gateway プロセスから読み取れるようにするには、キーを ~/.openclaw/.env に設定するか、env.shellEnv 経由で設定してください。
macOS では、openclaw gateway install がすでに ~/.openclaw/.env を LaunchAgent 環境ファイルに接続します。キーをローテーションした後は、インストールを再実行するか、openclaw doctor --fix を実行してください。

​
関連

モデルプロバイダー

プロバイダー、モデル参照、フェイルオーバー動作を選択します。

Thinking モード

/think レベル、プロバイダーポリシー、reasoning 対応モデルのルーティング。

Moonshot

Moonshot 独自の API 経由でネイティブ thinking 出力付きの Kimi を実行します。

トラブルシューティング

一般的なトラブルシューティングと FAQ。