Providers
Chutes
Chutes는 OpenAI 호환 API를 통해 오픈 소스 모델 카탈로그를 제공합니다. OpenClaw는 브라우저 OAuth와 API 키 인증을 모두 지원합니다.
| 속성 | 값 |
|---|---|
| 제공자 | chutes |
| Plugin | 공식 외부 패키지(@openclaw/chutes-provider) |
| API | OpenAI 호환 |
| 기본 URL | https://llm.chutes.ai/v1 |
| 인증 | OAuth 또는 API 키(아래 참조) |
| 런타임 환경 변수 | CHUTES_API_KEY, CHUTES_OAUTH_TOKEN |
CHUTES_OAUTH_TOKEN은 이미 발급받은 OAuth 액세스 토큰을 직접 제공합니다(예: CI에서 사용). 이 경우 아래의 대화형 브라우저 흐름을 건너뜁니다.
Plugin 설치
openclaw plugins install @openclaw/chutes-provideropenclaw gateway restart시작하기
두 경로 모두 기본 모델을 chutes/zai-org/GLM-4.7-TEE로 설정하고 Chutes 카탈로그를 등록합니다.
OAuth
OAuth 온보딩 흐름 실행
openclaw onboard --auth-choice chutesOpenClaw는 로컬에서 브라우저 흐름을 시작하거나 원격/헤드리스 호스트에서 URL과 리디렉션 주소 붙여넣기 흐름을 표시합니다. OAuth 토큰은 OpenClaw 인증 프로필을 통해 자동으로 갱신됩니다.
API 키
API 키 발급
chutes.ai/settings/api-keys에서 키를 생성합니다.
API 키 온보딩 흐름 실행
openclaw onboard --auth-choice chutes-api-key탐색 동작
Chutes 인증을 사용할 수 있으면 OpenClaw는 해당 자격 증명으로 GET /v1/models를 요청하고 탐색된 모델을 사용하며, 자격 증명별로 5분간 캐시합니다. 만료되었거나 권한이 없는 키(HTTP 401)의 경우 OpenClaw는 자격 증명 없이 한 번 재시도합니다. 탐색 결과가 여전히 비어 있거나, 실패하거나, 그 밖의 2xx가 아닌 상태를 반환하면 번들로 제공되는 정적 카탈로그로 대체합니다(API 키 및 OAuth 탐색 모두 동일한 경로를 사용합니다). 시작 시 탐색에 실패하면 정적 카탈로그가 자동으로 사용됩니다.
기본 별칭
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 |
기본 제공 시작용 카탈로그
번들 대체 카탈로그에는 47개 모델이 있습니다. 다음은 현재 참조의 대표적인 예입니다.
| 모델 참조 |
|---|
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 |
전체 목록을 보려면 openclaw models list --all --provider chutes를 실행하세요.
구성 예시
{ 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(기본값 http://127.0.0.1:1456/oauth-callback) |
CHUTES_OAUTH_SCOPES |
공백으로 구분된 범위(기본값 openid profile chutes:invoke) |
리디렉션 앱 요구 사항과 도움말은 Chutes OAuth 문서를 참조하세요.
참고
- Chutes 모델은
chutes/<model-id>형식으로 등록됩니다. - Chutes는 스트리밍 중 토큰 사용량을 보고하지 않습니다(
supportsUsageInStreaming: false). 스트림이 완료되면 사용량 합계는 계속 표시됩니다.