通过 openclaw onboard --auth-choice chutes（OAuth）或 chutes-api-key（API Key）完成 Chutes 认证。认证后默认模型为 chutes/zai-org/GLM-4.7-TEE，Chutes 目录自动注册。如果模型发现失败，OpenClaw 自动使用内置静态目录，不影响启动和日常使用。支持三个快捷别名：chutes-fast、chutes-pro、chutes-vision。

OpenClaw Chutes 接入：OAuth 与 API Key 认证配置

Chutes 通过 OpenAI 兼容 API 提供开源模型目录。OpenClaw 内置 chutes provider，支持浏览器 OAuth 和直接 API Key 两种认证方式。

属性	值
Provider	`chutes`
API	OpenAI 兼容
Base URL	`https://llm.chutes.ai/v1`
认证方式	OAuth 或 API Key（见下文）

快速开始

OAuth

运行 OAuth 引导流程

    ```bash
    openclaw onboard --auth-choice chutes
    ```
    OpenClaw 会在本地启动浏览器流程；远程或无头主机上显示 URL + 粘贴 redirect 流程。OAuth Token 通过 OpenClaw 认证档案自动续期。

验证默认模型

    引导完成后，默认模型设为 `chutes/zai-org/GLM-4.7-TEE`，Chutes 内置目录同时注册。

API Key

获取 API Key

    在 [chutes.ai/settings/api-keys](https://chutes.ai/settings/api-keys) 创建 Key。

运行 API Key 引导流程

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

验证默认模型

    引导完成后，默认模型设为 `chutes/zai-org/GLM-4.7-TEE`，Chutes 内置目录同时注册。

INFO

两种认证方式都会注册 Chutes 内置目录并将默认模型设为 chutes/zai-org/GLM-4.7-TEE。运行时环境变量：CHUTES_API_KEY、CHUTES_OAUTH_TOKEN。

模型发现行为

Chutes 认证可用时，OpenClaw 使用该凭证查询 Chutes 目录以获取已发现的模型。如果发现失败，OpenClaw 回退到内置静态目录，确保引导和启动仍能正常工作。

默认别名

OpenClaw 为 Chutes 内置目录注册三个快捷别名：

别名	目标模型
`chutes-fast`	`chutes/zai-org/GLM-4.7-FP8`
`chutes-pro`	`chutes/deepseek-ai/DeepSeek-V3.2-TEE`
`chutes-vision`	`chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506`

内置静态目录

回退时使用的内置目录包含以下 Chutes 模型：

模型引用
`chutes/zai-org/GLM-4.7-TEE`
`chutes/zai-org/GLM-5-TEE`
`chutes/deepseek-ai/DeepSeek-V3.2-TEE`
`chutes/deepseek-ai/DeepSeek-R1-0528-TEE`
`chutes/moonshotai/Kimi-K2.5-TEE`
`chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506`
`chutes/Qwen/Qwen3-Coder-Next-TEE`
`chutes/openai/gpt-oss-120b-TEE`

配置示例

json5

{
  agents: {
    defaults: {
      model: { primary: "chutes/zai-org/GLM-4.7-TEE" },
      models: {
        "chutes/zai-org/GLM-4.7-TEE": { alias: "Chutes GLM 4.7" },
        "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 |
| `CHUTES_OAUTH_SCOPES` | 自定义 OAuth 作用域 |

请参考 [Chutes OAuth 文档](https://chutes.ai/docs/sign-in-with-chutes/overview) 了解 redirect-app 要求和帮助。

注意事项

- API Key 和 OAuth 的模型发现使用同一个 `chutes` provider ID。
- Chutes 模型注册格式为 `chutes/&lt;model-id&gt;`。
- 如果启动时发现失败，自动使用内置静态目录。

常见问题

之前用 OAuth 配置过，现在想改用 API Key，需要重新引导吗？

需要。两种认证方式使用不同的引导选择：--auth-choice chutes 对应 OAuth，chutes-api-key 对应 API Key。运行对应的 openclaw onboard 命令即可切换，引导完成后会覆盖之前的认证信息。

模型发现失败后，内置静态目录的模型够用吗？

内置静态目录包含 8 个当前 Chutes 模型，包括 GLM-4.7-TEE、DeepSeek-V3.2-TEE、Kimi-K2.5-TEE 等主流模型，足以保证大多数场景正常运行。如果你需要最新模型，请检查 Chutes 认证凭证是否有效或网络是否可达。

如何查看当前配置了哪些 Chutes 模型？

引导完成后，可以在 OpenClaw 配置文件中查看 models 字段（路径一般位于 ~/.openclaw/config.json），或者运行 openclaw config get models 查看。Chutes 模型会以 chutes/<model-id> 格式列出。

OpenClaw Chutes 接入：OAuth 与 API Key 认证配置 ​

快速开始 ​

模型发现行为 ​

默认别名 ​

内置静态目录 ​

配置示例 ​

相关文档 ​

常见问题 ​

之前用 OAuth 配置过，现在想改用 API Key，需要重新引导吗？ ​

模型发现失败后，内置静态目录的模型够用吗？ ​

如何查看当前配置了哪些 Chutes 模型？ ​