快速开始
Fireworks
Fireworks 通过与 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-k2p5-turbo |
| 默认别名 | Kimi K2.5 Turbo |
入门指南
安装插件
openclaw plugins install @openclaw/fireworks-provider设置 Fireworks API 密钥
openclaw onboard --auth-choice fireworks-api-keyopenclaw 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 路由器设置为默认模型。
验证模型是否可用
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内置目录
| 模型引用 | 名称 | 输入 | 上下文 | 最大输出 | 思考 |
|---|---|---|---|---|---|
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 | 强制关闭（默认） |
自定义 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-k2p5-turbo - 直接模型：
fireworks/accounts/fireworks/models/<model-name>
OpenClaw 在构造 API 请求时会移除 fireworks/ 前缀，并将剩余路径作为与 OpenAI 兼容的 model 字段发送到 Fireworks 端点。
为什么强制关闭 Kimi 的思考
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 提供商，并通过它路由同一模型。
守护进程的环境可用性
如果 Gateway 网关作为托管服务运行（launchd、systemd、Docker），Fireworks 密钥必须对该进程可见，而不能只对交互式 shell 可见。
OpenClaw 会在加载配置时加载 ~/.openclaw/.env，因此存储在其中的密钥可在所有平台上传递给托管的 Gateway 网关服务。轮换密钥后，请重启 Gateway 网关（或重新运行 openclaw doctor --fix）。
