跳转至

Chutes

Chutes 通过兼容 OpenAI 的 API 提供开源模型目录。OpenClaw 同时支持浏览器 OAuth 和 API 密钥认证。

属性 值
提供商 chutes
插件 官方外部包(@openclaw/chutes-provider)
API 兼容 OpenAI
Base URL https://llm.chutes.ai/v1
认证 OAuth 或 API 密钥(见下文)
运行时环境变量 CHUTES_API_KEY, CHUTES_OAUTH_TOKEN

CHUTES_OAUTH_TOKEN 直接提供已获取的 OAuth 访问令牌(例如在 CI 中),从而绕过下面的交互式浏览器流程。

安装插件

openclaw plugins install @openclaw/chutes-provider

安装会自动应用于正在运行的 Gateway;否则将在下次启动时生效。参见应用更改并检查。

开始使用

两种方式都将默认模型设置为 chutes/zai-org/GLM-5.2-TEE,并注册 Chutes 目录。

1. 运行 OAuth 接入流程

openclaw onboard --auth-choice chutes
OpenClaw 会在本地启动浏览器流程,或者在远程/无头主机上显示 URL + 重定向粘贴流程。OAuth 令牌会通过 OpenClaw 认证配置文件自动刷新。

1. 获取 API 密钥

在 chutes.ai/app/settings/api-keys 创建密钥。

2. 运行 API 密钥接入流程

openclaw onboard --auth-choice chutes-api-key

发现行为

当 Chutes 认证可用时,OpenClaw 使用该凭据查询 GET /v1/models,并使用发现的模型,每个凭据缓存 5 分钟。凭据被拒绝会产生目录认证失败;OpenClaw 不会匿名重试。其他请求失败会产生目录不可用的结果,而非成功的静态列表。成功的空响应仍保持为空。API 密钥和 OAuth 的发现走同一条路径。

Token 价格来自原生 Chutes 模型目录。其数字形式的提示(prompt)、补全(completion)和缓存输入(cached-input)费率均以每百万 token 的美元计价;它们不是按 token 计价的 OpenRouter 费率。不可用或无效的价格元数据并不表示该模型是免费的。

在默认的 models.mode: "merge" 下,新接入会记录提供方和别名,而不会将生成的模型行或价格复制到你的配置中。因此,实时价格可以刷新,而不会覆盖显式编写的模型成本。models.mode: "replace" 会禁用发现,因此在该模式下,接入会保留捆绑目录作为显式离线种子。再次应用提供方设置时,已配置的模型行及其价格会保持不变。

默认别名

OpenClaw 为 Chutes 目录注册了两个便捷别名:

别名 目标模型
chutes-pro chutes/deepseek-ai/DeepSeek-V3.2-TEE
chutes-vision chutes/moonshotai/Kimi-K2.6-TEE

内置入门目录

捆绑的回退目录包含以下当前入门模型,以及两个兼容的前代引用,它们仍可被选择,但在选择器中隐藏:

模型引用 选择器状态
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 隐藏
chutes/Qwen/Qwen3.5-397B-A17B-TEE 隐藏

运行 openclaw models list --all --provider chutes 查看完整列表。

对于仍由原生端点列出的入门模型,其回退价格已根据该端点 2026 年 8 月 31 日的响应刷新。缺失的模型会保留其先前的种子快照:仅凭 feed 中的缺失并不会淘汰已发布的引用,也不会改变其选择器状态。列出的元数据并不能证明你的账户可以调用某个模型。

配置示例

{
  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" },
      },
    },
  },
}
OAuth 覆盖项

通过可选环境变量自定义 OAuth 流程:

变量 用途
CHUTES_CLIENT_ID OAuth 客户端 ID(如未设置则提示输入)
CHUTES_CLIENT_SECRET OAuth 客户端密钥
CHUTES_OAUTH_REDIRECT_URI 重定向 URI(默认 http://127.0.0.1:1456/oauth-callback)
CHUTES_OAUTH_SCOPES 以空格分隔的作用域(默认 openid profile chutes:invoke)

关于重定向应用的要求和帮助,请参阅 Chutes OAuth 文档。

备注
  • Chutes 模型以 chutes/<model-id> 形式注册。
  • Chutes 在流式传输时不报告 token 使用量(supportsUsageInStreaming: false);流结束后仍会显示累计使用量。

模型选择

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

配置参考

完整配置模式,包括提供方设置。

Chutes

Chutes 仪表板和 API 文档。

Chutes API 密钥

创建并管理 Chutes API 密钥。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw