跳轉到主要內容
Fireworks 透過 OpenAI 相容 API 提供開放權重與路由模型。安裝官方 Fireworks 供應商外掛，即可使用兩個預先編入目錄的 Kimi 模型，以及在執行階段使用任何 Fireworks 模型或路由器 id。
屬性值
供應商 idfireworks（別名：fireworks-ai）
套件@openclaw/fireworks-provider
驗證環境變數FIREWORKS_API_KEY
入門設定旗標--auth-choice fireworks-api-key
直接命令列旗標--fireworks-api-key <key>
APIOpenAI 相容（openai-completions）
Base URLhttps://api.fireworks.ai/inference/v1
預設模型fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
預設別名Kimi K2.5 Turbo

​
開始使用

1

Install the plugin

openclaw plugins install @openclaw/fireworks-provider
2

Set the Fireworks API key

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.5 Turbo 路由器設為預設模型。
3

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

​
內建目錄

模型 ref名稱輸入上下文最大輸出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 推理輸出。請參閱 thinking 模式 了解如何在供應商之間切換。

​
自訂 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>",
      },
    },
  },
}
OpenClaw 中的每個 Fireworks 模型 ref 都以 fireworks/ 開頭，後面接 Fireworks 平台中的確切 id 或路由器路徑。例如：
  • 路由器模型：fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
  • 直接模型：fireworks/accounts/fireworks/models/<model-name>
OpenClaw 在建構 API 請求時會移除 fireworks/ 前綴，並將剩餘路徑作為 OpenAI 相容的 model 欄位傳送到 Fireworks 端點。
Fireworks 提供 Kimi 時沒有獨立的推理通道，因此思維鏈可能會出現在可見的 content 串流中。對於每個 Fireworks Kimi 請求，OpenClaw 都會傳送 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 金鑰必須對該行程可見，而不只是對你的互動式 shell 可見。
只在互動式 shell 中匯出的金鑰，除非該環境也匯入到 launchd 或 systemd daemon，否則不會有幫助。請在 ~/.openclaw/.env 中設定金鑰，或透過 env.shellEnv 設定，讓 gateway 行程可以讀取。
OpenClaw 載入設定時會載入 ~/.openclaw/.env，因此儲存在那裡的金鑰會在每個平台上傳遞給受管理的 gateway 服務。輪替金鑰後，請重新啟動 gateway（或重新執行 openclaw doctor --fix）。

​
相關

Model providers

選擇供應商、模型 ref 與容錯移轉行為。

Thinking modes

/think 等級、供應商政策，以及路由具備推理能力的模型。

Moonshot

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

Troubleshooting

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