Support & Help · v0.6 | iOS · Android · macOS · Windows
ClawClientX is a mobile and desktop client for the OpenClaw self-hosted AI gateway. It gives you a full-featured chat and agentic workspace that runs entirely against your own OpenClaw server - no third-party AI backend, no developer cloud, no telemetry.
You must have an OpenClaw gateway to use this app. ClawClientX is a thin client - it connects over WebSocket to the OpenClaw server you operate. If you have not installed OpenClaw yet, see the OpenClaw documentation before continuing.
Once connected, the app surfaces everything your gateway offers: every AI model you have configured, every skill installed on the server, all paired devices, cron jobs, hooks, and agent activity - all in one place, on any of your devices.
wss://your-hostname or ws://192.168.x.x:port on a local networkFollow these steps the first time you connect a new device. The same flow applies whether you are on iOS, Android, macOS, or Windows.
wss://your-openclaw-host.example.com ws://192.168.1.50:8080Use
wss:// for TLS (strongly recommended over the internet) or ws:// for a plain local connection. Do not include a trailing slash or path.
openclaw devices approveOr use the OpenClaw web admin UI under Devices → find the pending device → Approve. The device name you entered in step 3 will be shown.
If you close the app before approving, the pairing token expires. Return to Settings and tap Reconnect to generate a new pairing request.
ClawClientX supports saving and switching between multiple OpenClaw server connections. Tap the profile selector at the top of the sidebar to add a second gateway, a staging server, or a VPN-only connection. Each profile stores its own URL, auth mode, and device name independently.
This is the most common issue. Work through the checklist:
wss:// (TLS) or ws:// (plain). An https:// or http:// URL will not work.systemctl status openclaw or equivalent.https://your-host in a browser. If the page does not load, the host is not reachable (firewall, DNS, VPN required?).wss://your-host:9000.allowedOrigins: ["*"] in the gateway config during initial setup, then lock it down after pairing.ws:// on a local LAN.openclaw devices list to verify the pending entry appears.openclaw devices approve <device-id> or via the admin UI.ClawClientX calls listModels() on the gateway. If the list is empty:
/models RPC endpoint.The /models slash command inside the app performs the same lookup and will show the same result.
skills.status RPC on your gateway. If the gateway does not have any skills installed, the list will be empty - this is expected. Install skills via ClawHub or directly on the server.https://clawhub.ai/api/v1 for the public marketplace. If your device has no internet access, the marketplace tab will fail while your local gateway skills will still load normally.SpeechRecognition / webkitSpeechRecognition). On iOS, this requires Safari's engine and a live microphone grant.Theme preferences (palette, custom accent, radius mode, light/dark) are persisted on-device via the app's storage layer and survive restarts. If your theme reset:
The Canvas panel embeds your gateway's canvas UI at https://your-gateway/__openclaw__/canvas/ in a resizable iframe. If it is blank:
https://your-gateway/__openclaw__/canvas/ in a browser - if it loads there, the issue is iframe sandboxing. Report this via the support email below.A quick reference to everything ClawClientX surfaces. All features connect back to your OpenClaw gateway - nothing is processed on a developer-operated server.
Run multiple conversations at once, each in its own tab. Pin important sessions, see unread badges, and switch mid-stream without losing context.
Browse and toggle the 150+ skills installed on your gateway. The ClawHub tab lets you discover and install additional skills from the public marketplace.
Switch models per session from a grouped, filterable list of every model your gateway has configured. Supports all major providers.
See all running agents with live tool calls and subagent activity. Kill runaway subagents with one tap. Pop any subagent out into its own window.
See all paired devices, manage approval policies, and run capability commands remotely. Includes live activity per node and a network diagram.
Dictate messages hands-free or enable wake-word listening ("openclaw", "claude", or custom). Talk Mode runs a full listen-think-speak loop.
Paste or drag images directly into the chat input. Attach PDFs, text, JSON, DOCX, and XLSX. Use the camera button to snap a photo inline.
Six named palettes, a custom hex accent, adjustable button colors, and compact/comfortable/spacious radius modes. Full light/dark toggle.
Interactive bar and pie charts showing token consumption and estimated cost across all sessions, accessible from the sidebar or /usage.
Create, pause, and delete scheduled jobs on your gateway from a dedicated view. Set recurring prompts or automation triggers on any schedule.
View and toggle event-driven gateway automations from the Hooks tab in the right panel.
View and patch your OpenClaw gateway configuration directly from the app using the schema-driven editor - no terminal required for common changes.
Open your gateway's canvas UI in a resizable side panel alongside the chat. Resize to any width without leaving the app.
Download any conversation as a Markdown or JSON file with one click from the session context menu.
Pin individual messages within a conversation for quick reference without scrolling back.
Responses arrive token-by-token as the model generates them. Disable streaming in Settings if you are on a low-bandwidth connection.
Type / in any chat input to open the autocomplete menu. A few frequently used commands:
| Command | What it does |
|---|---|
| /models | Open the model picker flyout for the current session |
| /think [level] | Set reasoning depth: off / minimal / low / medium / high / max |
| /task | Route a structured task to your gateway with optional presets (ship-feature, fix-bug, code-audit, research) |
| /agents | Open the agent dashboard |
| /cron | Open cron job management |
| /usage | Open the token usage dashboard |
| /canvas | Toggle or open the canvas side panel |
| /config | Open the gateway config editor |
| /new | Create a new chat session |
| /clear | Clear the current session's message history |
Press Cmd K / Ctrl K anywhere in the app to open the command palette, which provides quick access to all sessions, settings, and commands without typing a slash prefix.
clawhub.ai) with your search text and the skill identifiers you view, and, when you open a skill's detail page, sends that skill's identifier and file hash to a Convex backend (wry-manatee-359.convex.cloud) to fetch malware-scan results. No account, credentials, or conversation data is sent. If you never open the ClawHub browser, none of these calls happen. All other network activity is WebSocket traffic to your own gateway.For the full privacy policy, see privacy policy.
ClawClientX is currently free with no in-app purchases and no active subscriptions. A ClawClientX Pro upgrade is planned for a future release (anticipated one-time purchase, approximately $4.99) that will gate certain power features. Today, every feature in the app is fully unlocked for all users at no cost.
Features listed as "Pro" in the UI are fully accessible today. Billing is disabled in the current release. No credit card is needed, and nothing will charge automatically when Pro pricing launches - it will be an opt-in purchase.
Features planned for Pro gating include: multiple gateway profiles, voice output and Talk Mode, Node command runner, gateway config editor, conversation export, command palette, and custom themes/accents.
If the troubleshooting steps above did not resolve your issue, reach out directly. Include the platform (iOS/Android/macOS/Windows), the app version (visible in Settings → About), and a brief description of what you were doing when the issue occurred.