---
read_when:
    - 你想要將 Fireworks 與 OpenClaw 搭配使用
    - 您需要 Fireworks API 金鑰環境變數或預設模型 ID
    - 你正在偵錯 Fireworks 上 Kimi 的關閉思考行為
summary: Fireworks 設定（認證 + 模型選擇）
title: Fireworks
x-i18n:
    generated_at: "2026-05-06T02:55:53Z"
    model: gpt-5.5
    provider: openai
    source_hash: 3a7dcaf6c7e1c004436213e67bc2262992ee1307cdaa5c290225345782f4cbfa
    source_path: providers/fireworks.md
    workflow: 16
---

[Fireworks](https://fireworks.ai) 透過 OpenAI 相容 API 提供開放權重與路由模型。OpenClaw 內含一個內建 Fireworks provider plugin，隨附兩個已預先編入目錄的 Kimi 模型，並可在執行階段接受任何 Fireworks 模型或 router id。

| 屬性            | 值                                                     |
| --------------- | ------------------------------------------------------ |
| Provider id     | `fireworks`（別名：`fireworks-ai`）                    |
| Plugin          | 內建，`enabledByDefault: true`                         |
| 驗證環境變數    | `FIREWORKS_API_KEY`                                    |
| Onboarding 旗標 | `--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-k2p5-turbo` |
| 預設別名        | `Kimi K2.5 Turbo`                                      |

## 開始使用

<Steps>
  <Step title="Set the Fireworks API key">
    <CodeGroup>

```bash Onboarding
openclaw onboard --auth-choice fireworks-api-key
```

```bash Direct flag
openclaw onboard --non-interactive \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY"
```

```bash Env only
export FIREWORKS_API_KEY=fw-...
```

    </CodeGroup>

    Onboarding 會將金鑰儲存在你的驗證設定檔中的 `fireworks` provider，並將 **Fire Pass** Kimi K2.5 Turbo router 設為預設模型。

  </Step>
  <Step title="Verify the model is available">
    ```bash
    openclaw models list --provider fireworks
    ```

    清單應包含 `Kimi K2.6` 和 `Kimi K2.5 Turbo (Fire Pass)`。如果 `FIREWORKS_API_KEY` 無法解析，`openclaw models status --json` 會在 `auth.unusableProfiles` 下回報缺少的憑證。

  </Step>
</Steps>

## 非互動式設定

對於腳本化或 CI 安裝，請在命令列傳入所有內容：

```bash
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-k2p6`        | Kimi K2.6                   | 文字 + 圖片  | 262,144 | 262,144    | 強制關閉             |
| `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo` | Kimi K2.5 Turbo (Fire Pass) | 文字 + 圖片  | 256,000 | 256,000    | 強制關閉（預設）     |

<Note>
  OpenClaw 會將所有 Fireworks Kimi 模型固定為 `thinking: off`，因為 Fireworks 會在生產環境中拒絕 Kimi thinking 參數。透過 [Moonshot](/zh-TW/providers/moonshot) 直接路由相同模型，會保留 Kimi reasoning 輸出。請參閱 [thinking 模式](/zh-TW/tools/thinking) 以在 provider 之間切換。
</Note>

## 自訂 Fireworks 模型 id

OpenClaw 可在執行階段接受任何 Fireworks 模型或 router id。使用 Fireworks 顯示的確切 id，並加上 `fireworks/` 前綴。動態解析會複製 Fire Pass 範本（文字 + 圖片輸入、OpenAI 相容 API、預設成本為零），並在 id 符合 Kimi 模式時自動停用 thinking。

```json5
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
```

<AccordionGroup>
  <Accordion title="How model id prefixing works">
    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 端點。

  </Accordion>

  <Accordion title="Why thinking is forced off for Kimi">
    如果請求帶有 `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](/zh-TW/providers/moonshot)，並透過它路由相同模型。

  </Accordion>

  <Accordion title="Environment availability for the daemon">
    如果 Gateway 以受管理服務執行（launchd、systemd、Docker），Fireworks 金鑰必須能被該程序看見，而不只是你的互動式 shell。

    <Warning>
      只放在 `~/.profile` 中的金鑰無法協助 launchd 或 systemd daemon，除非該環境也已匯入到那裡。請在 `~/.openclaw/.env` 中設定金鑰，或透過 `env.shellEnv` 設定，讓 gateway 程序可以讀取。
    </Warning>

    在 macOS 上，`openclaw gateway install` 已經會將 `~/.openclaw/.env` 接入 LaunchAgent 環境檔。輪替金鑰後，請重新執行安裝（或 `openclaw doctor --fix`）。

  </Accordion>
</AccordionGroup>

## 相關

<CardGroup cols={2}>
  <Card title="Model providers" href="/zh-TW/concepts/model-providers" icon="layers">
    選擇 provider、模型參照與容錯移轉行為。
  </Card>
  <Card title="Thinking modes" href="/zh-TW/tools/thinking" icon="brain">
    `/think` 等級、provider 政策，以及路由具備 reasoning 能力的模型。
  </Card>
  <Card title="Moonshot" href="/zh-TW/providers/moonshot" icon="moon">
    透過 Moonshot 自有 API 執行 Kimi 並取得原生 thinking 輸出。
  </Card>
  <Card title="Troubleshooting" href="/zh-TW/help/troubleshooting" icon="wrench">
    一般疑難排解與常見問題。
  </Card>
</CardGroup>