Reference
Troubleshooting
Common issues by symptom — with the actual fix, not a workaround.
AI CLI is not detected
- Verify the CLI works standalone:
claude --version/codex --version/gemini --version. - Confirm the CLI is on your
$PATH(orPATHon Windows). Restart the app after PATH changes. - Re-authenticate:
claude login/ setOPENAI_API_KEY/gemini auth login.
CAPTCHA on a contact form
Sales Claw stops on CAPTCHA detection and surfaces the run for human handling. Do not try to bypass CAPTCHA — it violates most site policies and applicable law.
Form fields missing or wrong
- Check the screenshot: does the target site use a non-standard markup?
- Add field hints in the per-account override (industry / company profile).
- If the form is consistently wrong, file an issue with the screenshot and HTML snippet.
"UI said success but API returned 500"
Enable Chrome DevTools MCP for pre-send inspection — it captures network status, console output, and the rendered DOM. See Architecture.
Cost spike
- Check the Cost view for which model and task is driving spend.
- Switch heavy boilerplate to a lighter model (Haiku / Codex).
- Lower the per-task max-tokens limit.
Where to file bugs
GitHub Issues or the contact form. Include OS, version, and the relevant log lines.