mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-16 17:21:49 +00:00
f7d7148cf0
Source-grounded rewrite of 529 published docs pages with per-unit information-loss verification: 1,713 factual corrections cited to src/**, generated surfaces regenerated, frontmatter titles preserved for i18n, release notes pages untouched. All docs gates green. Closes #100141
157 lines
5.6 KiB
Markdown
157 lines
5.6 KiB
Markdown
---
|
|
summary: "Chutes setup (OAuth or API key, model discovery, aliases)"
|
|
title: "Chutes"
|
|
read_when:
|
|
- 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](https://chutes.ai) 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
|
|
|
|
```bash
|
|
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.
|
|
|
|
<Tabs>
|
|
<Tab title="OAuth">
|
|
<Steps>
|
|
<Step title="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.
|
|
</Step>
|
|
</Steps>
|
|
</Tab>
|
|
<Tab title="API key">
|
|
<Steps>
|
|
<Step title="Get an API key">
|
|
Create a key at
|
|
[chutes.ai/settings/api-keys](https://chutes.ai/settings/api-keys).
|
|
</Step>
|
|
<Step title="Run the API key onboarding flow">
|
|
```bash
|
|
openclaw onboard --auth-choice chutes-api-key
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
## 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:
|
|
|
|
| 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 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
|
|
|
|
```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" },
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="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.
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="Notes">
|
|
- 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.
|
|
|
|
</Accordion>
|
|
</AccordionGroup>
|
|
|
|
## Related
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Model selection" href="/concepts/model-providers" icon="layers">
|
|
Provider rules, model refs, and failover behavior.
|
|
</Card>
|
|
<Card title="Configuration reference" href="/gateway/configuration-reference" icon="gear">
|
|
Full config schema including provider settings.
|
|
</Card>
|
|
<Card title="Chutes" href="https://chutes.ai" icon="arrow-up-right-from-square">
|
|
Chutes dashboard and API docs.
|
|
</Card>
|
|
<Card title="Chutes API keys" href="https://chutes.ai/settings/api-keys" icon="key">
|
|
Create and manage Chutes API keys.
|
|
</Card>
|
|
</CardGroup>
|