Troubleshooting

Scope

This page is a placeholder generated from the official source file structure.

What to verify

• TODO: Add prerequisites and validation checklist.

Outline (from official headings)

• First 60 seconds
• Common “it broke” cases
• clawdbot: command not found
• Installer fails (or you need full logs)
• Gateway “unauthorized”, can’t connect, or keeps reconnecting
• Control UI fails on HTTP (device identity required)
• docs.clawd.bot shows an SSL error (Comcast/Xfinity)
• Service says running, but RPC probe fails
• Model/auth failures (rate limit, billing, “all models failed”)
• /model says model not allowed
• When filing an issue

Further reading

• Official source file: help/troubleshooting.md