diff --git a/docs/.i18n/glossary.zh-CN.json b/docs/.i18n/glossary.zh-CN.json index d1cd3274841..752b6d37303 100644 --- a/docs/.i18n/glossary.zh-CN.json +++ b/docs/.i18n/glossary.zh-CN.json @@ -47,6 +47,14 @@ "source": "Quick Start", "target": "快速开始" }, + { + "source": "Chutes", + "target": "Chutes" + }, + { + "source": "Qwen", + "target": "Qwen" + }, { "source": "Diffs", "target": "Diffs" diff --git a/docs/cli/index.md b/docs/cli/index.md index 45866530b80..12523c95ed2 100644 --- a/docs/cli/index.md +++ b/docs/cli/index.md @@ -125,6 +125,8 @@ openclaw [--dev] [--profile ] channels list status + capabilities + resolve logs add remove @@ -132,6 +134,9 @@ openclaw [--dev] [--profile ] logout directory skills + search + install + update list info check diff --git a/docs/docs.json b/docs/docs.json index 5b77ef50796..da143997bf1 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -1227,6 +1227,7 @@ "pages": [ "providers/anthropic", "providers/bedrock", + "providers/chutes", "providers/claude-max-api-proxy", "providers/cloudflare-ai-gateway", "providers/deepgram", diff --git a/docs/providers/chutes.md b/docs/providers/chutes.md new file mode 100644 index 00000000000..0a080ff73e8 --- /dev/null +++ b/docs/providers/chutes.md @@ -0,0 +1,103 @@ +--- +title: "Chutes" +summary: "Chutes setup (OAuth or API key, model discovery, aliases)" +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 + +[Chutes](https://chutes.ai) exposes open-source model catalogs through an +OpenAI-compatible API. OpenClaw supports both browser OAuth and direct API-key +auth for the bundled `chutes` provider. + +- Provider: `chutes` +- API: OpenAI-compatible +- Base URL: `https://llm.chutes.ai/v1` +- Auth: + - OAuth via `openclaw onboard --auth-choice chutes` + - API key via `openclaw onboard --auth-choice chutes-api-key` + - Runtime env vars: `CHUTES_API_KEY`, `CHUTES_OAUTH_TOKEN` + +## Quick start + +### OAuth + +```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. + +Optional OAuth overrides: + +- `CHUTES_CLIENT_ID` +- `CHUTES_CLIENT_SECRET` +- `CHUTES_OAUTH_REDIRECT_URI` +- `CHUTES_OAUTH_SCOPES` + +### API key + +```bash +openclaw onboard --auth-choice chutes-api-key +``` + +Get your key at +[chutes.ai/settings/api-keys](https://chutes.ai/settings/api-keys). + +Both auth paths register the bundled Chutes catalog and set the default model +to `chutes/zai-org/GLM-4.7-TEE`. + +## 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 bundled static catalog so onboarding and startup still work. + +## Default aliases + +OpenClaw also registers three convenience aliases for the bundled Chutes +catalog: + +- `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 includes current Chutes refs such as: + +- `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" }, + }, + }, + }, +} +``` + +## Notes + +- OAuth help and redirect-app requirements: [Chutes OAuth docs](https://chutes.ai/docs/sign-in-with-chutes/overview) +- API-key and OAuth discovery both use the same `chutes` provider id. +- Chutes models are registered as `chutes/`. diff --git a/docs/providers/index.md b/docs/providers/index.md index c2888b74f62..b13ef671dce 100644 --- a/docs/providers/index.md +++ b/docs/providers/index.md @@ -28,6 +28,7 @@ Looking for chat channel docs (WhatsApp/Telegram/Discord/Slack/Mattermost (plugi - [Amazon Bedrock](/providers/bedrock) - [Anthropic (API + Claude Code CLI)](/providers/anthropic) +- [Chutes](/providers/chutes) - [Cloudflare AI Gateway](/providers/cloudflare-ai-gateway) - [DeepSeek](/providers/deepseek) - [GitHub Copilot](/providers/github-copilot) @@ -48,6 +49,7 @@ Looking for chat channel docs (WhatsApp/Telegram/Discord/Slack/Mattermost (plugi - [OpenRouter](/providers/openrouter) - [Perplexity (web search)](/providers/perplexity-provider) - [Qianfan](/providers/qianfan) +- [Qwen](/providers/qwen) - [Qwen / Model Studio (Alibaba Cloud)](/providers/qwen_modelstudio) - [SGLang (local models)](/providers/sglang) - [StepFun](/providers/stepfun) diff --git a/docs/providers/models.md b/docs/providers/models.md index d633eeeae86..c1ad5e68c74 100644 --- a/docs/providers/models.md +++ b/docs/providers/models.md @@ -26,6 +26,7 @@ model as `provider/model`. - [Anthropic (API + Claude Code CLI)](/providers/anthropic) - [Amazon Bedrock](/providers/bedrock) +- [Chutes](/providers/chutes) - [Cloudflare AI Gateway](/providers/cloudflare-ai-gateway) - [GLM models](/providers/glm) - [MiniMax](/providers/minimax) @@ -35,6 +36,7 @@ model as `provider/model`. - [OpenCode (Zen + Go)](/providers/opencode) - [OpenRouter](/providers/openrouter) - [Qianfan](/providers/qianfan) +- [Qwen](/providers/qwen) - [StepFun](/providers/stepfun) - [Synthetic](/providers/synthetic) - [Vercel AI Gateway](/providers/vercel-ai-gateway) diff --git a/docs/reference/wizard.md b/docs/reference/wizard.md index 356919470ab..1e2412586e5 100644 --- a/docs/reference/wizard.md +++ b/docs/reference/wizard.md @@ -35,8 +35,9 @@ For a high-level overview, see [Onboarding (CLI)](/start/wizard). - **Anthropic setup-token**: still supported as a manual auth flow with `openclaw models auth setup-token --provider anthropic` or `openclaw models auth paste-token --provider anthropic`, but no longer shown in the interactive assistant picker. - **OpenAI Code (Codex) subscription (Codex CLI)**: if `~/.codex/auth.json` exists, onboarding can reuse it. Reused Codex CLI credentials stay managed by Codex CLI; OpenClaw re-reads that source on expiry instead of rotating the copied refresh token itself. - **OpenAI Code (Codex) subscription (OAuth)**: browser flow; paste the `code#state`. - - Sets `agents.defaults.model` to `openai-codex/gpt-5.2` when model is unset or `openai/*`. + - Sets `agents.defaults.model` to `openai-codex/gpt-5.4` when model is unset or `openai/*`. - **OpenAI API key**: uses `OPENAI_API_KEY` if present or prompts for a key, then stores it in auth profiles. + - Sets `agents.defaults.model` to `openai/gpt-5.4` when model is unset, `openai/*`, or `openai-codex/*`. - **xAI (Grok) API key**: prompts for `XAI_API_KEY` and configures xAI as a model provider. - **OpenCode**: prompts for `OPENCODE_API_KEY` (or `OPENCODE_ZEN_API_KEY`, get it at https://opencode.ai/auth) and lets you pick the Zen or Go catalog. - **Ollama**: prompts for the Ollama base URL, offers **Cloud + Local** or **Local** mode, discovers available models, and auto-pulls the selected local model when needed. @@ -178,7 +179,7 @@ Use this reference page for flag semantics and step ordering. ```bash openclaw agents add work \ --workspace ~/.openclaw/workspace-work \ - --model openai/gpt-5.2 \ + --model openai/gpt-5.4 \ --bind whatsapp:biz \ --non-interactive \ --json diff --git a/docs/start/wizard-cli-automation.md b/docs/start/wizard-cli-automation.md index 04ac0276391..ed98c29f977 100644 --- a/docs/start/wizard-cli-automation.md +++ b/docs/start/wizard-cli-automation.md @@ -208,7 +208,7 @@ sessions, and auth profiles. Running without `--workspace` launches the wizard. ```bash openclaw agents add work \ --workspace ~/.openclaw/workspace-work \ - --model openai/gpt-5.2 \ + --model openai/gpt-5.4 \ --bind whatsapp:biz \ --non-interactive \ --json