docs: clarify agent auth + sandboxed skills

This commit is contained in:
Peter Steinberger
2026-01-15 04:41:38 +00:00
parent edd8c613d6
commit c4402a1ce5
7 changed files with 52 additions and 0 deletions

View File

@@ -1027,6 +1027,21 @@ Z.AI (GLM models):
If you reference a provider/model but the required provider key is missing, youll get a runtime auth error (e.g. `No API key found for provider "zai"`).
### “No API key found for provider …” after adding a new agent
This usually means the **new agent** has an empty auth store. Auth is per-agent and
stored in:
```
~/.clawdbot/agents/<agentId>/agent/auth-profiles.json
```
Fix options:
- Run `clawdbot agents add <id>` and configure auth during the wizard.
- Or copy `auth-profiles.json` from the main agents `agentDir` into the new agents `agentDir`.
Do **not** reuse `agentDir` across agents; it causes auth/session collisions.
## Model failover and “All models failed”
### How does failover work?
@@ -1081,6 +1096,13 @@ If your model config includes Google Gemini as a fallback (or you switched to a
Fix: either provide Google auth, or remove/avoid Google models in `agents.defaults.model.fallbacks` / aliases so fallback doesnt route there.
### “LLM request rejected: messages.*.thinking.signature required (googleantigravity)”
Cause: the session history contains **thinking blocks without signatures** (often from
an aborted/partial stream). Google Antigravity requires signatures for thinking blocks.
Fix: start a **new session** or set `/thinking off` for that agent.
## Auth profiles: what they are and how to manage them
Related: [/concepts/oauth](/concepts/oauth) (OAuth flows, token storage, multi-account patterns, CLI sync)