telnyx-cli

What This Skill Does

The telnyx-cli skill acts as a powerful bridge between your OpenClaw agent and the Telnyx communication platform. It enables seamless management of global communication infrastructure directly from your command-line environment or via automated agent workflows. The skill supports end-to-end management of SMS, MMS, and WhatsApp messaging, allowing you to send communications, track delivery status, and maintain message logs. Beyond messaging, it provides deep integration with Telnyx phone number management, enabling you to search for new inventory, purchase local or toll-free numbers, and release assets you no longer need. Additionally, the skill includes robust debugging capabilities for webhooks, allowing you to monitor events, diagnose delivery failures, and retry failed transmissions programmatically, ensuring your event-driven applications remain resilient and reliable.

Installation

To integrate this skill, ensure you have the OpenClaw agent installed. Run the command clawhub install openclaw/skills/skills/dotcom-squad/telnyx-cli to download the package. Once installed, ensure you have Node.js available on your system, as the tool depends on the @telnyx/api-cli npm package. After installation, execute telnyx auth setup and provide your production API key obtained from the Telnyx Mission Control portal. This will generate a secure configuration file at ~/.config/telnyx/config.json. You can verify the setup by listing your current inventory using telnyx number list.

Use Cases

This skill is designed for developers and operational teams who require programmatic control over their communication infrastructure. Typical use cases include: automating mass SMS notification campaigns from lists, managing large phone number inventories across different countries for high-volume outbound calling, monitoring webhook health in production environments to catch delivery errors, and programmatically auditing call logs for financial reporting or compliance. It is particularly effective for users who want to treat their Telnyx infrastructure as code.

Example Prompts

1. "Check the status of my account and let me know if my current balance is sufficient for the next 500 SMS messages."
2. "Search for a new US-based phone number with a 415 area code and purchase it for me."
3. "List all failed webhooks from the last hour and retry the most recent one."

Tips & Limitations

Maintain awareness of your API rate limits; for bulk operations like mass messaging, always implement a sleep 1 delay to stay within the 100 req/s limit. The skill defaults to table output, but you can pipe data into tools like jq using the --output json flag for complex data processing. Be mindful that the configuration file stores your credentials locally; ensure your system permissions are locked down. For granular help, you can run any command with the --help flag.