What are OpenClaw & RawClaw?
OpenClaw
An open-source personal AI agent framework that runs on your Mac or server. It's the brain — handling chat, automations, skills, and memory.
RawClaw
The companion iOS app that gives you a full mobile dashboard for your OpenClaw agent — chat, automations, memory, skills, and status — from anywhere.
RawClaw connects directly to your OpenClaw gateway over WebSocket. There is no intermediary cloud server — your data stays between your devices.
Prerequisites
-
A running OpenClaw gateway
Follow the OpenClaw setup guide to get your AI agent running on your Mac or server. -
RawClaw installed on your iPhone
Download RawClaw from the App Store (coming soon) or build from source. -
Network connectivity
Both devices need to be reachable — either on the same Wi-Fi or connected via Tailscale for remote access.
Connecting RawClaw to OpenClaw
- Open RawClaw and tap the status pill in the top-right of the Home screen, or go to Settings.
-
Enter your Gateway URL — this is the address where your OpenClaw instance is running (e.g.
http://192.168.1.42:3000for local, orhttp://100.x.x.x:3000for Tailscale). - Enter your Gateway Token — the authentication token from your OpenClaw configuration.
- Tap Test to verify the connection, then Save.
🏠 Option A — Same Wi-Fi (Local Network)
If your phone and the machine running OpenClaw are on the same network, use your Mac's local IP address:
http://192.168.x.x:3000Find your Mac's IP: System Settings → Wi-Fi → Details → IP Address
🌐 Option B — Tailscale (Recommended for Remote Access)
Tailscale creates a secure, encrypted mesh network between your devices — no port forwarding needed, works from anywhere.
- Install Tailscale on your Mac:
brew install tailscaleor download from tailscale.com - Install Tailscale on your iPhone from the App Store
- Sign in to the same Tailscale account on both devices
- Use your Mac's Tailscale IP as the Gateway URL:
http://100.x.x.x:3000
# or use MagicDNS:
http://your-mac-name:3000What Can You Do with RawClaw?
Chat
Real-time messaging with markdown rendering, tool-call transparency, voice input, and file attachments.
Dashboard
Monitor gateway health, token usage, active automations, and connected devices at a glance.
Automations
View, create, toggle, and trigger cron jobs on demand with full run history.
Memory
Browse and edit your AI's context files — SOUL.md, MEMORY.md, USER.md, and more.
Skills
Discover installed capabilities and browse the ClawHub skill registry.
Notifications
Category-based push notifications with deep-linking and quiet hours.
Troubleshooting
Can't connect to the gateway?
- Make sure your OpenClaw gateway is running and accessible from your network.
- Double-check the Gateway URL — include the port number (default is
3000). - Verify the Gateway Token matches your OpenClaw config.
- If using Tailscale, confirm both devices are signed in and showing as connected.
- Try accessing the gateway URL in your phone's browser to rule out network issues.
App crashes or unexpected behavior?
- Make sure you're running the latest version of RawClaw.
- Try force-quitting the app and relaunching.
- Check that your OpenClaw gateway is up to date.
Need more help?
Open an issue on the RawClaw GitHub repo or the OpenClaw GitHub repo.