SUPPORT

HELP.

GETTING STARTED

RUN CLAWDBOT

Make sure your Clawdbot instance is running and reachable from your iPhone. It should be accessible over wss:// or https://. Tailscale is an easy way to expose a local server securely.

ENTER YOUR HOST URL

On first launch, enter your server address in the SERVER URL field. Use wss://host:port for WebSocket or https://host:port for HTTP-only. The app tries WebSocket first and falls back to HTTP polling automatically.

ENTER YOUR AUTH TOKEN

Enter the auth token configured on your Clawdbot server. This is stored on-device only and never leaves your phone except when authenticating with your own server.

TAP CONNECT

The crab will appear. If the connection succeeds it transitions to IDLE within a few seconds. To change credentials later, tap the gear icon on the main screen.

COMMON ISSUES

The app can't reach your server. Check that: (1) Clawdbot is running, (2) the host URL is correct and includes the port, (3) your phone and server are on the same network or connected via Tailscale, and (4) the auth token matches what the server expects. Enable the debug panel with the terminal button to see the raw connection log.

The app validates that the URL is parseable before saving. Make sure it includes a scheme: wss://, ws://, or https://. Bare hostnames like mac-mini.local:18789 without a scheme will not be accepted.

State is inferred from the event stream. If Clawdbot isn't emitting events above the rate threshold (roughly 2 events/second), the app stays in IDLE. Check the debug panel to confirm events are arriving. If they are, the state logic should pick them up within one or two heartbeat cycles.

Yes. When the WebSocket connection can't be established the app automatically falls back to HTTP polling every 15 seconds. You'll see HTTP in the debug panel's Protocol row. The crab will still update, just less frequently. Use the toggle in the debug panel to force one mode or the other.

Tap the gear icon on the main screen. The settings sheet will open with your current credentials pre-filled. Edit either field and tap SAVE. The app will reconnect to the new server automatically.

Open the debug panel with the terminal toggle, then tap the copy icon in the top-right corner of the panel. The full log is copied to your clipboard as plain text.

STATES REFERENCE

STATE	MEANS	FRAME SPEED
IDLE	Connected, no active task. Heartbeat confirmed.	380 ms / frame
WORKING	High event rate — tools firing, files being read or written.	140 ms / frame
THINKING	LLM is generating a response or reasoning through a problem.	280 ms / frame
SLEEPING	No activity for an extended period. Bot is resting.	500 ms / frame
OFFLINE	No connection to the server. Check URL and token.	620 ms / frame

CONTACT

📬

STILL STUCK?

Open an issue on the project repository with your debug log attached (tap copy in the debug panel) and a description of what you expected vs. what happened. That's the fastest path to a fix.