A secure outbound-only relay that enables remote control of OpenClaw nodes without exposing ports or using third-party messaging apps.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install private-bridge
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install private-bridge using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is remote-relay (PrivateBridge)?
PrivateBridge, also known as the remote-relay skill, is a professional-grade communication layer designed for the Openclaw Skills ecosystem. It establishes a secure, outbound-only WebSocket channel between a local OpenClaw instance and a relay server, allowing users to send prompts, execute workflows, and monitor node health from anywhere in the world.
Unlike traditional remote access methods that require complex SSH configurations or reliance on external platforms like Telegram or Discord, this skill provides a native and hardened pathway for remote interaction. It is specifically built for developers and teams who need a reliable way to manage distributed AI nodes while maintaining a zero-trust network posture.
remote-relay (PrivateBridge) Use Cases
- Managing local AI agents from a remote location without the need for a VPN or port forwarding.
- Implementing centralized control for a fleet of distributed OpenClaw instances.
- Running AI workflows in secure environments where inbound network traffic is strictly prohibited.
- Replacing third-party chat integrations with a dedicated, encrypted communication channel for better privacy.
How remote-relay (PrivateBridge) Works
- The skill initiates a TLS-encrypted (WSS) outbound connection to the designated relay server upon startup.
- It authenticates the node using a unique ID and secret token to establish a verified session.
- The node enters an online state and begins sending a heartbeat payload every 15 seconds to report uptime and active tasks.
- Incoming commands from the relay (such as prompts or status requests) are received via the WebSocket and processed locally.
- AI response tokens are streamed back to the relay in real-time, ensuring a low-latency remote experience.
remote-relay (PrivateBridge) Setup
The most efficient way to deploy this addition to your Openclaw Skills library is through the visual dashboard. Navigate to /skill/remote-relay to generate credentials and test the connection. Alternatively, you can configure the environment variables manually:
export RELAY_URL="wss://your-relay-server.com/connect"
export NODE_ID="your-unique-node-id"
export AUTH_TOKEN="your-secure-auth-token"
Once configured, restart your instance to automatically establish the relay connection.
remote-relay (PrivateBridge) Data Schema & Taxonomy
The remote-relay skill organizes communication using a structured JSON protocol to ensure data integrity across the relay.
| Component | Type | Description |
|---|---|---|
| Heartbeat | JSON Object | Includes node_id, uptime, active_tasks, and connection_state. |
| Response Stream | WebSocket Frame | Real-time token delivery with request_id for reconstruction. |
| Capability Set | Metadata | Declares supported actions like remote_chat and remote_trigger. |
| Error Logs | String | Reports the last_error state during heartbeat cycles. |
remote-relay (PrivateBridge) Advanced Features
- Exponential backoff logic for automatic reconnection during network instability.
- Graceful restart capabilities that cancel and report pending tasks to prevent data loss.
- Capability-scoped execution limits that ensure remote commands cannot perform unauthorized system operations.
- Real-time token streaming optimized for high-performance interaction within the Openclaw Skills framework.
- Outbound-only architecture that effectively eliminates the attack surface associated with open listening ports.
SKILL.md
Loading
Related Openclaw Skills
Bind Protocol MCP Server
A protocol-grade MCP server for privacy-preserving credential verification and zero-knowledge proof generation.
gog: Google Workspace CLI
A comprehensive command-line interface for managing Gmail, Calendar, Drive, Contacts, Sheets, and Docs via OAuth.
Skill Creator
A comprehensive framework and toolkit for developing modular extensions that equip AI agents with specialized procedural knowledge and tool integrations.
SchemaPin
A cryptographic security framework for signing and verifying AI tool schemas to prevent tampering and man-in-the-middle attacks.
PPT OOXML Translator
A professional AI agent skill for automating the unpacking, translation, and repacking of PowerPoint (OOXML) documents with structural validation.
AI_AutoTester
AI_AutoTester is an intelligent agent skill designed to automate code testing and validation through structured task analysis and execution.
Featured*
