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 (or PATH on Windows). Restart the app after PATH changes.
  • Re-authenticate: claude login / set OPENAI_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.