OpenClaw 通过内置 fireworks provider 对接 Fireworks AI 的 OpenAI 兼容推理端点，需要先设置 FIREWORKS_API_KEY 环境变量并运行 openclaw onboard 完成认证。Kimi K2.5 Turbo 为默认模型，但 Fireworks 会强制关闭 thinking 参数（传入 reasoning_* 返回 400），如需 Kimi 原生推理输出请换用 Moonshot provider。

OpenClaw Fireworks 配置：Kimi 模型与 API Key 设置

字段	值
Provider id	fireworks（别名：fireworks-ai）
插件	内置，enabledByDefault: true
认证环境变量	FIREWORKS_API_KEY
Onboarding 标志	--auth-choice fireworks-api-key
直接 CLI 标志	--fireworks-api-key <key>
API 类型	OpenAI 兼容（openai-completions）
Base URL	https://api.fireworks.ai/inference/v1
默认模型	fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
默认别名	Kimi K2.5 Turbo

快速开始

1. 设置 Fireworks API Key

交互式方式（推荐）：

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

非交互式方式（脚本/CI）：

openclaw onboard --non-interactive \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY"

仅设置环境变量：

export FIREWORKS_API_KEY=fw-...

Onboarding 会将 key 保存在认证配置中，并自动将 Kimi K2.5 Turbo 路由器设为默认模型（Fire Pass）。

2. 验证模型可用

openclaw models list --provider fireworks

输出应包含 Kimi K2.6 和 Kimi K2.5 Turbo (Fire Pass)。如果 FIREWORKS_API_KEY 未被识别，openclaw models status --json 会在 auth.unusableProfiles 中报告缺失凭据。

非交互式设置

适合持续集成或自动化部署：

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

内置模型目录

模型引用	名称	输入	上下文	最大输出	Thinking
fireworks/accounts/fireworks/models/kimi-k2p6	Kimi K2.6	text + image	262,144	262,144	强制关闭
fireworks/accounts/fireworks/routers/kimi-k2p5-turbo	Kimi K2.5 Turbo (Fire Pass)	text + image	256,000	256,000	强制关闭（默认）

INFO

OpenClaw 将所有 Fireworks Kimi 模型固定为 thinking: off，因为 Fireworks 在生产环境中会拒绝 Kimi 的 thinking 参数。如果通过 Moonshot 直接路由同一模型，则可保留 Kimi 的推理输出。详见 thinking modes。

自定义 Fireworks 模型 ID

OpenClaw 运行时接受任何 Fireworks 模型或路由器 ID。使用 Fireworks 显示的精确 ID，并加上 fireworks/ 前缀。动态解析会克隆 Fire Pass 模板（text + image 输入、OpenAI 兼容 API、默认成本为零），当 ID 匹配 Kimi 模式时自动关闭 thinking。

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

模型 ID 前缀如何工作

每个 Fireworks 模型引用都以 fireworks/ 开头，后接 Fireworks 平台上的完整 ID 或路由器路径。例如：

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

OpenClaw 构建 API 请求时会去掉 fireworks/ 前缀，将剩余路径作为 OpenAI 兼容的 model 字段发送到 Fireworks 端点。

为什么 Kimi 的 thinking 被强制关闭

Fireworks K2.6 在请求中携带 reasoning_* 参数时会返回 400，即使 Kimi 通过 Moonshot 自有 API 支持思考模式。内置策略（extensions/fireworks/thinking-policy.ts）对 Kimi 模型 ID 仅暴露 off 这一 thinking 级别，因此手动 /think 切换和 provider 策略面保持与运行时契约一致。

如需使用端到端的 Kimi 推理，请配置 Moonshot provider 并通过它路由同一模型。

守护进程的环境变量可用性

如果 Gateway 作为托管服务运行（launchd、systemd、Docker），Fireworks key 必须对该进程可见，而不仅仅是交互式 shell。

WARNING

仅在交互式 shell 中导出的 key 无法被 launchd 或 systemd 守护进程使用，除非该环境被导入到相应的服务中。请在 ~/.openclaw/.env 中设置 key，或通过 env.shellEnv 使其可被网关进程读取。

在 macOS 上，openclaw gateway install 已自动将 ~/.openclaw/.env 写入 LaunchAgent 环境文件。更换 key 后请重新运行 install（或 openclaw doctor --fix）。 :::

常见问题

为什么 Fireworks 上 Kimi 模型的 thinking 无法启用？

Fireworks 的 Kimi K2.6 接口不接受 reasoning_* 参数，传入会返回 400。OpenClaw 已对 Kimi 模型强制设置为 thinking: off。如需 Kimi 推理输出，请改用 Moonshot provider 路由该模型。

如何在非交互模式下配置 Fireworks API Key？

使用 openclaw onboard --non-interactive --auth-choice fireworks-api-key --fireworks-api-key "$FIREWORKS_API_KEY"。如果不需要健康检查，可加 --skip-health 和 --accept-risk。

环境变量 FIREWORKS_API_KEY 在守护进程下不生效怎么办？

确认 key 已写入 ~/.openclaw/.env 或通过 env.shellEnv 配置。macOS 上运行 openclaw gateway install 后 ~/.openclaw/.env 会被引用；其他平台需手动导入环境。运行 openclaw doctor --fix 可自动修复常见环境问题。