Fireworks

Fireworks 通过 OpenAI 兼容 API 暴露开放权重和路由模型。安装官方 Fireworks 提供商插件，即可使用当前 Fire Pass GLM 路由器、两个预先编目的 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/glm-5p3-fast`
默认别名	`GLM 5.3 Fast`

快速开始¶

1. 安装插件

openclaw plugins install @openclaw/fireworks-provider

2. 设置 Fireworks API 密钥

引导直接标志仅环境变量

openclaw onboard --auth-choice fireworks-api-key

openclaw onboard --non-interactive --accept-risk --skip-health \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY"

export FIREWORKS_API_KEY=fw-...

引导流程会将密钥关联到身份验证配置中的 fireworks 提供商，并将 Fireworks 当前的 Fire Pass GLM 5.3 Fast 路由器设为默认模型。

3. 验证模型是否可用

openclaw models list --provider fireworks

列表应包含 GLM 5.3 Fast、Kimi K2.6 和 Kimi K2.6 Fast。如果 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

--mode 默认为 local，因此这与上面的 直接标志 命令是相同的运行。请在 Gateway 主机上运行：远程客户端引导（--mode remote）仅配置本地客户端连接，不会在服务器上设置提供商凭据。

内置目录¶

设置会保存连接设置和别名，而不会将生成的目录行复制到你的配置中。显式 models.mode: "replace" 会保持目录种子启用；自定义模型行保持不变。

模型引用	名称	输入	上下文	最大输出	思考
`fireworks/accounts/fireworks/routers/glm-5p3-fast`	GLM 5.3 Fast	文本	256,000	256,000	开启（默认）
`fireworks/accounts/fireworks/models/kimi-k2p6`	Kimi K2.6	文本 + 图像	262,144	262,144	强制关闭
`fireworks/accounts/fireworks/routers/kimi-k2p6-turbo`	Kimi K2.6 Fast	文本 + 图像	262,144	256,000	强制关闭

OpenClaw 为 GLM 5.3 Fast 保留保守的 256,000 token 上下文和输出上限。 Fireworks 文档中列出了更大的原生上下文窗口； Fast 模式以更高速度提供相同模型。目录使用 Fast 定价，而不是标准费率。

Note

OpenClaw 将所有 Fireworks Kimi 模型固定为 thinking: off，因为 Fireworks 上的 Kimi 可能会将思维链泄漏到可见回复中，除非请求显式禁用思考。通过 Moonshot 直接路由相同模型可保留 Kimi 推理输出。有关在提供商之间切换，请参阅思考模式。

自定义 Fireworks 模型 ID¶

OpenClaw 在运行时接受任意 Fireworks 模型或路由器 ID。请使用 Fireworks 显示的精确 ID，并为其添加 fireworks/ 前缀。动态解析使用 Fire Pass 模板的 OpenAI 兼容 API，并将 GLM ID 标记为仅文本；其他动态 ID 会声明文本 + 图像输入。当 ID 匹配 Kimi 模式时，思考会自动禁用。对于具有不同能力的模型，请配置包含其支持输入类型的自定义模型条目。

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

模型 ID 前缀如何工作

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

路由器模型：fireworks/accounts/fireworks/routers/kimi-k2p6-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 可见。

Warning

仅在交互式 shell 中导出的密钥，除非将该环境也导入其中，否则对 launchd 或 systemd 守护进程没有帮助。将密钥设置在 ~/.openclaw/.env 中，或通过 env.shellEnv 设置，以便 gateway 进程可以读取。

OpenClaw 在加载配置时会加载 ~/.openclaw/.env，因此存储在该处的密钥可在所有平台上被托管 gateway 服务读取。轮换密钥后，请重启 gateway（或重新运行 openclaw doctor --fix）。

模型提供商

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

思考模式

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

Moonshot

通过 Moonshot 自己的 API 运行具有原生思考输出的 Kimi。

故障排查

通用故障排查和常见问题解答。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw

Fireworks

快速开始¶

非交互式设置¶

内置目录¶

自定义 Fireworks 模型 ID¶

相关¶