Skip to main content
Fireworks 通过兼容 OpenAI 的 API 提供开放权重模型和路由模型。安装官方 Fireworks 提供商插件,即可使用两个预先编入目录的 Kimi 模型,并在运行时使用任意 Fireworks 模型或路由器 ID。

入门指南

1

安装插件

2

设置 Fireworks API 密钥

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

验证模型是否可用

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

非交互式设置

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

内置目录

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

自定义 Fireworks 模型 ID

OpenClaw 在运行时接受任意 Fireworks 模型或路由器 ID。请使用 Fireworks 显示的确切 ID,并在其前面添加 fireworks/。动态解析会克隆 Fire Pass 模板(文本 + 图像输入、兼容 OpenAI 的 API、默认成本为零),并在 ID 匹配 Kimi 模式时自动禁用思考。除非配置带图像输入的自定义模型条目,否则 GLM 动态 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 端点。
Fireworks 提供 Kimi 时不使用单独的推理渠道,因此思维链可能会出现在可见的 content 流中。对于每个 Fireworks Kimi 请求,OpenClaw 都会发送 thinking: { type: "disabled" },并从有效载荷中移除 reasoningreasoning_effortreasoningEffortextensions/fireworks/stream.ts)。提供商策略(extensions/fireworks/thinking-policy.ts)仅为 Kimi 模型 ID 公布 off 思考级别,因此手动 /think 切换和提供商策略界面会与运行时契约保持一致。若要端到端使用 Kimi 推理,请配置 Moonshot 提供商,并通过该提供商路由同一模型。
如果 Gateway 网关作为托管服务(launchd、systemd、Docker)运行,则 Fireworks 密钥必须对此进程可见,而不能只对交互式 shell 可见。
仅在交互式 shell 中导出的密钥无法供 launchd 或 systemd 守护进程使用,除非也将该环境导入其中。请在 ~/.openclaw/.env 中设置密钥,或通过 env.shellEnv 设置,以便 Gateway 网关进程可以读取该密钥。
OpenClaw 在加载配置时会加载 ~/.openclaw/.env,因此存储在其中的密钥可在每个平台上供托管的 Gateway 网关服务使用。轮换密钥后,请重启 Gateway 网关(或重新运行 openclaw doctor --fix)。

相关内容

模型提供商

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

思考模式

/think 级别、提供商策略,以及支持推理的模型路由。

Moonshot

通过 Moonshot 自有 API 运行 Kimi,并使用原生思考输出。

故障排查

常规故障排查和常见问题。