Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

docs/providers/chutes.md

@@ -0,0 +1,156 @@
+---
+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>