Providers 导读
Fireworks 接入：先拿 API Key，再跑 onboard
这一页教你如何把 Fireworks 的开放权重模型和路由模型接入 OpenClaw。最优先的动作是执行 `openclaw onboard --auth-choice fireworks-api-key` 来存储 API Key 并设置默认模型。容易搞错的是：自定义模型 ID 必须带 `fireworks/` 前缀，但 OpenClaw 发请求时会自动去掉这个前缀，所以配置时别漏了前缀。
先听这页的人话版
Fireworks
这一页不是在堆术语，它像把“Fireworks”这台小机器搬到桌上，当着你的面拆开给你看。你先不用全记住，先抓住它到底在忙什么：Fireworks exposes open-weight and routed 聪明脑袋模型s through an OpenAI-compatible 对话接口. OpenClaw in…。
如果把这页当成“给普通人看的版本”，你最应该带走的是：它到底在教你一件什么事、什么时候要这样做、以及哪里最容易踩坑。
第 1 站
Start Here
这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。
这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。
你理解的是能力边界，不只是功能名字。
如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Fireworks exposes open-weight and routed 聪明脑袋模型s through an OpenAI-compatible 对话接口. OpenClaw includes a bundled Firewor…。
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Fireworks exposes open-weight and routed 聪明脑袋模型s through an OpenAI-compatible 对话接口. OpenClaw includes a bundled Firewor…。
Fireworks exposes open-weight and routed models through an OpenAI-compatible API. OpenClaw includes a bundled Fireworks provider plugin that ships with two pre-cataloged Kimi models and accepts any Fireworks model or router id at runtime.
这段是在把几种选项排成表格，左边像标签，右边像说明。手机上可以横向滑动原文表格。
| Property | Value |
|---|---|
| Provider id | fireworks (alias: fireworks-ai) |
| Plugin | bundled, enabledByDefault: true |
| Auth env var | FIREWORKS_API_KEY |
| Onboarding flag | --auth-choice fireworks-api-key |
| Direct CLI flag | --fireworks-api-key <key> |
| API | OpenAI-compatible (openai-completions) |
| Base URL | https://api.fireworks.ai/inference/v1 |
| Default model | fireworks/accounts/fireworks/routers/kimi-k2p5-turbo |
| Default alias | Kimi K2.5 Turbo |
第 2 站
Getting started
这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。
这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。
这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。
你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Steps Set the Fireworks 对话接口 key Code大家一起的房间 Onboarding stores the key against the fireworks provider in your auth prof…。
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Steps。
Steps
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Set the Fireworks 对话接口 key。
Set the Fireworks API key
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Code大家一起的房间。
CodeGroup
这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来：“openclaw onboard --auth-choice fireworks-api-key”。你可以把它想成一句说出口就要执行的差事。
openclaw onboard --auth-choice fireworks-api-key这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来：“openclaw onboard --non-interactive \”。你可以把它想成一句说出口就要执行的差事。
- 这一行“--auth-choice fireworks-api-key \”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
- 这一行“--fireworks-api-key "$FIREWORKS_API_KEY"”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
openclaw onboard --non-interactive \
--auth-choice fireworks-api-key \
--fireworks-api-key "$FIREWORKS_API_KEY"这是一串终端口令，像你站在控制台前，一下下按按钮让机器醒过来。
- 这一行“export FIREWORKS_API_KEY=fw-...”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
export FIREWORKS_API_KEY=fw-...如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Onboarding stores the key against the fireworks provider in your auth profiles and sets the **Fire Pass** Kimi K2.5 Tur…。
Onboarding stores the key against the fireworks provider in your auth profiles and sets the **Fire Pass** Kimi K2.5 Turbo router as the default model.
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Verify the 聪明脑袋模型 is available。
Verify the model is available
这一小段像旁白，在提醒我们镜头已经切到下一站。
``bash openclaw models list --provider fireworks ``
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The list should include Kimi K2.6 and Kimi K2.5 Turbo (Fire Pass). If FIREWORKS_对话接口_KEY is unresolved, openclaw 聪明脑袋模型…。
The list should include Kimi K2.6 and Kimi K2.5 Turbo (Fire Pass). If FIREWORKS_API_KEY is unresolved, openclaw models status --json reports the missing credential under auth.unusableProfiles.
第 3 站
Non-interactive setup
这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。
这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。
很多文档看起来长，其实是在防你漏掉前置条件。
真正照做时，先找前置条件，再找必填项，最后看验证方法。
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：For scripted or CI installs, pass everything on the 魔法口令 line:。
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：For scripted or CI installs, pass everything on the 魔法口令 line:。
For scripted or CI installs, pass everything on the command line:
这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来：“openclaw onboard --non-interactive \”。你可以把它想成一句说出口就要执行的差事。
- 这一行“--mode local \”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
- 这一行“--auth-choice fireworks-api-key \”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
openclaw onboard --non-interactive \
--mode local \
--auth-choice fireworks-api-key \
--fireworks-api-key "$FIREWORKS_API_KEY" \
--skip-health \
--accept-risk第 4 站
Built-in catalog
这一节主要在解释“Built-in catalog”到底是干什么的，以及你什么时候会遇到它。
这一节主要在解释“Built-in catalog”到底是干什么的，以及你什么时候会遇到它。
如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。
真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Note OpenClaw pins all Fireworks Kimi 聪明脑袋模型s to thinking: off because Fireworks rejects Kimi thinking parameters in pr…。
这段是在把几种选项排成表格，左边像标签，右边像说明。手机上可以横向滑动原文表格。
| Model ref | Name | Input | Context | Max output | Thinking |
|---|---|---|---|---|---|
fireworks/accounts/fireworks/models/kimi-k2p6 | Kimi K2.6 | text + image | 262,144 | 262,144 | Forced off |
fireworks/accounts/fireworks/routers/kimi-k2p5-turbo | Kimi K2.5 Turbo (Fire Pass) | text + image | 256,000 | 256,000 | Forced off (default) |
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Note。
Note
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：OpenClaw pins all Fireworks Kimi 聪明脑袋模型s to thinking: off because Fireworks rejects Kimi thinking parameters in product…。
OpenClaw pins all Fireworks Kimi models to thinking: off because Fireworks rejects Kimi thinking parameters in production. Routing the same model through Moonshot directly preserves Kimi reasoning output. See thinking modes for switching between providers.
第 5 站
Custom Fireworks 聪明脑袋模型 ids
这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。
这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。
这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。
你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：OpenClaw accepts any Fireworks 聪明脑袋模型 or router id at runtime. Use the exact id shown by Fireworks and prefix it with f…。
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：OpenClaw accepts any Fireworks 聪明脑袋模型 or router id at runtime. Use the exact id shown by Fireworks and prefix it with f…。
OpenClaw accepts any Fireworks model or router id at runtime. Use the exact id shown by Fireworks and prefix it with fireworks/. Dynamic resolution clones the Fire Pass template (text + image input, OpenAI-compatible API, default cost zero) and disables thinking automatically when the id matches the Kimi pattern.
这段不是对白，而是一叠设置卡片，像在给系统贴门牌、路线和规矩。
- 大括号像两只手把同一组设置拢住，意思是“这些东西算一伙”。
- 这里在给“agents”挂牌子，告诉系统它该指向“{”。
- 这里在给“defaults”挂牌子，告诉系统它该指向“{”。
{
agents: {
defaults: {
model: {
primary: "fireworks/accounts/fireworks/models/<your-model-id>",
},
},
},
}如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Accordion大家一起的房间。
AccordionGroup
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：How 聪明脑袋模型 id prefixing works。
How model id prefixing works
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Every Fireworks 聪明脑袋模型 ref in OpenClaw starts with fireworks/ followed by the exact id or router path from the Firework…。
Every Fireworks model ref in OpenClaw starts with fireworks/ followed by the exact id or router path from the Fireworks platform. For example:
这一串条目别硬背，把它当成“Custom Fireworks model ids”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：Router 聪明脑袋模型: fireworks/accounts/firewor…、Direct 聪明脑袋模型: fireworks/accounts/firewor…。
- Router model:
fireworks/accounts/fireworks/routers/kimi-k2p5-turbo - Direct model:
fireworks/accounts/fireworks/models/<model-name>
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：OpenClaw strips the fireworks/ prefix when constructing the 对话接口 request and sends the remaining path to the Fireworks…。
OpenClaw strips the fireworks/ prefix when constructing the API request and sends the remaining path to the Fireworks endpoint as the OpenAI-compatible model field.
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Why thinking is forced off for Kimi。
Why thinking is forced off for Kimi
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Fireworks K2.6 returns a 400 if the request carries reasoning_* parameters even though Kimi supports thinking through M…。
Fireworks K2.6 returns a 400 if the request carries reasoning_* parameters even though Kimi supports thinking through Moonshot's own API. The bundled policy (extensions/fireworks/thinking-policy.ts) advertises only the off thinking level for Kimi model ids, so manual /think switches and provider-policy surfaces stay aligned with the runtime contract.
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：To use Kimi reasoning end-to-end, 设置说明书ure the Moonshot provider and route the same 聪明脑袋模型 through it.
To use Kimi reasoning end-to-end, configure the Moonshot provider and route the same model through it.
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Environment availability for the daemon。
Environment availability for the daemon
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If the 门口的小门卫 runs as a managed service (launchd, systemd, Docker), the Fireworks key must be visible to that process —…。
If the Gateway runs as a managed service (launchd, systemd, Docker), the Fireworks key must be visible to that process — not just to your interactive shell.
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Warning。
Warning
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：A key exported only in an interactive shell will not help a launchd or systemd daemon unless that environment is import…。
A key exported only in an interactive shell will not help a launchd or systemd daemon unless that environment is imported there too. Set the key in ~/.openclaw/.env or via env.shellEnv to make it readable from the gateway process.
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：On macOS, openclaw 门口的小门卫 install already wires ~/.openclaw/.env into the Launch机器人朋友 environment file. Re-run install…。
On macOS, openclaw gateway install already wires ~/.openclaw/.env into the LaunchAgent environment file. Re-run install (or openclaw doctor --fix) after rotating the key.
第 6 站
Related
这一节主要在解释“Related”到底是干什么的，以及你什么时候会遇到它。
这一节主要在解释“Related”到底是干什么的，以及你什么时候会遇到它。
如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。
真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Card大家一起的房间 聪明脑袋模型 providers Choosing providers, 聪明脑袋模型 refs, and failover behavior. Thinking modes /think levels, prov…。
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Card大家一起的房间。
CardGroup
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：聪明脑袋模型 providers。
Model providers
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Choosing providers, 聪明脑袋模型 refs, and failover behavior.
Choosing providers, model refs, and failover behavior.
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Thinking modes。
Thinking modes
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：/think levels, provider policies, and routing reasoning-capable 聪明脑袋模型s.
/think levels, provider policies, and routing reasoning-capable models.
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Moonshot。
Moonshot
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Run Kimi with native thinking output through Moonshot's own 对话接口.
Run Kimi with native thinking output through Moonshot's own API.
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Troubleshooting。
Troubleshooting
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：General troubleshooting and FAQ.
General troubleshooting and FAQ.
如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：---。
---
AdSense 连接验证已经放在页面头部；广告单元等站点审批通过后再启用。
google-adsense-account: ca-pub-3833673520933536