Skip to main content
Fireworks 通过与 OpenAI 兼容的 API 提供开放权重模型和路由模型。OpenClaw 包含一个内置的 Fireworks 提供方插件，默认附带两个预先收录的 Kimi 模型，并且在运行时接受任意 Fireworks 模型或路由 id。
PropertyValue
Provider idfireworks (alias: fireworks-ai)
Pluginbundled, enabledByDefault: true
Auth env varFIREWORKS_API_KEY
Onboarding flag--auth-choice fireworks-api-key
Direct CLI flag--fireworks-api-key <key>
APIOpenAI-compatible (openai-completions)
Base URLhttps://api.fireworks.ai/inference/v1
Default modelfireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Default aliasKimi K2.5 Turbo

​
入门

1

设置 Fireworks API key

openclaw onboard --auth-choice fireworks-api-key
入门流程会将该密钥保存到你的认证配置文件中的 fireworks 提供方下，并将 Fire Pass Kimi K2.5 Turbo 路由设置为默认模型。
2

验证模型是否可用

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

​
内置目录

Model refNameInputContextMax outputThinking
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6text + image262,144262,144强制关闭
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)text + image256,000256,000强制关闭（默认）
OpenClaw 将所有 Fireworks Kimi 模型固定为 thinking: off，因为 Fireworks 在生产环境中会拒绝 Kimi 的 thinking 参数。通过 Moonshot 直接路由同一模型，可以保留 Kimi 的推理输出。有关在提供方之间切换，请参见 thinking modes。

​
自定义 Fireworks 模型 id

OpenClaw 接受运行时的任意 Fireworks 模型或路由 id。请使用 Fireworks 显示的准确 id，并以前缀 fireworks/ 添加。动态解析会克隆 Fire Pass 模板（文本 + 图像输入、OpenAI 兼容 API、默认成本为零），并在 id 匹配 Kimi 模式时自动禁用 thinking。GLM 动态 id 默认标记为仅文本，除非你配置带图像输入的自定义模型条目。 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-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 通过 Moonshot 自己的 API 支持 thinking，Fireworks K2.6 在请求携带 reasoning_* 参数时也会返回 400。内置策略（extensions/fireworks/thinking-policy.ts）只为 Kimi 模型 id 声明 off 这一 thinking 级别，因此手动 /think 切换和提供方策略界面会与运行时契约保持一致。若要端到端使用 Kimi 推理，请配置 Moonshot 提供方 并通过它路由同一个模型。
如果 Gateway 作为受管服务运行（launchd、systemd、Docker），Fireworks 密钥必须对该进程可见——而不仅仅对你的交互式 shell 可见。
仅在交互式 shell 中导出的密钥，对 launchd 或 systemd 守护进程没有帮助，除非该环境也被导入其中。请将密钥设置在 ~/.openclaw/.env 中，或通过 env.shellEnv 设置，以便网关进程能够读取。
在 macOS 上，openclaw gateway install 已经会把 ~/.openclaw/.env 连接到 LaunchAgent 环境文件。轮换密钥后，请重新运行安装（或 openclaw doctor --fix）。

​
相关内容

模型提供方

选择提供方、模型引用和故障转移行为。

Thinking modes

/think 级别、提供方策略，以及路由具备推理能力的模型。

Moonshot

通过 Moonshot 自己的 API 运行带原生 thinking 输出的 Kimi。

故障排查

常规故障排查和 FAQ。