Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

Fireworks 通过与 OpenAI 兼容的 API 提供开源权重模型和路由模型。OpenClaw 包含一个内置的 Fireworks 提供方插件。
PropertyValue
Providerfireworks
AuthFIREWORKS_API_KEY
APIOpenAI-compatible chat/completions
Base URLhttps://api.fireworks.ai/inference/v1
Default modelfireworks/accounts/fireworks/routers/kimi-k2p5-turbo

入门

1

通过 onboarding 配置 Fireworks 认证

openclaw onboard --auth-choice fireworks-api-key
这会将你的 Fireworks 密钥存储到 OpenClaw 配置中,并将 Fire Pass 入门模型设为默认值。
2

验证模型是否可用

openclaw models list --provider fireworks

非交互示例

对于脚本或 CI 环境,请在命令行中传入所有值:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY" \
  --skip-health \
  --accept-risk

内置目录

Model refNameInputContextMax outputNotes
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6text,image262,144262,144Fireworks 上最新的 Kimi 模型。Fireworks K2.6 请求已禁用思考;如果你需要 Kimi 的思考输出,请直接通过 Moonshot 路由。
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)text,image256,000256,000Fireworks 上默认内置的入门模型
如果 Fireworks 发布了更新的模型,例如新的 Qwen 或 Gemma 版本,你可以直接使用其 Fireworks 模型 id 切换过去,无需等待内置目录更新。

自定义 Fireworks 模型 id

OpenClaw 也支持动态 Fireworks 模型 id。请使用 Fireworks 显示的准确模型或路由 id,并在前面加上 fireworks/
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/routers/kimi-k2p5-turbo",
      },
    },
  },
}
OpenClaw 中的每个 Fireworks 模型引用都以 fireworks/ 开头,后面跟着来自 Fireworks 平台的准确 id 或路由路径。例如:
  • 路由模型:fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
  • 直接模型:fireworks/accounts/fireworks/models/<model-name>
OpenClaw 在构建 API 请求时会去掉 fireworks/ 前缀,并将剩余路径发送到 Fireworks 端点。
如果 Gateway 运行在你的交互式 shell 之外,请确保 FIREWORKS_API_KEY 也对该进程可用。
仅放在 ~/.profile 中的密钥对 launchd/systemd 守护进程没有帮助,除非该环境也被导入其中。请将密钥设置在 ~/.openclaw/.env 中,或通过 env.shellEnv 设置,以确保 gateway 进程可以读取它。

相关内容

模型选择

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

故障排查

常规故障排查和 FAQ。