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

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

    オンボーディング
    openclaw onboard --auth-choice fireworks-api-key
    直接フラグ
    openclaw 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 ルーターをデフォルトモデルに設定します。

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

    bash
    openclaw models list --provider fireworks

    一覧には Kimi K2.6Kimi K2.6 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

    組み込みカタログ

    モデル参照 名前 入力 コンテキスト 最大出力 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 は、画像入力を含むカスタムモデルエントリを構成しない限り、テキスト専用としてマークされます。

    json5
    {  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" } を送信し、ペイロードから reasoningreasoning_effortreasoningEffort を削除します(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 を再実行する)必要があります。

    関連項目

    Was this useful?
    On this page

    On this page