docs: add /model allowlist troubleshooting note

This commit is contained in:
Peter Steinberger
2026-01-22 04:28:50 +00:00
parent ff3d8cab2b
commit 55ead9636c
2 changed files with 10 additions and 0 deletions

View File

@@ -53,6 +53,15 @@ Almost always a Node/npm PATH issue. Start here:
- [Models](/cli/models)
- [OAuth / auth concepts](/concepts/oauth)
### `/model` says `model not allowed`
This usually means `agents.defaults.models` is configured as an allowlist. When its non-empty,
only those provider/model keys can be selected.
- Check the allowlist: `clawdbot config get agents.defaults.models`
- Add the model you want (or clear the allowlist) and retry `/model`
- Use `/models` to browse the allowed providers/models
### When filing an issue
Paste a safe report: