Chutes Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: Chutes

개요

이 페이지는 OpenClaw Chutes provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Chutes setup (OAuth or API key, model discovery, aliases)

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

Property	Value
Provider	chutes
Plugin	official external package (@openclaw/chutes-provider)
API	OpenAI-compatible
Base URL	https://llm.chutes.ai/v1
Auth	OAuth or API key (see below)
Runtime env vars	CHUTES_API_KEY, CHUTES_OAUTH_TOKEN

공식 문서 기반 상세

아래는 공식 providers/chutes 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

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

Property	Value
Provider	chutes
Plugin	official external package (@openclaw/chutes-provider)
API	OpenAI-compatible
Base URL	https://llm.chutes.ai/v1
Auth	OAuth or API key (see below)
Runtime env vars	CHUTES_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

시작하기

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

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.
  





  

Get an API key

    Create a key at
    [chutes.ai/settings/api-keys](https://chutes.ai/settings/api-keys).
  

  

Run the API key onboarding flow

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

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 two convenience aliases for the Chutes catalog:

Alias	Target model
chutes-pro	chutes/deepseek-ai/DeepSeek-V3.2-TEE
chutes-vision	chutes/moonshotai/Kimi-K2.5-TEE

Built-in starter catalog

The bundled fallback catalog contains these five currently served models:

Model ref
chutes/zai-org/GLM-5-TEE
chutes/deepseek-ai/DeepSeek-V3.2-TEE
chutes/moonshotai/Kimi-K2.5-TEE
chutes/MiniMaxAI/MiniMax-M2.5-TEE
chutes/Qwen/Qwen3.5-397B-A17B-TEE

Run openclaw models list --all --provider chutes for the full list.

설정 예시

{
  agents: {
    defaults: {
      model: { primary: "chutes/zai-org/GLM-5-TEE" },
      models: {
        "chutes/zai-org/GLM-5-TEE": { alias: "Chutes GLM 5" },
        "chutes/deepseek-ai/DeepSeek-V3.2-TEE": { alias: "Chutes DeepSeek V3.2" },
      },
    },
  },
}

OAuth overrides

Customize the OAuth flow with optional environment variables:

| Variable | Purpose |
| -------- | ------- |
| `CHUTES_CLIENT_ID` | OAuth client id (prompted if unset) |
| `CHUTES_CLIENT_SECRET` | OAuth client secret |
| `CHUTES_OAUTH_REDIRECT_URI` | Redirect URI (default `http://127.0.0.1:1456/oauth-callback`) |
| `CHUTES_OAUTH_SCOPES` | Space-separated scopes (default `openid profile chutes:invoke`) |

See the [Chutes OAuth docs](https://chutes.ai/docs/sign-in-with-chutes/overview)
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.

관련 문서

Provider rules, model refs, and failover behavior.


Full config schema including provider settings.


Chutes dashboard and API docs.


Create and manage Chutes API keys.

검증 체크리스트

• openclaw models list --provider chutes 로 모델이 보이는지 확인
• 기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
• API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
• failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

관련

• Provider 목록 인덱스
• 로컬 모델과 Provider
• 공식: Provider directory, Model providers