From 365cbe8d50105acfe23a4bc6a5f34a35045458ea Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Tue, 13 Jan 2026 08:02:53 +0000
Subject: [PATCH] docs: clarify Discord requireMention placement

---
 docs/providers/discord.md |  1 +
 docs/start/faq.md         | 23 +++++++++++++++++++++--
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/docs/providers/discord.md b/docs/providers/discord.md
index b225106b6..80b118304 100644
--- a/docs/providers/discord.md
+++ b/docs/providers/discord.md
@@ -176,6 +176,7 @@ Notes:
   - Your guild/channel allowlist denies the channel/user.
 - **`requireMention: false` but still no replies**:
   - `discord.groupPolicy` defaults to **allowlist**; you must either set it to `"open"` or explicitly list the channel under `discord.guilds.<id>.channels`.
+  - `requireMention` must live under `discord.guilds` (or a specific channel). `discord.requireMention` at the top level is ignored.
 - **Permission audits** (`providers status --probe`) only check numeric channel IDs. If you use slugs/names as `discord.guilds.*.channels` keys, the audit can’t verify permissions.
 - **DMs don’t work**: `discord.dm.enabled=false`, `discord.dm.policy="disabled"`, or you haven’t been approved yet (`discord.dm.policy="pairing"`).
 
diff --git a/docs/start/faq.md b/docs/start/faq.md
index fab2c7d4d..07bb2a8a6 100644
--- a/docs/start/faq.md
+++ b/docs/start/faq.md
@@ -1013,6 +1013,23 @@ It means the system attempted to use the auth profile ID `anthropic:default`, bu
 - **Sanity‑check model/auth status**
   - Use `clawdbot models status` to see configured models and whether providers are authenticated.
 
+### Fix checklist for `No credentials found for profile "anthropic:claude-cli"`
+
+This means the run is pinned to the **Claude CLI** profile, but the Gateway
+can’t find that profile in its auth store.
+
+- **Sync the Claude CLI token on the gateway host**
+  - Run `clawdbot models status` (it loads + syncs Claude CLI credentials).
+  - If it still says missing: run `claude setup-token` (or `clawdbot models auth setup-token --provider anthropic`) and retry.
+- **If you want to use an API key instead**
+  - Put `ANTHROPIC_API_KEY` in `~/.clawdbot/.env` on the **gateway host**.
+  - Clear any pinned order that forces `anthropic:claude-cli`:
+    ```bash
+    clawdbot models auth order clear --provider anthropic
+    ```
+- **Confirm you’re running commands on the gateway host**
+  - In remote mode, auth profiles live on the gateway machine, not your laptop.
+
 ### Why did it also try Google Gemini and fail?
 
 If your model config includes Google Gemini as a fallback (or you switched to a Gemini shorthand), Clawdbot will try it during model fallback. If you haven’t configured Google credentials, you’ll see `No API key found for provider "google"`.
@@ -1428,8 +1445,10 @@ By default `discord.groupPolicy` is **allowlist**, so guild channels must be exp
 Fix checklist:
 1) Set `discord.groupPolicy: "open"` **or** add the guild/channel allowlist.
 2) Use **numeric channel IDs** in `discord.guilds.<guildId>.channels`.
-3) Ensure the bot has **Message Content Intent** and channel permissions.
-4) Run `clawdbot providers status --probe` for audit hints.
+3) Put `requireMention: false` **under** `discord.guilds` (global or per‑channel).
+   Top‑level `discord.requireMention` is not a supported key.
+4) Ensure the bot has **Message Content Intent** and channel permissions.
+5) Run `clawdbot providers status --probe` for audit hints.
 
 Docs: [Discord](/providers/discord), [Providers troubleshooting](/providers/troubleshooting).