fastclaw-relay

What This Skill Does

The fastclaw-relay skill serves as a secure, real-time bridge between your local OpenClaw Gateway and the FastClaw iOS mobile application. By leveraging Convex as a cloud-native synchronization layer, this skill eliminates the need for complex network configurations, such as port forwarding or VPN tunnels. Instead, both your local machine and your mobile device initiate outbound connections to the cloud, ensuring your local gateway remains protected behind your home or office firewall while remaining fully accessible remotely.

Installation

Getting started is straightforward. First, ensure your OpenClaw environment is updated by running clawhub install fastclaw-relay. Once installed, initiate the pairing sequence using openclaw fastclaw pair. This command generates a unique, time-sensitive QR code containing your deployment credentials. Simply open the FastClaw app on your iOS device, select the connection option, and scan the provided code. The system will automatically handle the handshake, configure local instance IDs, and establish the persistent Convex WebSocket stream.

Use Cases

• Remote Operations: Control your OpenClaw agents while commuting or traveling without exposing local ports to the public internet.
• Real-Time Monitoring: View live chat logs from WhatsApp, Telegram, or internal systems directly on your mobile device as they arrive at your gateway.
• Mobile Agent Commands: Execute tasks, trigger automations, or provide input to ongoing agent workflows while away from your primary workstation.

Example Prompts

1. "FastClaw, fetch the latest summary of my unread messages from the WhatsApp integration."
2. "Trigger the 'morning-briefing' automation workflow and send the results to my mobile dashboard."
3. "List all active session tokens and confirm the relay status is currently connected."

Tips & Limitations

To maintain optimal performance, ensure your OpenClaw Gateway is consistently running in the background. The relay requires an active internet connection on both ends to sync states; if the iOS app is offline, messages will queue via Convex and sync immediately upon reconnection. Note that the relay is strictly limited to message payloads and session state sync—it will never transmit your local API keys or sensitive infrastructure configuration files over the cloud. If you encounter sync latency, check your network environment and verify that the relay process is active using the openclaw fastclaw status command.