fastclaw-relay
Connect your OpenClaw to the FastClaw iOS app. Relays messages between your local Gateway and FastClaw via Convex cloud sync. No port forwarding, no VPN — just pair and go.
Install
mkdir -p .claude/skills/fastclaw-relay && curl -L -o skill.zip "https://mcp.directory/api/skills/download/8596" && unzip -o skill.zip -d .claude/skills/fastclaw-relay && rm skill.zipInstalls to .claude/skills/fastclaw-relay
About this skill
FastClaw Relay
Bridges your local OpenClaw Gateway to the FastClaw iOS app via Convex real-time sync.
How It Works
OpenClaw Gateway (local) ←WebSocket→ fastclaw-relay ←Convex→ FastClaw App (iOS)
- The relay connects to your local Gateway WebSocket as an operator client
- Messages sync bidirectionally through Convex (cloud)
- The FastClaw iOS app subscribes to Convex — works from anywhere
No network configuration needed. Both sides connect outbound.
Setup
1. Install the skill
clawhub install fastclaw-relay
2. Start pairing
openclaw fastclaw pair
This displays a QR code containing your Convex deployment URL and a one-time pairing token.
3. Scan from FastClaw app
Open FastClaw → tap "Connect" → scan the QR code. Done.
Configuration
The relay reads from environment or OpenClaw config:
FASTCLAW_CONVEX_URL— Your Convex deployment URL (provisioned during setup)FASTCLAW_INSTANCE_ID— Unique ID for this OpenClaw instance (auto-generated)
These are stored in ~/.openclaw/fastclaw/config.json after first pairing.
Architecture
Convex Schema
The relay uses these Convex tables:
- instances — Registered OpenClaw instances (id, name, status, lastSeen)
- sessions — Chat sessions synced from Gateway
- messages — Individual messages (synced bidirectionally)
- pairingCodes — One-time codes for QR pairing (expire after 5 min)
Gateway Connection
The relay connects to the local Gateway WebSocket (ws://127.0.0.1:18789) using the configured gateway token. It operates as an operator role client with operator.read and operator.write scopes.
Message Flow
User sends from FastClaw app:
- App writes message to Convex
messagestable - Relay receives real-time update via Convex subscription
- Relay forwards message to Gateway WebSocket
- Gateway processes and responds
- Relay captures response and writes to Convex
- App receives response in real-time
Incoming messages (WhatsApp, Telegram, etc.):
- Gateway receives message on any channel
- Relay observes session updates via Gateway WebSocket
- Relay syncs new messages to Convex
- App displays them in real-time
Security
- Pairing codes expire after 5 minutes
- All Convex communication is over TLS
- Instance tokens are stored locally in
~/.openclaw/fastclaw/ - The relay only syncs message content — no API keys, tokens, or config
- Gateway token never leaves the local machine
- Open source for full auditability
Troubleshooting
Relay not connecting
- Check Gateway is running:
openclaw gateway status - Verify gateway token matches: check
~/.openclaw/config.yaml
Messages not syncing
- Check relay process:
openclaw fastclaw status - Verify Convex deployment:
npx convex dashboard
Re-pairing
- Run
openclaw fastclaw pair --resetto generate a new pairing code
More by openclaw
View all skills by openclaw →You might also like
flutter-development
aj-geddes
Build beautiful cross-platform mobile apps with Flutter and Dart. Covers widgets, state management with Provider/BLoC, navigation, API integration, and material design.
drawio-diagrams-enhanced
jgtolentino
Create professional draw.io (diagrams.net) diagrams in XML format (.drawio files) with integrated PMP/PMBOK methodologies, extensive visual asset libraries, and industry-standard professional templates. Use this skill when users ask to create flowcharts, swimlane diagrams, cross-functional flowcharts, org charts, network diagrams, UML diagrams, BPMN, project management diagrams (WBS, Gantt, PERT, RACI), risk matrices, stakeholder maps, or any other visual diagram in draw.io format. This skill includes access to custom shape libraries for icons, clipart, and professional symbols.
ui-ux-pro-max
nextlevelbuilder
"UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient."
godot
bfollington
This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.
nano-banana-pro
garg-aayush
Generate and edit images using Google's Nano Banana Pro (Gemini 3 Pro Image) API. Use when the user asks to generate, create, edit, modify, change, alter, or update images. Also use when user references an existing image file and asks to modify it in any way (e.g., "modify this image", "change the background", "replace X with Y"). Supports both text-to-image generation and image-to-image editing with configurable resolution (1K default, 2K, or 4K for high resolution). DO NOT read the image file first - use this skill directly with the --input-image parameter.
pdf-to-markdown
aliceisjustplaying
Convert entire PDF documents to clean, structured Markdown for full context loading. Use this skill when the user wants to extract ALL text from a PDF into context (not grep/search), when discussing or analyzing PDF content in full, when the user mentions "load the whole PDF", "bring the PDF into context", "read the entire PDF", or when partial extraction/grepping would miss important context. This is the preferred method for PDF text extraction over page-by-page or grep approaches.
Related MCP Servers
Browse all serversConnect Blender to Claude AI for seamless 3D modeling. Use AI 3D model generator tools for faster, intuitive, interactiv
MCP Toolbox for Databases by Google. An open-source server that lets AI agents query Cloud SQL, Spanner, AlloyDB, and ot
The fullstack MCP framework for developing MCP apps for ChatGPT, Claude, and building MCP servers for AI agents. Connect
Empower AI with the Exa MCP Server—an AI research tool for real-time web search, academic data, and smarter, up-to-date
Manage resources in the Cloudflare Workers Platform easily by connecting to your Worker via Bindings.
Access Cloudflare documentation fast via a Cloudflare Worker using an indexed Vectorize DB. Ideal for Cloudflare API doc
Stay ahead of the MCP ecosystem
Get weekly updates on new skills and servers.