ClawOn is a client app for OpenClaw — the autonomous AI agent framework. To use ClawOn you need at least one running OpenClaw gateway, its WebSocket URL (e.g. wss://your-gateway.example.com), and an authentication token for that gateway. ClawOn itself does not provide AI capabilities — it connects to a gateway you operate or have access to.
Check the following in order: (1) Confirm your gateway is running and reachable from your device's network. (2) Verify the gateway URL starts with wss:// (not https://). (3) Check that your authentication token is correct and has not expired. (4) If your gateway uses a self-signed certificate, ensure your device trusts it. (5) Check any firewall or VPN that might block WebSocket connections on port 443.
All data — your messages, connection credentials, sessions, and preferences — is stored exclusively on your device in a local SQLite database and platform key-value storage. Nothing is uploaded to our servers. The only external connections ClawOn makes are to your own OpenClaw gateway (via WebSocket) and to Google Fonts CDN to download fonts on first launch. See our Privacy Policy for full details.
Open the Connections screen (the list icon in the navigation bar) and tap the + button. Enter a name, the gateway URL, and your authentication token. Each connection is fully isolated — messages, sessions, and skills from one gateway do not mix with another.
This can happen if the same session key is reused across two connections pointing to the same gateway. Try creating a fresh connection with a new entry rather than duplicating an existing one. If the issue persists, clear the session from the Sessions screen and start a new one. If you consistently reproduce the problem, please open a GitHub issue with steps to reproduce.
Open Settings → Language and select your preferred language. ClawOn supports 25 languages including Arabic, Persian, and Urdu (right-to-left). The change takes effect immediately without restarting the app.
Uninstalling ClawOn from your device removes all locally stored data, including all connections, messages, sessions, and preferences. Alternatively, use your device's "Clear App Data" option in system settings. There is no data stored on any remote server to delete.
ClawOn is fully open source under the MIT License. The source code, architecture documentation, and setup instructions are all on GitHub. The app is built with Flutter and uses MobX for state management, Drift for local storage, and the OpenClaw Gateway Protocol v3 for communication.
Troubleshooting guides
Connection not working
1Confirm your gateway process is running on the host machine
2Ping the gateway host from your device's network
3Verify the URL uses wss:// not https://
4Double-check your authentication token for typos
5Check that port 443 (or your gateway's port) is open
6Disable any VPN temporarily to test
Messages not sending
1Check the connection status indicator (top of chat screen)
2If status is "Reconnecting", wait for reconnect to complete
3Pull down to refresh the connection if stuck
4Verify your token has operator.write scope on the gateway
5Try deleting and re-adding the connection
Skills not loading
1Ensure you are connected (skills are fetched live from gateway)
2Pull down on the Skills screen to refresh
3Verify skills are installed on your gateway instance
4Check that your token has read permission for skills
App is slow or crashing
1Force-close and relaunch the app
2Check available device storage (SQLite DB grows with messages)
3Archive old sessions to reduce database size
4Update to the latest version from your app store
5Report the crash with device model and OS version on GitHub