Fireworks

Fireworks 透過 OpenAI 相容 API 提供開放權重與路由模型。安裝官方 Fireworks 提供者外掛，即可在執行階段使用兩個預先收錄的 Kimi 模型，以及任何 Fireworks 模型或路由器 ID。

屬性	值
提供者 ID	fireworks（別名：fireworks-ai）
套件	@openclaw/fireworks-provider
驗證環境變數	FIREWORKS_API_KEY
初始設定旗標	--auth-choice fireworks-api-key
直接命令列旗標	--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

​

開始使用

1. 安裝外掛

   openclaw plugins install @openclaw/fireworks-provider
   
2. 設定 Fireworks API 金鑰

   初始設定

   openclaw onboard --auth-choice fireworks-api-key
   

   初始設定會將金鑰儲存至驗證設定檔中的 fireworks 提供者，並將 Fire Pass Kimi K2.6 Turbo 路由器設為預設模型。

3. 確認模型可用

   openclaw models list --provider fireworks
   

   清單應包含 Kimi K2.6 和 Kimi K2.6 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

​

內建目錄

模型參照	名稱	輸入	上下文	最大輸出	思考
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	強制關閉（預設）

OpenClaw 會將所有 Fireworks Kimi 模型固定為 thinking: off，因為除非請求明確停用思考，否則 Fireworks 上的 Kimi 可能會將思維鏈洩漏至可見回覆中。直接透過 Moonshot 路由相同模型，則會保留 Kimi 的推理輸出。若要在提供者之間切換，請參閱思考模式。

​

自訂 Fireworks 模型 ID

OpenClaw 在執行階段接受任何 Fireworks 模型或路由器 ID。請使用 Fireworks 顯示的確切 ID，並在前面加上 fireworks/。動態解析會複製 Fire Pass 範本（文字 + 圖片輸入、OpenAI 相容 API、預設成本為零），並在 ID 符合 Kimi 模式時自動停用思考。除非設定含圖片輸入的自訂模型項目，否則 GLM 動態 ID 會標記為僅限文字。

{
  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 的思考

Fireworks 提供的 Kimi 沒有獨立的推理通道，因此思維鏈可能會出現在可見的 content 串流中。OpenClaw 會在每個 Fireworks Kimi 請求中傳送 thinking: { type: "disabled" }，並從承載資料中移除 reasoning、reasoning_effort 和 reasoningEffort（extensions/fireworks/stream.ts）。提供者政策（extensions/fireworks/thinking-policy.ts）僅為 Kimi 模型 ID 公告 off 思考層級，使手動 /think 切換與提供者政策介面都能和執行階段合約保持一致。

若要端對端使用 Kimi 推理，請設定 Moonshot 提供者，並透過該提供者路由相同模型。

常駐程式的環境可用性

如果閘道以受管理服務（launchd、systemd、Docker）執行，Fireworks 金鑰必須對該程序可見，而不能只存在於你的互動式 shell 中。

除非也將該環境匯入 launchd 或 systemd，否則僅在互動式 shell 中匯出的金鑰無法供其常駐程式使用。請在 ~/.openclaw/.env 中或透過 env.shellEnv 設定金鑰，讓閘道程序能夠讀取。

OpenClaw 載入設定時會載入 ~/.openclaw/.env，因此儲存在該處的金鑰會在所有平台上提供給受管理的閘道服務。輪替金鑰後，請重新啟動閘道（或重新執行 openclaw doctor --fix）。

​

相關內容

模型提供者

選擇提供者、模型參照與容錯移轉行為。

思考模式

/think 層級、提供者政策，以及具推理能力模型的路由方式。

Moonshot

透過 Moonshot 自有 API 執行 Kimi，並使用原生思考輸出。

疑難排解

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