跳轉到主要內容
Fireworks 透過 OpenAI 相容 API 提供開放權重與路由模型。OpenClaw 內含一個內建 Fireworks provider plugin，隨附兩個已預先編入目錄的 Kimi 模型，並可在執行階段接受任何 Fireworks 模型或 router id。
屬性值
Provider idfireworks（別名：fireworks-ai）
Plugin內建，enabledByDefault: true
驗證環境變數FIREWORKS_API_KEY
Onboarding 旗標--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

Set the Fireworks API key

openclaw onboard --auth-choice fireworks-api-key
Onboarding 會將金鑰儲存在你的驗證設定檔中的 fireworks provider，並將 Fire Pass Kimi K2.5 Turbo router 設為預設模型。
2

Verify the model is available

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

​
內建目錄

模型參照名稱輸入Context最大輸出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強制關閉（預設）
OpenClaw 會將所有 Fireworks Kimi 模型固定為 thinking: off，因為 Fireworks 會在生產環境中拒絕 Kimi thinking 參數。透過 Moonshot 直接路由相同模型，會保留 Kimi reasoning 輸出。請參閱 thinking 模式 以在 provider 之間切換。

​
自訂 Fireworks 模型 id

OpenClaw 可在執行階段接受任何 Fireworks 模型或 router id。使用 Fireworks 顯示的確切 id，並加上 fireworks/ 前綴。動態解析會複製 Fire Pass 範本（文字 + 圖片輸入、OpenAI 相容 API、預設成本為零），並在 id 符合 Kimi 模式時自動停用 thinking。 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
OpenClaw 中的每個 Fireworks 模型參照都以 fireworks/ 開頭，後接 Fireworks 平台上的確切 id 或 router 路徑。例如：
  • Router 模型：fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
  • 直接模型：fireworks/accounts/fireworks/models/<model-name>
OpenClaw 在建構 API 請求時會移除 fireworks/ 前綴，並將剩餘路徑作為 OpenAI 相容的 model 欄位傳送至 Fireworks 端點。
如果請求帶有 reasoning_* 參數，Fireworks K2.6 會回傳 400，即使 Kimi 透過 Moonshot 自有 API 支援 thinking。內建政策（extensions/fireworks/thinking-policy.ts）僅為 Kimi 模型 id 宣告 off thinking 等級，因此手動 /think 切換與 provider-policy 介面會與執行階段合約保持一致。若要端到端使用 Kimi reasoning，請設定 Moonshot provider，並透過它路由相同模型。
如果 Gateway 以受管理服務執行（launchd、systemd、Docker），Fireworks 金鑰必須能被該程序看見，而不只是你的互動式 shell。
只放在 ~/.profile 中的金鑰無法協助 launchd 或 systemd daemon，除非該環境也已匯入到那裡。請在 ~/.openclaw/.env 中設定金鑰，或透過 env.shellEnv 設定，讓 gateway 程序可以讀取。
在 macOS 上，openclaw gateway install 已經會將 ~/.openclaw/.env 接入 LaunchAgent 環境檔。輪替金鑰後，請重新執行安裝（或 openclaw doctor --fix）。

​
相關

Model providers

選擇 provider、模型參照與容錯移轉行為。

Thinking modes

/think 等級、provider 政策，以及路由具備 reasoning 能力的模型。

Moonshot

透過 Moonshot 自有 API 執行 Kimi 並取得原生 thinking 輸出。

Troubleshooting

一般疑難排解與常見問題。