From 847739441474cb15ae5782e9e144eccb377c48ed Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sun, 25 Jan 2026 02:04:29 +0000
Subject: [PATCH] docs: explain unstuck commands

---
 docs/help/faq.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/help/faq.md b/docs/help/faq.md
index da12ed354..b6810af2b 100644
--- a/docs/help/faq.md
+++ b/docs/help/faq.md
@@ -241,6 +241,14 @@ clawdbot models status
 clawdbot doctor
 ```
 
+What they do:
+- `clawdbot status`: quick snapshot of gateway/agent health + basic config.
+- `clawdbot models status`: checks provider auth + model availability.
+- `clawdbot doctor`: validates and repairs common config/state issues.
+
+Other useful CLI checks: `clawdbot status --all`, `clawdbot logs --follow`,
+`clawdbot gateway status`, `clawdbot health --verbose`.
+
 Quick debug loop: [First 60 seconds if something's broken](#first-60-seconds-if-somethings-broken).
 Install docs: [Install](/install), [Installer flags](/install/installer), [Updating](/install/updating).