Skip to content
Merged
2 changes: 1 addition & 1 deletion docs-site/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ summary: "ClawBox is pre-configured AI hardware that runs OpenClaw or Hermes Age
</p>

<Tip>
📺 **Hands-on walkthrough (English voice-over)** — *"ClawBox: A Ferramenta que Muda Como Você Trabalha,"* including a manual ClawBox install via `installer.sh` → [watch on YouTube](https://youtu.be/KMDTF7N8uzU).
📺 **Hands-on walkthrough** — *"I Tested ClawBox — Is This the Future of Personal AI?"* by Bootable USBs → [watch on YouTube](https://www.youtube.com/watch?v=1cekuQjVikU).

📺 **Watch an independent review** — maker Kevin McAleer breaks down *"What is ClawBox, and who is it for?"* → [watch on YouTube](https://www.youtube.com/live/rOkt0Ev-dQ0).

Expand Down
12 changes: 12 additions & 0 deletions docs-site/setup/choose-ai-provider.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,18 @@ Connect** (Jetson Orin Nano) is best paired with cloud providers or smaller loca
See [Hardware](/hardware/clawbox-connect).
</Note>

## Reasoning effort

You can control how hard the model thinks before answering, per conversation, from the brain icon in the chat header (or with `/think <level>`). More thinking gives better results on hard problems and costs more time and tokens.

The available levels depend on the model you are using. With **ClawBox AI**, three are available: **Off** (the fast default), **High**, and **X-High** (maximum reasoning). Off keeps everyday replies quick; you opt in to reasoning when a task needs it.

Other models offer their own sets — some more, some fewer — and models with no reasoning control at all, such as the on-device local model, hide the control completely. The chat header always shows only what the selected model actually supports.

<Note>
For the technical detail of how these levels are configured — and why they are set in code rather than by hand — see [AI Providers → Reasoning effort](/technical/ai-providers#reasoning-effort).
</Note>

Comment thread
coderabbitai[bot] marked this conversation as resolved.
Resolved
## Switching later

You can change provider any time from the device settings — no re-setup required.
21 changes: 21 additions & 0 deletions docs-site/technical/ai-providers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,27 @@ Some native OpenClaw provider plugins expect auth stores ClawBox doesn't populat
- Requests proxy through the portal's AI endpoint; both models advertise reasoning support including **X-High** effort (mapped upstream to DeepSeek's maximum reasoning mode).
- Changing the linked portal account automatically unpairs ClawKeep (backups belong to the account).

### Reasoning effort

ClawBox AI Flash and ClawBox AI Pro expose three reasoning-effort levels, selectable per conversation from the brain icon in the chat header (or with `/think <level>`):

| Level | Behavior |
|---|---|
| `off` | No extended reasoning — the default. Keeps replies fast; you opt in to reasoning when you need it. |
| `high` | Extended reasoning for harder tasks. |
| `xhigh` | Maximum reasoning. |

**The set of levels is per model, not global.** Each provider and model advertises its own supported levels, and the chat header only offers what the selected model actually accepts. Some models expose a different set, some expose more, and models with no reasoning control at all — such as the on-device local model — hide the dial entirely. Selecting a level a model does not support is clamped down to the nearest one it does. So the three above apply to ClawBox AI Flash and Pro, not to every model you can run on a ClawBox.
Comment thread
coderabbitai[bot] marked this conversation as resolved.
Resolved

<Warning>
**The available levels are set programmatically, not by hand-editing config.** Editing `openclaw.json` by hand does not stick — two separate mechanisms will overwrite it:

1. **The gateway re-applies its expected values on every start.** ClawBox's boot-time configuration step rewrites the reasoning-effort metadata on the ClawBox AI models each time the gateway starts, so a manual edit survives only until the next restart.
2. **System updates replace the bundled model catalog.** Updating OpenClaw overwrites the packaged catalog wholesale, so edits made there are lost on the next update. ClawBox re-applies its own values on each boot precisely because of this.

If the levels are not declared, the gateway rejects the higher effort settings and the chat header's **X-High** option silently fails. The levels must therefore be changed in ClawBox's setup and boot-time configuration code, which is the single source of truth.
</Warning>

## Local models (Ollama / llama.cpp)

- Local lanes authenticate with a **per-install bearer token** through a local proxy — nothing is exposed unauthenticated, even on localhost.
Expand Down
Loading