mirror of
https://github.com/openclaw/openclaw.git
synced 2026-04-10 00:31:22 +00:00
docs: align provider and onboarding references
This commit is contained in:
@@ -47,6 +47,14 @@
|
||||
"source": "Quick Start",
|
||||
"target": "快速开始"
|
||||
},
|
||||
{
|
||||
"source": "Chutes",
|
||||
"target": "Chutes"
|
||||
},
|
||||
{
|
||||
"source": "Qwen",
|
||||
"target": "Qwen"
|
||||
},
|
||||
{
|
||||
"source": "Diffs",
|
||||
"target": "Diffs"
|
||||
|
||||
@@ -125,6 +125,8 @@ openclaw [--dev] [--profile <name>] <command>
|
||||
channels
|
||||
list
|
||||
status
|
||||
capabilities
|
||||
resolve
|
||||
logs
|
||||
add
|
||||
remove
|
||||
@@ -132,6 +134,9 @@ openclaw [--dev] [--profile <name>] <command>
|
||||
logout
|
||||
directory
|
||||
skills
|
||||
search
|
||||
install
|
||||
update
|
||||
list
|
||||
info
|
||||
check
|
||||
|
||||
@@ -1227,6 +1227,7 @@
|
||||
"pages": [
|
||||
"providers/anthropic",
|
||||
"providers/bedrock",
|
||||
"providers/chutes",
|
||||
"providers/claude-max-api-proxy",
|
||||
"providers/cloudflare-ai-gateway",
|
||||
"providers/deepgram",
|
||||
|
||||
103
docs/providers/chutes.md
Normal file
103
docs/providers/chutes.md
Normal file
@@ -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/<model-id>`.
|
||||
@@ -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)
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user