telnyx-network

What This Skill Does

The telnyx-network skill provides OpenClaw with the capability to manage private mesh networks and expose local services to the public internet using Telnyx's robust WireGuard-based infrastructure. It acts as an abstraction layer over low-level networking tools, allowing the agent to perform complex tasks like network configuration, peer discovery, and port management autonomously. Whether you are connecting distributed home servers or hosting a web service that needs a dedicated public IP, this skill orchestrates the necessary underlying CLI tools to maintain secure, high-performance tunnels.

Installation

To begin, ensure you have WireGuard installed on your host machine. Install the skill into your OpenClaw environment using the command: clawhub install openclaw/skills/skills/dotcom-squad/telnyx-network. For the agent to manage these connections without manual intervention, execute sudo ./setup-sudoers.sh in the skill directory. This creates a fine-grained sudoers rule that permits only the required WireGuard binaries, ensuring security while enabling the agent to maintain network state silently.

Use Cases

• Distributed Edge Computing: Connect multiple machines across different geographical regions into a single flat private network, allowing them to communicate as if they were on the same local subnet.
• Home Lab Exposure: Securely host personal web projects or APIs on your own hardware while obtaining a persistent public IP address provided by Telnyx.
• Secure Remote Access: Establish a private mesh that serves as a secure alternative to public VPNs, facilitating zero-trust communication between development nodes.

Example Prompts

• "OpenClaw, initialize a new mesh network in the ashburn-va region and join this machine to it with the name 'production-node'."
• "List all active peers in our private mesh and check if the 'dev-server' node is currently reachable."
• "Enable public internet access for this node, assign a public IP, and expose port 8080 so I can serve my web application."

Tips & Limitations

• Pricing: Be mindful of the costs associated with different modes. The Mesh mode incurs a $10/month fee for the WireGuard Gateway, while Exposing services adds an Internet Gateway, increasing the total cost to $60/month.
• Permissioning: The sudoers setup is recommended for autonomous operation. Without it, you will need to manually approve network interface changes via sudo prompts whenever the agent attempts to join or teardown a network.
• Discovery: Always run ./register.sh after joining a mesh to ensure your node is visible to other agents on the network via Telnyx Storage.