openclaw/docs/providers/chutes.md

title, summary, read_when

title	summary	read_when
Chutes	Chutes setup (OAuth or API key, model discovery, aliases)	You want to use Chutes with OpenClaw You need the OAuth or API key setup path You want the default model, aliases, or discovery behavior

Chutes

Chutes exposes open-source model catalogs through an OpenAI-compatible API. OpenClaw supports both browser OAuth and direct API-key auth for the bundled chutes provider.

Property	Value
Provider	chutes
API	OpenAI-compatible
Base URL	https://llm.chutes.ai/v1
Auth	OAuth or API key (see below)

Getting started

```bash openclaw onboard --auth-choice chutes ``` OpenClaw launches the browser flow locally, or shows a URL + redirect-paste flow on remote/headless hosts. OAuth tokens auto-refresh through OpenClaw auth profiles. After onboarding, the default model is set to `chutes/zai-org/GLM-4.7-TEE` and the bundled Chutes catalog is registered. Create a key at [chutes.ai/settings/api-keys](https://chutes.ai/settings/api-keys). ```bash openclaw onboard --auth-choice chutes-api-key ``` After onboarding, the default model is set to `chutes/zai-org/GLM-4.7-TEE` and the bundled Chutes catalog is registered. Both auth paths register the bundled Chutes catalog and set the default model to `chutes/zai-org/GLM-4.7-TEE`. Runtime environment variables: `CHUTES_API_KEY`, `CHUTES_OAUTH_TOKEN`.

Discovery behavior

When Chutes auth is available, OpenClaw queries the Chutes catalog with that credential and uses the discovered models. If discovery fails, OpenClaw falls back to a bundled static catalog so onboarding and startup still work.

Default aliases

OpenClaw registers three convenience aliases for the bundled Chutes catalog:

Alias	Target model
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

Built-in starter catalog

The bundled fallback catalog includes current Chutes refs:

Model ref
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

Config example

{
  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" },
      },
    },
  },
}

You can customize the OAuth flow with optional environment variables:

| Variable | Purpose |
| -------- | ------- |
| `CHUTES_CLIENT_ID` | Custom OAuth client ID |
| `CHUTES_CLIENT_SECRET` | Custom OAuth client secret |
| `CHUTES_OAUTH_REDIRECT_URI` | Custom redirect URI |
| `CHUTES_OAUTH_SCOPES` | Custom OAuth scopes |

See the [Chutes OAuth docs](https://chutes.ai/docs/sign-in-with-chutes/overview)
for redirect-app requirements and help.

- API-key and OAuth discovery both use the same `chutes` provider id. - Chutes models are registered as `chutes/`. - If discovery fails at startup, the bundled static catalog is used automatically.

Related

Provider rules, model refs, and failover behavior. Full config schema including provider settings. Chutes dashboard and API docs. Create and manage Chutes API keys.