← Back to docs

Troubleshooting

Common issues and how to fix them.

Plugin connection

If the green connection indicator isn't showing in your dashboard:

  • Check your API key format — it should start with cc_
  • Verify your config — open ~/.openclaw/openclaw.json and confirm the key is under channels.crabcallr.accounts.default.apiKey
  • Restart the OpenClaw gateway — the plugin loads on startup, so changes require a restart. Run openclaw gateway restart, or if running in the foreground, press Ctrl+C and run openclaw gateway again.
  • Check your plugin allowlist — if your openclaw.json has a plugins.allow list, make sure "crabcallr" is included. Without it, the gateway won't load the plugin.

Auth error codes:

  • 4001 — Authentication timeout. The server didn't receive credentials in time. Restart the gateway with openclaw gateway restart and try again.
  • 4002 — Invalid message format. Usually means a plugin version mismatch. Update with: openclaw plugins install @wooters/crabcallr
  • 4003 — Invalid API key. Double-check the key in your config matches the one in your CrabCallr dashboard.

Conversation history from previous calls

If your assistant seems to remember things from a previous call, you likely need to configure session.dmScope. After changing the config, restart the gateway with openclaw gateway restart.

Browser calling

  • Microphone not working — Check that your browser has microphone permission for the CrabCallr site. Look for the mic icon in your browser's address bar or check your browser's site settings.
  • No audio from assistant — Make sure your speaker volume is up and not muted. Try reloading the page. If the issue persists, check that the plugin is connected (green indicator on the dashboard).
  • Call drops unexpectedly — This is usually a network issue. Check your internet connection, then restart the gateway with openclaw gateway restart and try again.

Phone calling

  • Phone number won't save — The number must be in E.164 format (e.g. +15551234567) or US 10-digit format (e.g. 5551234567). Dashes, spaces, and parentheses are stripped automatically, but E.164 format is recommended.
  • Calls not routing to my assistant — Verify the registered number in Settings matches the phone you're calling from. Also confirm the CrabCallr plugin is connected (green indicator).

Usage limits

If you've hit your monthly limit, Free accounts are blocked until the 1st of next month. Basic accounts incur overage charges. Track your usage on the dashboard and see Pricing for current limits and rates.

Security sanity checks

If behavior looks unexpected, run these checks first:

  • Run OpenClaw audit — openclaw security audit --deep
    Expected: no critical findings and no warnings about open plugin trust or weak local permissions.
  • Check plugin trust policy — confirm your OpenClaw config uses plugin allowlists and does not broadly load untrusted plugins.
    Expected: only explicitly approved plugin IDs are permitted.
  • Verify service URL — confirm the CrabCallr channel uses wss:// for remote endpoints.
    Expected: encrypted WebSocket transport for non-localhost deployments.

References: OpenClaw Security · Plugin safety notes · CLI security reference · Plugin agent tools

Still stuck?

  • Open your browser console (F12) and check for errors
  • Check OpenClaw logs at ~/.openclaw/logs
  • Try a different browser or network to rule out local issues