Telnyx

Telnyx — voice, SMS/MMS messaging, SIP trunking, number management, and fax.

Security Scan

The skill appears coherent with its Telnyx integration: it only needs a Telnyx API key and makes calls to api.telnyx.com; nothing in the files indicates hidden endpoints or unrelated credential requests.

Purpose & Capability

Name/description, required env var (TELNYX_API_KEY), and code all target Telnyx REST API (https://api.telnyx.com/v2). The requested credential is appropriate for the stated functionality (SMS, calls, numbers, faxes).

Instruction Scope

Runtime instructions show running the included CLI script. The script will attempt to read TELNYX_API_KEY from the environment and, if absent, will try to read a .env file from WORKSPACE or ~/.openclaw/workspace — this fallback isn't documented in SKILL.md. Also there are coding bugs: many command handlers check getattr(args,'from') but argparse uses dest='from_addr' so those commands will fail unless args attribute names are fixed; this is a functionality bug rather than a hidden behavior.

Install Mechanism

No install spec or external downloads — instruction-only skill with a small Python stdlib-only script included. Nothing is fetched from external or untrusted URLs during install.

Credentials

Only TELNYX_API_KEY is required (declared as primary credential) which is proportionate. The script's fallback to reading a .env file in WORKSPACE or ~/.openclaw/workspace may access stored keys in that file — it only parses the requested variable name, but you should be aware it looks for credentials in that local .env file if the env var is missing.

Persistence & Privilege

always is false and the skill does not modify other skills or system-wide settings. It does not persist secrets or enable itself automatically.

Assessment

This skill is internally consistent for interacting with Telnyx and only asks for TELNYX_API_KEY. Before installing: 1) Verify you want the skill to call api.telnyx.com and provide a Telnyx API key. Use a key with least privilege. 2) Note the script will try a fallback .env lookup in WORKSPACE or ~/.openclaw/workspace if the env var is missing — ensure no sensitive keys are unintentionally stored there. 3) Expect some CLI commands to fail due to an argument-name bug (the code references args attributes that argparse sets under different names); review or test the script locally before using in production. 4) If you plan to let the agent invoke skills autonomously, remember this skill can initiate outbound Telnyx actions (send messages, calls, order numbers) whenever called — limit API key permissions and monitor usage.

Telnyx — voice, SMS/MMS messaging, SIP trunking, number management, and fax.

Requirements

Variable	Required	Description
TELNYX_API_KEY	✅	Telnyx API key (v2)

Quick Start

# Send SMS/MMS
python3 {{baseDir}}/scripts/telnyx.py send-message --from <value> --to <value> --text <value>

# List messages
python3 {{baseDir}}/scripts/telnyx.py list-messages --page-size "25"

# Create outbound call
python3 {{baseDir}}/scripts/telnyx.py create-call --from <value> --to <value> --connection-id <value>

# List active calls
python3 {{baseDir}}/scripts/telnyx.py list-calls

# Get call details
python3 {{baseDir}}/scripts/telnyx.py get-call <id>

# Hang up call
python3 {{baseDir}}/scripts/telnyx.py hangup-call <id>

# List phone numbers
python3 {{baseDir}}/scripts/telnyx.py list-numbers --page-size "25"

# Search available numbers
python3 {{baseDir}}/scripts/telnyx.py search-numbers --country-code "US" --limit "10"

# Order phone number
python3 {{baseDir}}/scripts/telnyx.py order-number --phone-numbers "JSON array"

# List SIP connections
python3 {{baseDir}}/scripts/telnyx.py list-connections

# Create SIP connection
python3 {{baseDir}}/scripts/telnyx.py create-connection --name <value> --connection-type "ip"

# Send a fax
python3 {{baseDir}}/scripts/telnyx.py send-fax --from <value> --to <value> --media-url <value>

# List faxes
python3 {{baseDir}}/scripts/telnyx.py list-faxes

# Get account balance
python3 {{baseDir}}/scripts/telnyx.py get-balance

Output Format

All commands output JSON by default.

Script Reference

Script	Description
{baseDir}/scripts/telnyx.py	Main CLI — all commands in one tool

Credits

Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation