From 55ead9636c7c6ae7902a4f3a43a49faa633ef727 Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Thu, 22 Jan 2026 04:28:50 +0000 Subject: [PATCH] docs: add /model allowlist troubleshooting note --- CHANGELOG.md | 1 + docs/help/troubleshooting.md | 9 +++++++++ 2 files changed, 10 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index d5e457d2d..355cee7ad 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,7 @@ Docs: https://docs.clawd.bot - Highlight: Lobster optional plugin tool for typed workflows + approval gates. https://docs.clawd.bot/tools/lobster - Memory: prevent CLI hangs by deferring vector probes, adding sqlite-vec/embedding timeouts, and showing sync progress early. - Docs: add troubleshooting entry for gateway.mode blocking gateway start. https://docs.clawd.bot/gateway/troubleshooting +- Docs: add /model allowlist troubleshooting note. (#1405) - Docs: add per-message Gmail search example for gog. (#1220) Thanks @mbelinky. - Onboarding: remove the run setup-token auth option (paste setup-token or reuse CLI creds instead). - Signal: add typing indicators and DM read receipts via signal-cli. diff --git a/docs/help/troubleshooting.md b/docs/help/troubleshooting.md index 94e769764..1cef34b11 100644 --- a/docs/help/troubleshooting.md +++ b/docs/help/troubleshooting.md @@ -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 it’s 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: