A networking skill for creating private WireGuard meshes and exposing services via Telnyx infrastructure.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install telnyx-network
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 telnyx-network 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 Telnyx Network?
The Telnyx Network skill provides a streamlined way to manage private mesh networking and public IP exposure using Telnyx's global WireGuard infrastructure. It is specifically built to enhance Openclaw Skills by providing secure, encrypted tunnels for agent communication and external service exposure. Whether you are running agents on a local machine or a cloud server, this skill manages the infrastructure lifecycle of gateways and peer connections.
By leveraging this skill, developers can overcome traditional networking hurdles like NAT traversal and complex firewall configurations. It supports both a private Mesh Mode for internal node-to-node traffic and an Expose Mode for assigned public IPs, making it a versatile tool for any distributed agent architecture that requires high-performance, low-latency connectivity.
Telnyx Network Use Cases
- Securely connecting multiple instances of Openclaw Skills across different geographical regions for distributed task processing.
- Exposing local development servers or webhooks to the public internet via a dedicated, stable public IP address.
- Building a private registry for node discovery to facilitate direct peer-to-peer communication between autonomous agents.
- Creating a multi-region mesh network to ensure high availability for agent-based services.
How Telnyx Network Works
- The user initializes the network by selecting a preferred region (e.g., ashburn-va or frankfurt-de) and deploying a Telnyx WireGuard Gateway.
- Local sudoers permissions are configured via a script to allow the agent to manage network interfaces and WireGuard commands without manual password prompts.
- Specific nodes are joined to the mesh, establishing private, encrypted tunnels using the WireGuard protocol.
- Nodes are registered in a cloud-based discovery registry, allowing other instances of Openclaw Skills to find and communicate with them using mesh IPs.
- If required, an Internet Gateway is attached to provide a public IP and open specific ports for external traffic.
Telnyx Network Setup
Ensure you have a Telnyx API Key and WireGuard installed on your machine. To allow Openclaw Skills to manage the network autonomously, run the sudoers setup first:
sudo ./setup-sudoers.sh
Initialize your gateway in a specific region:
./setup.sh --region ashburn-va
Join your local machine to the mesh network:
./join.sh --name "my-node" --apply
Finally, register the node so other agents can discover it:
./register.sh --name "my-node"
Telnyx Network Data Schema & Taxonomy
The skill maintains all state and configuration in a local config.json file to manage the network lifecycle.
| Property | Description |
|---|---|
network_id |
The unique identifier for the virtual network on Telnyx |
region |
The deployment region for the network gateway |
wireguard_gateway |
Object containing the gateway ID, endpoint IP, and subnet |
internet_gateway |
Object containing the public IP details (if Expose Mode is active) |
peers |
A list of all connected nodes and their respective mesh IPs |
exposed_ports |
An array of ports currently allowed through the firewall |
Telnyx Network Advanced Features
- Automated node discovery via a registry stored in Telnyx Storage, enabling seamless multi-agent coordination.
- Multi-region mesh support allowing different gateways to connect to the same logical network.
- Built-in safety firewall that automatically blocks sensitive ports like SSH (22) and common database ports unless forced.
- Support for programmatic integration with JSON output modes for discovery and status commands.
- Seamless integration with Openclaw Skills to enable host-to-local node sessions and direct agent-to-agent comms.
SKILL.md
Loading
Related Openclaw Skills
Telnyx Freemium Upgrade
Automatically transitions Telnyx accounts from freemium restrictions to professional tier capabilities using social identity verification.
10DLC Registration for Sole Proprietors
A streamlined tool for registering 10DLC brands and campaigns to enable compliant A2P SMS messaging in the USA.
DeepSeek Reasoner Lite Agent
A specialized AI agent utilizing DeepSeek R1 reasoning for efficient and high-quality content generation.
Deck Builder
A senior AI architect that transforms requirements into structured, high-fidelity PowerPoint presentations through automated blueprinting and asset coordination.
Backup to Telnyx Storage
A streamlined CLI-based skill to automate the backup and restoration of OpenClaw workspace data to Telnyx S3-compatible storage.
Telnyx STT
A high-performance speech-to-text skill leveraging the Telnyx API and Whisper models to transcribe multiple audio formats into plain text.
Featured*
