English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Providers

Chutes

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

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

Install plugin

Install the official plugin, then restart Gateway:

bash
openclaw plugins install @openclaw/chutes-provideropenclaw gateway restart

Getting started

OAuth

  • Run the OAuth onboarding flow

    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.

  • Verify the default model

    After onboarding, the default model is set to chutes/zai-org/GLM-4.7-TEE and the Chutes static catalog is registered.

    • API key

  • Get an API key

    Create a key at chutes.ai/settings/api-keys.

  • Run the API key onboarding flow

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

  • Verify the default model

    After onboarding, the default model is set to chutes/zai-org/GLM-4.7-TEE and the Chutes static catalog is registered.

    • 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 static catalog so onboarding and startup still work.

    Default aliases

    OpenClaw registers three convenience aliases for the Chutes static 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 static 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

    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 overrides

    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 for redirect-app requirements and help.

    Notes
    • API-key and OAuth discovery both use the same chutes provider id.
    • Chutes models are registered as chutes/<model-id>.
    • If discovery fails at startup, the static catalog is used automatically.
    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.
    Was this useful?
    On this page

    On this page