# Fireworks

> Fireworks 设置（身份验证 + 模型选择）

- 网址：https://funcoding.ai/agents/openclaw/providers/fireworks/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/fireworks

---
[Fireworks](https://fireworks.ai) 通过兼容 OpenAI 的 API 提供开放权重模型和路由模型。安装官方 Fireworks 提供商插件，即可使用两个预先编入目录的 Kimi 模型，并在运行时使用任意 Fireworks 模型或路由器 ID。

| 属性            | 值                                                     |
| --------------- | ------------------------------------------------------ |
| 提供商 ID       | `fireworks`（别名：`fireworks-ai`）        |
| 软件包          | `@openclaw/fireworks-provider`                                     |
| 身份验证环境变量 | `FIREWORKS_API_KEY`                                     |
| 新手引导标志    | `--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-k2p6-turbo`                                     |
| 默认别名        | `Kimi K2.6 Turbo`                                     |

## 入门指南

**安装插件**

```bash
openclaw plugins install @openclaw/fireworks-provider
```

**设置 Fireworks API 密钥**

```bash 新手引导
openclaw onboard --auth-choice fireworks-api-key
```

```bash 直接标志
openclaw onboard --non-interactive \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY"
```

```bash 仅使用环境变量
export FIREWORKS_API_KEY=fw-...
```

    新手引导会将该密钥关联到身份验证配置文件中的 `fireworks` 提供商，并将 **Fire Pass** Kimi K2.6 Turbo 路由器设为默认模型。

**验证模型是否可用**

```bash
openclaw models list --provider fireworks
```

列表中应包含 `Kimi K2.6` 和 `Kimi K2.6 Turbo (Fire Pass)`。如果无法解析 `FIREWORKS_API_KEY`，`openclaw models status --json` 会在 `auth.unusableProfiles` 下报告缺失的凭据。

## 非交互式设置

对于脚本化安装或 CI 安装，请在命令行中传入所有参数：

```bash
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  | 强制关闭（默认）     |

<div class="callout callout-note">

OpenClaw 将所有 Fireworks Kimi 模型固定为 `thinking: off`，因为除非请求明确禁用思考，否则 Fireworks 上的 Kimi 可能会将思维链泄露到可见回复中。通过 [Moonshot](https://funcoding.ai/agents/openclaw/providers/moonshot/) 直接路由同一模型，则会保留 Kimi 的推理输出。有关在提供商之间切换的信息，请参阅[思考模式](https://funcoding.ai/agents/openclaw/tools/thinking/)。

</div>

## 自定义 Fireworks 模型 ID

OpenClaw 在运行时接受任意 Fireworks 模型或路由器 ID。请使用 Fireworks 显示的确切 ID，并在其前面添加 `fireworks/`。动态解析会克隆 Fire Pass 模板（文本 + 图像输入、兼容 OpenAI 的 API、默认成本为零），并在 ID 匹配 Kimi 模式时自动禁用思考。除非配置带图像输入的自定义模型条目，否则 GLM 动态 ID 会被标记为仅支持文本。

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

<details>
<summary>模型 ID 前缀的工作方式</summary>

OpenClaw 中的每个 Fireworks 模型引用都以 `fireworks/` 开头，后跟 Fireworks 平台中的确切 ID 或路由器路径。例如：

- 路由器模型：`fireworks/accounts/fireworks/routers/kimi-k2p6-turbo`
- 直接模型：`fireworks/accounts/fireworks/models/<model-name>`

OpenClaw 在构造 API 请求时会移除 `fireworks/` 前缀，并将剩余路径作为兼容 OpenAI 的 `model` 字段发送到 Fireworks 端点。

</details>

<details>
<summary>为何 Kimi 会被强制关闭思考</summary>

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` 思考级别，因此手动 `/think` 切换和提供商策略界面会与运行时契约保持一致。

若要端到端使用 Kimi 推理，请配置 [Moonshot 提供商](https://funcoding.ai/agents/openclaw/providers/moonshot/)，并通过该提供商路由同一模型。

</details>

<details>
<summary>守护进程的环境可用性</summary>

如果 Gateway 网关作为托管服务（launchd、systemd、Docker）运行，则 Fireworks 密钥必须对此进程可见，而不能只对交互式 shell 可见。

<div class="callout callout-warning">

仅在交互式 shell 中导出的密钥无法供 launchd 或 systemd 守护进程使用，除非也将该环境导入其中。请在 `~/.openclaw/.env` 中设置密钥，或通过 `env.shellEnv` 设置，以便 Gateway 网关进程可以读取该密钥。

</div>

OpenClaw 在加载配置时会加载 `~/.openclaw/.env`，因此存储在其中的密钥可在每个平台上供托管的 Gateway 网关服务使用。轮换密钥后，请重启 Gateway 网关（或重新运行 `openclaw doctor --fix`）。

</details>

## 相关内容

- [模型提供商](https://funcoding.ai/agents/openclaw/concepts/model-providers/)：选择提供商、模型引用和故障转移行为。
- [思考模式](https://funcoding.ai/agents/openclaw/tools/thinking/)：`/think` 级别、提供商策略，以及支持推理的模型路由。
- [Moonshot](https://funcoding.ai/agents/openclaw/providers/moonshot/)：通过 Moonshot 自有 API 运行 Kimi，并使用原生思考输出。
- [故障排查](https://funcoding.ai/agents/openclaw/help/troubleshooting/)：常规故障排查和常见问题。