OpenClaw Chutes 模型提供商插件接入指南OAuth/API Key 认证、模型发现与默认配置详解【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本篇技术指南围绕 OpenClaw 官方外部插件包openclaw/chutes-provider展开完整讲解如何在 OpenClaw 中接入 Chutes一个通过 OpenAI 兼容 API 开放开源模型目录的推理平台包括插件安装、OAuth 与 API Key 两条认证路径、基于GET /v1/models的动态模型发现机制、默认别名与内置启动目录、以及可落地的 JSON5 配置示例。读完本文你将能够独立完成 Chutes 提供商在 OpenClaw 中的安装、认证与模型选择配置并理解其底层实现行为。插件概览与分发方式Chutes 插件为 OpenClaw 增加chutes模型提供商支持属于官方外部插件包其插件参考文档位于 docs/plugins/reference/chutes.md完整使用指南见 docs/providers/chutes.md。属性值Provider 标识chutes插件包官方外部包openclaw/chutes-provider安装渠道npm 或 ClawHubclawhub:openclaw/chutes-providerAPI 兼容OpenAI 兼容openai-completionsBase URLhttps://llm.chutes.ai/v1认证方式OAuth 或 API Key运行时环境变量CHUTES_API_KEY、CHUTES_OAUTH_TOKEN从源码角度插件入口位于 extensions/chutes/index.ts它通过definePluginEntry注册了chutesprovider并同时提供oauth与api-key两种认证方法见 index.ts。插件清单 extensions/chutes/openclaw.plugin.json 声明了providerEndpoints端点类chutes-native主机llm.chutes.ai、modelPricing、providerAuthChoiceschutes与chutes-api-key两个认证选项等元数据。需要注意的是插件清单中activation.onStartup为false但enabledByDefault为true即默认启用但不要求在启动时主动加载由使用场景按需触发。安装插件安装 Chutes 提供商插件并在网关中生效openclaw plugins install openclaw/chutes-provider openclaw gateway restart插件包版本信息可在 extensions/chutes/package.json 查看其中openclaw.install.minHostVersion为2026.6.8compat.pluginApi为2026.9.3安装前请确认宿主 OpenClaw 版本满足这些下限要求。认证接入两条路径无论选择哪条路径完成 onboarding 后 OpenClaw 都会将默认模型设为chutes/zai-org/GLM-5.2-TEE并注册 Chutes 模型目录。方式一OAuth 浏览器认证执行以下命令启动 OAuth onboarding 流程openclaw onboard --auth-choice chutes在本地环境OpenClaw 会直接拉起浏览器完成登录在远程 / 无头 / VPS 环境OpenClaw 会显示一个 URL引导你在本地浏览器中打开登录登录完成后把浏览器地址栏里的完整回调 URL含code与state参数粘贴回终端OAuth 令牌会通过 OpenClaw 的 auth profiles 自动刷新无需手动续期。从实现细节看OAuth 流程实现在 extensions/chutes/oauth.ts采用 PKCEcode_challenge_methodS256授权码模式authorize 端点为https://api.chutes.ai/idp/authorizetoken 端点为https://api.chutes.ai/idp/tokenuserinfo 端点为https://api.chutes.ai/idp/userinfo。本地回调监听默认端口为127.0.0.1:1456/oauth-callback且parseRedirectUri强制要求回调 hostname 必须是 loopbacklocalhost/127.0.0.1/::1否则直接报错见 oauth.ts。回调未在超时时间内默认 3 分钟被检测到时会自动降级为“粘贴回调 URL”的手动模式。方式二API Key 认证先在 chutes.ai/app/settings/api-keys 创建 API Key然后执行openclaw onboard --auth-choice chutes-api-keyonboarding 向导会提示输入 API Key也可以直接通过命令行参数传入--chutes-api-key key对应配置项optionKey: chutesApiKey。API Key 认证方法由createProviderApiKeyAuthMethod工厂创建见 index.ts底层读取环境变量CHUTES_API_KEY。方式三直接注入 OAuth 令牌CI 场景CHUTES_OAUTH_TOKEN环境变量用于直接提供已获取的 OAuth access token从而跳过上述交互式浏览器流程适合 CI 等自动化场景。注意它是“跳过交互”的令牌注入通道与CHUTES_API_KEY是两个独立的运行时环境变量。模型发现行为Discovery Behavior当 Chutes 认证可用时OpenClaw 会携带该凭证调用GET /v1/models即https://llm.chutes.ai/v1/models并使用发现到的模型列表。底层实现在 extensions/chutes/models.ts 的discoverChutesModels缓存每个凭证的发现结果缓存 5 分钟CACHE_TTL 5 * 60 * 1000见 models.ts超时 10 秒严格模式发现过程使用discoveryMode: strict携带Authorization: Bearer token请求头失败语义凭证被拒绝时产生目录认证失败catalog authentication failureOpenClaw不会匿名重试其他请求失败则产生“目录不可用”结果而非回退到静态成功列表成功但返回空列表则保持为空统一路径API Key 与 OAuth 发现共用同一条路径SSRF 防护请求经fetchWithSsrFGuard包裹并依据CHUTES_BASE_URL的主机名生成 SSRF 策略白名单见 models.ts。价格来源与语义Token 价格来自 Chutes 原生模型目录https://llm.chutes.ai/v1/models。其数值型prompt、completion、input_cache_read字段已是每百万 token 的美元单价并非 OpenRouter 那种“每 token 字符串”格式。归一化逻辑见 extensions/chutes/pricing-api.tsprompt → input、completion → output、input_cache_read → cacheReadcacheWrite固定为 0任一必需字段缺失或非法时返回undefined即不认定为免费而是视为价格元数据不可用。价格元数据不可用或无效不意味着该模型是免费的。与 models.mode 的交互默认models.mode: merge下新 onboarding 只记录 provider 与别名不把生成的模型行或价格复制进你的配置这样线上价格刷新不会覆盖你显式编写的模型成本models.mode: replace下禁用发现onboarding 会把内置目录作为显式离线种子保留在该模式下重复应用 provider setup 时已配置的模型行及其价格会被保留。默认别名Default aliasesOpenClaw 为 Chutes 目录注册了两个便捷别名别名目标模型chutes-prochutes/deepseek-ai/DeepSeek-V3.2-TEEchutes-visionchutes/moonshotai/Kimi-K2.6-TEE别名注册逻辑见 extensions/chutes/onboard.ts 的applyChutesProviderConfig除了上述两个具名别名还会为目录内每个模型注册chutes/model-id形式的全量引用。此外applyChutesConfig还会设置默认文本模型primarychutes/zai-org/GLM-5.2-TEEfallback 为 DeepSeek-V3.2-TEE 与 Kimi-K2.6-TEE和默认图像模型primarychutes/moonshotai/Kimi-K2.6-TEEfallbackchutes/Qwen/Qwen3.6-27B-TEE见 onboard.ts。内置启动目录Bundled starter catalog插件自带一份兜底回退目录内置在 extensions/chutes/openclaw.plugin.json 的modelCatalog中包含以下当前启动模型以及两个仍可选用、但已从选择器隐藏的上一代兼容模型引用模型引用选择器状态chutes/zai-org/GLM-5.2-TEE可见chutes/deepseek-ai/DeepSeek-V3.2-TEE可见chutes/moonshotai/Kimi-K2.6-TEE可见chutes/MiniMaxAI/MiniMax-M2.5-TEE可见chutes/Qwen/Qwen3.6-27B-TEE可见chutes/moonshotai/Kimi-K2.5-TEE隐藏deprecated被 K2.6-TEE 取代chutes/Qwen/Qwen3.5-397B-A17B-TEE隐藏deprecated被 Qwen3.6-27B-TEE 取代查看完整列表openclaw models list --all --provider chutes几点补充说明内置启动模型的兜底价格按原生端点2026 年 8 月 31 日响应刷新过某个模型在该端点不再出现时会保留其此前的种子快照——feed 缺席本身不会下架已发布的引用也不会改变其选择器状态列表中存在某个模型不代表你的账号一定可以调用它内置目录中各模型的上下文窗口与价格见 openclaw.plugin.json例如 GLM-5.2-TEE 上下文 1,048,576DeepSeek-V3.2-TEE 上下文 131,072Kimi-K2.6-TEE 上下文 262,144 且支持图文输入。配置示例以下 JSON5 片段演示了如何把 Chutes 模型设为默认并为常用模型配置显示别名{ agents: { defaults: { model: { primary: chutes/zai-org/GLM-5.2-TEE }, models: { chutes/zai-org/GLM-5.2-TEE: { alias: Chutes GLM 5.2 }, chutes/deepseek-ai/DeepSeek-V3.2-TEE: { alias: Chutes DeepSeek V3.2 }, }, }, }, }models段为每个模型引用注册可选别名model.primary指定默认主模型。更完整的配置模式可参考 docs/concepts/model-providers.mdprovider 规则、模型引用与故障转移行为以及 docs/gateway/configuration-reference.md完整配置 schema。OAuth 覆盖环境变量如需定制 OAuth 流程可通过以下可选环境变量覆盖默认行为变量用途CHUTES_CLIENT_IDOAuth client id未设置时会在向导中提示输入CHUTES_CLIENT_SECRETOAuth client secret可选CHUTES_OAUTH_REDIRECT_URI回调 URI默认http://127.0.0.1:1456/oauth-callbackCHUTES_OAUTH_SCOPES空格分隔的 scopes默认openid profile chutes:invoke对应的代码逻辑位于 extensions/chutes/index.tsCHUTES_OAUTH_SCOPES按空白拆分后逐个过滤空串再传入loginChutes。回调 URI 的 loopback 约束、OAuth app 的 redirect-app 要求请参照 Chutes 官方“Sign in with Chutes”文档进行配置。当 OAuth 失败时向导会提示核对CHUTES_CLIENT_ID/CHUTES_CLIENT_SECRET以及回调 URI 是否包含http://127.0.0.1:1456/oauth-callback见 index.ts。使用注意事项模型引用格式Chutes 模型统一注册为chutes/model-id形式例如chutes/deepseek-ai/DeepSeek-V3.2-TEE流式使用统计Chutes 在流式传输过程中不报告 token 用量supportsUsageInStreaming: false该标记由decorateChutesModelDefinition统一附加到所有目录模型见 models.ts用量合计会在流结束后展示令牌刷新OAuth 令牌通过 auth profiles 自动刷新若刷新失败或访问被撤销需重新执行登录。刷新逻辑见refreshChutesOAuthCredentialoauth.ts它使用grant_typerefresh_token调用 token 端点且按 RFC 6749 第 6 节允许不轮换 refresh token令牌过期缓冲令牌有效期解析带 5 分钟缓冲、至少保留 30 秒剩余时长见 oauth.ts。源码结构速览若希望深入源码可按以下路径继续探索文件职责extensions/chutes/index.ts插件入口注册 provider、OAuth 与 API Key 认证、目录运行逻辑extensions/chutes/oauth.tsPKCE OAuth 登录、回调监听、令牌交换与刷新extensions/chutes/models.ts静态目录归一化与动态模型发现5 分钟缓存、SSRF 防护extensions/chutes/onboard.tsonboarding 配置应用默认模型、别名、fallback 模型extensions/chutes/provider-catalog.ts静态/动态 provider 构建OpenAI 兼容 API、Base URLextensions/chutes/pricing-api.ts原生价格USD/百万 token归一化为 cost 对象extensions/chutes/openclaw.plugin.json插件清单认证选项、端点、内置模型目录与价格extensions/chutes/package.json包元数据、宿主版本与插件 API 兼容下限以上便是 OpenClaw 接入 Chutes 提供商的完整路径安装插件 → 选择 OAuth 或 API Key 完成认证 → 理解模型发现与价格语义 → 用别名与配置示例落地到实际 agent 中。核心参考文档为 docs/plugins/reference/chutes.md 与 docs/providers/chutes.md源码佐证集中在 extensions/chutes 目录。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考