跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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