Troubleshooting

Fixing common problems and contacting support

Agent shows 'Disconnected'

Fix a disconnected agent status caused by gateway, network, session, or firewall issues.

Gateway fails to start

Diagnose and fix port conflicts, missing binaries, token errors, and permission problems.

Cannot sign in

Resolve sign-in failures caused by wrong workspace URL, expired sessions, SSO errors, or unconfirmed email.

Desktop app won't update

Fix a stuck or failing auto-updater by clearing cache or downloading the installer manually.

Cloud desktop not connecting

Fix connection errors for cloud desktops caused by instance state, WebRTC, or firewall issues.

MultiClaw Chrome Extension not detected

Fix detection issues between the Desktop app and the MultiClaw Chrome Extension.

Chat messages not sending

Fix a stuck message input caused by a stopped gateway, missing model, or invalid API key.

Slow agent responses

Understand and reduce latency caused by LLM load, large context, high token limits, or MCP tools.

Data not syncing between desktop and cloud

Fix sync issues caused by a stopped gateway, missing workspace connection, or sync conflicts.

How to reset local data

Safely reset the app window state or remove the local data directory.

Connections blocked by a firewall or proxy

Allowlist the hosts and ports MultiClaw needs so it works behind corporate firewalls and proxies.

Find and share diagnostic logs

Locate the desktop app and gateway logs and share them safely with support.