OpenClaw 接入 Fireworks 官方 Provider 插件安装、认证、模型目录与 Kimi 思考策略全解析【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本文聚焦 OpenClaw 项目中官方 Fireworks 模型提供方插件openclaw/fireworks-provider完整讲解从插件安装、API Key 认证到模型目录内置 GLM 5.2 Fast 与 Kimi K2.6 系列的配置与验证流程并深入源码剖析Fireworks 上 Kimi 模型思考能力被强制关闭这一关键行为的底层实现。读完本文你将掌握在 OpenClaw 中接入 Fireworks OpenAI 兼容 API、动态解析任意模型 ID、以及为守护进程正确注入密钥的完整实战方案。Fireworks 插件概览Fireworks 提供开源权重模型与路由router模型并通过 OpenAI 兼容 API 对外服务。OpenClaw 通过官方插件openclaw/fireworks-provider接入当前内置了 Fire Pass 的 GLM 5.2 Fast 路由模型、两款 Kimi 预目录模型并支持在运行时动态解析任意 Fireworks 模型或路由 ID。插件核心属性如下来源官方文档 与 插件清单属性值Provider idfireworks别名fireworks-ai包名openclaw/fireworks-provider认证环境变量FIREWORKS_API_KEY交互式认证标记--auth-choice fireworks-api-key直连 CLI 标记--fireworks-api-key keyAPI 形态OpenAI 兼容openai-completionsBase URLhttps://api.fireworks.ai/inference/v1默认模型fireworks/accounts/fireworks/routers/glm-5p2-fast默认别名GLM 5.2 Fast从插件入口实现 extensions/fireworks/index.ts 可以看到插件通过defineSingleProviderPluginEntry注册声明了aliases: [fireworks-ai]、docsPath: /providers/fireworks并将模型目录配置为discoveryMode: strict、allowExplicitBaseUrl: true、liveModelDiscovery: true——即支持实时模型发现同时允许显式指定 Base URL。插件测试 extensions/fireworks/index.test.ts 中也验证了 provider id、别名与FIREWORKS_API_KEY环境变量的注册关系。快速开始三步接入第一步安装插件openclaw plugins install openclaw/fireworks-provider第二步配置 Fireworks API Key有三种方式可选按需取其一# 方式一交互式 onboarding 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_KEYfw-...Onboarding 会把密钥按fireworksprovider 写入你的 auth profiles并将 Fireworks 当前的 Fire Pass GLM 5.2 Fast 路由模型设为默认模型。--auth-choice fireworks-api-key与--fireworks-api-key key的对应关系定义在插件清单的providerAuthChoices中见 openclaw.plugin.json该配置声明了appGuidedSecret: true说明该密钥属于引导式安全凭证。第三步验证模型可用性openclaw models list --provider fireworks列表中应包含GLM 5.2 Fast、Kimi K2.6、Kimi K2.6 Fast三款模型。如果FIREWORKS_API_KEY未解析openclaw models status --json会在auth.unusableProfiles字段下报告缺失的凭证。非交互式安装脚本 / CI 场景对于脚本化或 CI 安装可一次性把所有参数放在命令行上openclaw onboard --non-interactive \ --mode local \ --auth-choice fireworks-api-key \ --fireworks-api-key $FIREWORKS_API_KEY \ --skip-health \ --accept-risk其中--mode local指定本地运行模式--skip-health跳过健康检查、--accept-risk接受非交互模式下的风险确认适合无人值守的自动化流程。内置模型目录三个预置模型Onboarding 配置应用器extensions/fireworks/onboard.ts会保存连接设置与别名但不会把生成的目录行复制进你的配置文件只有当配置中显式设置models.mode: replace时目录种子catalog seeding才会被启用此时自定义模型行依然保持完整不受影响。内置目录模型如下模型引用名称输入上下文最大输出思考Thinkingfireworks/accounts/fireworks/routers/glm-5p2-fastGLM 5.2 Fasttext256,000256,000开启默认fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6text image262,144262,144强制关闭fireworks/accounts/fireworks/routers/kimi-k2p6-turboKimi K2.6 Fasttext image262,144256,000强制关闭这三行的权威来源是插件清单modelCatalogopenclaw.plugin.json其中还登记了更多细节GLM 5.2 Fastreasoning: true上下文与最大输出均为 256,000成本参数input: 2.1、output: 6.6、cacheRead: 0.21。Kimi K2.6reasoning: false支持文本 图片输入成本参数input: 0.95、output: 4、cacheRead: 0.16。Kimi K2.6 Fastreasoning: false上下文 262,144、最大输出 256,000成本参数input: 2、output: 8、cacheRead: 0.3并带有兼容性标记unsupportedToolSchemaKeywords: [not]提示该模型的工具 schema 不支持not关键字。模型目录构建逻辑集中在 extensions/fireworks/provider-catalog.ts它从插件清单读取 provider 配置导出FIREWORKS_BASE_URL、FIREWORKS_DEFAULT_MODEL_ID、FIREWORKS_DEFAULT_CONTEXT_WINDOW256,000与FIREWORKS_DEFAULT_MAX_TOKENS256,000供入口与 onboard 逻辑复用buildFireworksCatalogModels()会以结构化克隆方式返回清单中的模型行避免外部修改污染清单源数据。注意OpenClaw 将所有 Fireworks Kimi 模型固定为thinking: off原因是 Kimi 在 Fireworks 平台上若不显式关闭思考可能把思维链chain-of-thought泄漏进可见回复中。若希望保留 Kimi 的推理输出可将同一模型改经 Moonshot 直接路由思考模式的跨 provider 切换可参考 思考模式。自定义 Fireworks 模型 IDOpenClaw 在运行时接受任何 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发起 API 请求时OpenClaw 会剥离fireworks/前缀把剩余路径作为 OpenAI 兼容的model字段发给 Fireworks 端点。这一逻辑在 extensions/fireworks/index.ts 的resolveFireworksDynamicModel中实现如果模型 ID 命中内置目录isFireworksCatalogModelId直接返回undefined走目录行否则克隆默认模型模板按是否 Kimi 模型决定reasoning取值并通过isFireworksGlmModelId末段匹配/^glm[-_.]/正则判断输入类型——GLM 为纯文本其余动态 ID 默认为文本 图片。normalizeModelCompat兜底分支会以FIREWORKS_DEFAULT_CONTEXT_WINDOW256,000与FIREWORKS_DEFAULT_MAX_TOKENS256,000为动态模型补齐上下文与输出上限。深入原理为什么 Fireworks 上的 Kimi 思考被强制关闭流层请求载荷补丁Fireworks 以不含独立推理通道的方式服务 Kimi因此思维链可能出现在可见的content流中。为此OpenClaw 对每个 Fireworks Kimi 请求发送thinking: { type: disabled }并从载荷中剥离reasoning、reasoning_effort、reasoningEffort三个字段。实现位于 extensions/fireworks/stream.tswrapFireworksProviderStream仅在 provider 归一化后为fireworks/fireworks-ai、模型 API 为openai-completions且模型 ID 命中 Kimi 判定时生效通过createPayloadPatchStreamWrapper对流请求载荷打补丁。策略层思考等级声明extensions/fireworks/thinking-policy.ts 为 Kimi 模型 ID 返回固定的思考画像levels: [{ id: off }]、defaultLevel: off——即只对外暴露off一个等级。这样手动的/think切换与 provider 策略面provider-policy surfaces都会与运行时契约保持一致避免用户误以为 Kimi 在 Fireworks 上可以开启思考。判定层Kimi 模型 ID 正则extensions/fireworks/model-id.ts 定义了 Kimi 判定正则/^kimi-k2(?:p[56]|[.-][56])(?:[-_].)?$/它匹配kimi-k2p5、kimi-k2p6、kimi-k2.6、kimi-k2-6等末段形态及其带后缀的变体流层补丁、思考策略与动态模型解析三处共用该判定保证行为一致。保留推理的替代路径如需端到端使用 Kimi 推理能力可配置 Moonshot provider将同一模型改经 Moonshot 自有 API 路由即可获得原生思考输出。跨 provider 的思考等级与推理模型路由方式参见 思考模式 与 模型提供方概念。守护进程场景下的密钥可用性如果 Gateway 以托管服务方式运行launchd、systemd、DockerFireworks 密钥必须对该进程可见——仅在交互式 shell 中export是不够的。警告仅在交互式 shell 导出的密钥无法被 launchd 或 systemd 守护进程读取除非把该环境一并导入。请在~/.openclaw/.env中设置密钥或通过env.shellEnv配置使其对 gateway 进程可读。OpenClaw 在加载配置时会读取~/.openclaw/.env因此存放在那里的密钥在每个平台都能被托管 gateway 服务读取到。轮换密钥后请重启 gateway或重新执行openclaw doctor --fix使新密钥生效。相关文档模型提供方概念provider、模型引用与故障转移行为的选择思考模式/think等级、provider 策略与推理模型路由Moonshot provider经 Moonshot 自有 API 运行带原生思考输出的 Kimi故障排查通用排障与 FAQFireworks 插件入口源码 与 插件测试插件注册、别名、动态模型解析的验证用例【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考