Skip to main content
Chutes exposes open-source model catalogs through an OpenAI-compatible API. OpenClaw supports both browser OAuth and API-key auth.
PropertyValue
Providerchutes
Pluginofficial external package (@openclaw/chutes-provider)
APIOpenAI-compatible
Base URLhttps://llm.chutes.ai/v1
AuthOAuth or API key (see below)
Runtime env varsCHUTES_API_KEY, CHUTES_OAUTH_TOKEN
CHUTES_OAUTH_TOKEN supplies an already-obtained OAuth access token directly (for example in CI), bypassing the interactive browser flow below.

​
Install plugin

openclaw plugins install @openclaw/chutes-provider
openclaw gateway restart

​
Getting started

Both paths set the default model to chutes/zai-org/GLM-4.7-TEE and register the Chutes catalog.
1

Run the OAuth onboarding flow

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.

​
Discovery behavior

When Chutes auth is available, OpenClaw queries GET /v1/models with that credential and uses the discovered models, cached for 5 minutes per credential. On an expired/unauthorized key (HTTP 401), OpenClaw retries once without credentials. If discovery still returns no rows, fails, or returns any other non-2xx status, it falls back to the bundled static catalog (both API-key and OAuth discovery use this same path). If discovery fails at startup, the static catalog is used automatically.

​
Default aliases

OpenClaw registers three convenience aliases for the Chutes catalog:
AliasTarget model
chutes-fastchutes/zai-org/GLM-4.7-FP8
chutes-prochutes/deepseek-ai/DeepSeek-V3.2-TEE
chutes-visionchutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506

​
Built-in starter catalog

The bundled fallback catalog has 47 models. A representative sample of current 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
Run openclaw models list --all --provider chutes for the full list.

​
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" },
      },
    },
  },
}
Customize the OAuth flow with optional environment variables:
VariablePurpose
CHUTES_CLIENT_IDOAuth client id (prompted if unset)
CHUTES_CLIENT_SECRETOAuth client secret
CHUTES_OAUTH_REDIRECT_URIRedirect URI (default http://127.0.0.1:1456/oauth-callback)
CHUTES_OAUTH_SCOPESSpace-separated scopes (default openid profile chutes:invoke)
See the Chutes OAuth docs for redirect-app requirements and help.
  • Chutes models are registered as chutes/<model-id>.
  • Chutes does not report token usage while streaming (supportsUsageInStreaming: false); usage totals still show once the stream completes.

Model selection

Provider rules, model refs, and failover behavior.

Configuration reference

Full config schema including provider settings.

Chutes

Chutes dashboard and API docs.

Chutes API keys

Create and manage Chutes API keys.