docs: add anthropic auth error troubleshooting

This commit is contained in:
Peter Steinberger
2026-01-25 00:07:13 +00:00
parent 85b27fe5fe
commit ce89bc2b40
2 changed files with 23 additions and 0 deletions

View File

@@ -31,6 +31,24 @@ See also: [Health checks](/gateway/health) and [Logging](/logging).
## Common Issues
### No API key found for provider "anthropic"
This means the **agents auth store is empty** or missing Anthropic credentials.
Auth is **per agent**, so a new agent wont inherit the main agents keys.
Fix options:
- Re-run onboarding and choose **Anthropic** for that agent.
- Or paste a setup-token on the **gateway host**:
```bash
clawdbot models auth setup-token --provider anthropic
```
- Or copy `auth-profiles.json` from the main agent dir to the new agent dir.
Verify:
```bash
clawdbot models status
```
### OAuth token refresh failed (Anthropic Claude subscription)
This means the stored Anthropic OAuth token expired and the refresh failed.