Updates

docs/troubleshooting.md

@@ -106,6 +106,15 @@ visibility, or a stale portal grant. Run the three doctor commands before
 changing model settings. Restarting `jarvisd` also clears an active desktop
 grant.
 
+## Groq agent chat fails immediately
+
+Settings → Models → Agent inference → Groq requires a key in the Groq API key
+field, or `GROQ_API_KEY` / `JARVIS_GROQ_API_KEY`. Jarvis does not fall back to
+local QVAC chat. `401` means the key was rejected; `429` is rate limiting.
+Speech, wake, tools, desktop, browser, and camera stay local. Webcam stills
+reach Groq only if you pick a Qwen Groq vision model. Restart `jarvisd` after
+switching between Local QVAC and Groq.
+
 ## Rolling release did not publish
 
 Check the Gitea Actions log and repository secret name. It must be exactly