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 をインストールする

    bash
    openclaw plugins install @openclaw/fireworks-provider
  • Fireworks API キーを設定する

    Onboarding
    openclaw onboard --auth-choice fireworks-api-key
    Direct flag
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    Env only
    export FIREWORKS_API_KEY=fw-...

    オンボーディングでは、認証プロファイル内の fireworks プロバイダーにキーを保存し、Fire Pass Kimi K2.5 Turbo ルーターをデフォルトモデルに設定します。

  • モデルが利用可能か確認する

    bash
    openclaw models list --provider fireworks

    一覧には Kimi K2.6Kimi K2.5 Turbo (Fire Pass) が含まれている必要があります。FIREWORKS_API_KEY を解決できない場合、openclaw models status --json は不足している認証情報を auth.unusableProfiles 配下に報告します。

  • 非対話型セットアップ

    スクリプトまたは CI によるインストールでは、すべてをコマンドラインで渡します。

    bash
    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 は、画像入力を含むカスタムモデルエントリを設定しない限り、テキスト専用として扱われます。

    json5
    {  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" } を送信し、ペイロードから reasoningreasoning_effortreasoningEffort を取り除きます(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 を再実行してください。

    関連項目

    Was this useful?
    On this page

    On this page