Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Developer Tools
Telnyx Cli
Telnyx API integration for Clawdbot. Send SMS/email/WhatsApp messages, manage phone numbers, query call logs, debug webhooks, and access your Telnyx account....
skill openclawclawhub Free
Telnyx API integration for Clawdbot. Send SMS/email/WhatsApp messages, manage phone numbers, query call logs, debug webhooks, and access your Telnyx account....
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- CHANGELOG.md, README.md, SKILL.md, config.json, setup.sh, test.sh
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.1.0
Provenance
- Publisher
- teamtelnyx
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Telnyx CLI
Telnyx API integration for Clawdbot: messaging, phone numbers, webhooks, and account management.
1. Install CLI
npm install -g @telnyx/api-cli
2. Configure API Key
telnyx auth setup Paste your API key from: https://portal.telnyx.com/#/app/api-keys Saves to ~/.config/telnyx/config.json (persistent).
3. Verify
telnyx number list
Commands
CategoryCommandDescriptionMessagingtelnyx message sendSend SMS/email/WhatsApptelnyx message listList messagestelnyx message getGet message statusPhone Numberstelnyx number listYour phone numberstelnyx number searchSearch available numberstelnyx number buyPurchase a numbertelnyx number releaseRelease a numberCallstelnyx call listView callstelnyx call getGet call detailsWebhookstelnyx webhook listList webhookstelnyx debugger listView webhook eventstelnyx debugger retryRetry failed webhooksAccounttelnyx account getAccount info & balance
Messaging
# Send SMS telnyx message send --from +15551234567 --to +15559876543 --text "Hello!" # List messages telnyx message list # Get status telnyx message get MESSAGE_ID
Phone Numbers
# List telnyx number list # Search telnyx number search --country US --npa 415 # Buy telnyx number buy --number "+15551234567" # Release telnyx number release "+15551234567"
Webhooks & Debugging
# List webhooks telnyx webhook list # View failed deliveries telnyx debugger list --status failed # Retry failed telnyx debugger retry EVENT_ID
Account
# Account info telnyx account get # Check balance telnyx account get --output json | jq '.balance'
Output Formats
# Table (default) telnyx number list # JSON telnyx number list --output json # CSV telnyx number list --output csv
Bulk Messaging
#!/bin/bash while read phone; do telnyx message send --from +15551234567 --to "$phone" --text "Hello!" sleep 1 # Rate limiting done < recipients.txt
Monitor Webhooks
#!/bin/bash while true; do FAILED=$(telnyx debugger list --status failed --output json | jq '.data | length') [ "$FAILED" -gt 0 ] && echo "โ ๏ธ $FAILED failed webhooks" sleep 300 done
Export Data
# CSV export telnyx call list --limit 1000 --output csv > calls.csv # JSON export telnyx number list --output json > numbers.json
Tips
Rate limit: 100 req/s โ add sleep 1 for bulk operations Use --output json or --output csv to change format Get help: telnyx COMMAND --help (e.g., telnyx message --help) API Key location: ~/.config/telnyx/config.json
Integration with Clawdbot
# In cron jobs 0 9 * * * telnyx call list --limit 10 > /tmp/daily-calls.txt # In heartbeat telnyx debugger list --status failed # In scripts BALANCE=$(telnyx account get --output json | jq '.balance') echo "Balance: $BALANCE"
Companion Skills
This skill is the primary Telnyx interface. Two companion skills handle account lifecycle steps that this skill cannot: SkillPurposeInstalltelnyx-bot-signupCreate a new account OR sign into an existing one (generates API key)clawhub install telnyx-bot-signuptelnyx-freemium-upgradeUpgrade freemium account to professional tierclawhub install telnyx-freemium-upgrade Note: telnyx-bot-signup handles both signup and signin. The bot_signup endpoint accepts both new and existing emails โ it sends a magic sign-in link either way. The flow is identical: PoW challenge โ email โ magic link โ session token โ API key.
Pre-flight: Before Any Telnyx Operation
Before executing a Telnyx CLI command, run through this checklist: 1. Is `telnyx` CLI installed? NO โ npm install -g @telnyx/api-cli 2. Does ~/.config/telnyx/config.json exist with an api_key? NO โ Hand off to **telnyx-bot-signup** (see below) Works for both new AND existing accounts. 3. Does `telnyx account get` succeed? NO (401 auth error) โ API key is invalid/expired. Hand off to **telnyx-bot-signup** to generate a fresh key. NO (network error) โ Check connectivity. YES โ Proceed with the requested operation.
When to Hand Off to telnyx-bot-signup
Hand off to the telnyx-bot-signup skill when ANY of these are true: No API key exists (~/.config/telnyx/config.json missing or empty, no TELNYX_API_KEY env var) API key exists but telnyx account get returns 401 (key invalid/expired/revoked) User says they lost their API key or can't access the portal User wants to create a new Telnyx account Do NOT ask whether the user has an account or not. The bot_signup endpoint handles both cases transparently โ just ask for their email and proceed. What telnyx-bot-signup does: PoW challenge โ submit email โ magic sign-in link sent to email โ session token โ POST /v2/api_keys โ fresh API key. Works identically for new and existing accounts. After signup/signin completes: Store the returned API key: mkdir -p ~/.config/telnyx echo '{"api_key":"<KEY_FROM_SIGNUP>"}' > ~/.config/telnyx/config.json Also export it for the current session: export TELNYX_API_KEY="<KEY_FROM_SIGNUP>" If the account is new, it starts on freemium tier. Return here and proceed with the original operation. If it hits a freemium wall, the upgrade flow below will trigger automatically.
When to Hand Off to telnyx-freemium-upgrade
Hand off to the telnyx-freemium-upgrade skill when a CLI command fails with a freemium restriction. Detect these scenarios: TriggerHow you see itExampleError 10039SMS send fails: "destination not verified"telnyx message send --to +39... --text "test"Error D60Voice call fails: "destination not verified"Outbound call to unverified numberError 10038Feature blocked: "not available on current plan"Porting, short codes, SIM, managed accountsNumber limit hitSecond telnyx number buy failsAlready have 1 number (freemium max)Cannot add fundsBalance top-up or payment method rejectedFreemium accounts cannot add balanceAccount inactive/deactivatedAccount shows deactivated due to $0 balancetelnyx account get shows inactive status Also trigger proactively when the user's intent clearly requires professional tier before even making the API call: User saysWhy it needs upgrade"Send SMS to +39..." (international)Unverified destination (10039)"Port my number from AT&T"Porting blocked on freemium (10038)"Buy 5 phone numbers"1 number limit on freemium"Set up a SIP trunk"SIP blocked on freemium (10038)"Create a managed account"Managed accounts blocked (10038)"Add $50 to my balance"Freemium can't add funds Before handing off, check if the upgrade was already attempted: 1. Read ~/.telnyx/upgrade.json (cache from the upgrade skill) 2. If decision == "APPROVED" โ Account is already upgraded. Do NOT hand off. Retry the operation directly. If it still fails, the API key may need to be refreshed: telnyx auth setup 3. If decision == "REJECTED" and used_methods includes "github_oauth" โ GitHub method exhausted. Do NOT hand off. Tell the user: "Your upgrade was not approved. Contact support at https://support.telnyx.com or try LinkedIn verification when available." 4. If decision == "PASS_TO_HUMAN" โ Under manual review. Do NOT hand off. Tell the user: "Your upgrade is under review. I'll check back periodically." (The upgrade skill's cron job handles this.) 5. If no cache or status is "failed" / "polling_timeout" โ Hand off to **telnyx-freemium-upgrade**. After upgrade completes (APPROVED): Retry the original operation that triggered the upgrade. If the retry still fails with the same error, the API key needs to be refreshed to pick up professional-tier permissions. Use telnyx-bot-signup to generate a fresh key (same email, sign-in flow) โ this is easier than asking the user to visit the portal.
Full Lifecycle Flow
User: "Send SMS to +393406879636" โ โโโ telnyx CLI installed? โโNOโโโ npm install -g @telnyx/api-cli โ โโโ API key configured? โโNOโโโ **telnyx-bot-signup** (ask for email) โ โ PoW โ magic link โ API key โ โ Store key โ continue โ โโโ API key valid? (`telnyx account get`) โ โโโ NO (401) โ **telnyx-bot-signup** (ask for email) โ โ PoW โ magic link โ fresh API key โ โ Store key โ continue โ โโโ telnyx message send --from ... --to +39... --text "..." โ โ โ โโโ Success โ Done โ โ โ โโโ Error 10039 (destination not verified) โ โ โ โโโ Check upgrade cache (~/.telnyx/upgrade.json) โ โ โโโ APPROVED โ Retry (key may need refresh) โ โ โโโ REJECTED โ Inform user, suggest support โ โ โโโ PASS_TO_HUMAN โ Inform user, wait for review โ โ โโโ No cache / failed โ Continue to upgrade โ โ โ โโโ **telnyx-freemium-upgrade** โ GitHub verification โ poll โ โ โ โโโ APPROVED โ retry SMS (key may need refresh via bot-signup) โ โโโ REJECTED โ Inform user โ โโโ PASS_TO_HUMAN โ Cron job polls, notify on resolution
Companion Skill Not Installed
If you need to hand off but the companion skill is not installed: telnyx-bot-signup missing: I need to set up your Telnyx API key. Install the signup/signin skill: clawhub install telnyx-bot-signup Or get your API key manually from https://portal.telnyx.com/#/app/api-keys and run telnyx auth setup telnyx-freemium-upgrade missing: Your account is on the freemium tier, which doesn't support this operation. Install the upgrade skill: clawhub install telnyx-freemium-upgrade Or upgrade manually via https://portal.telnyx.com/#/account/account-levels/upgrade
CLI not found
npm install -g @telnyx/api-cli
API key not configured
# Reconfigure telnyx auth setup # Or check existing config cat ~/.config/telnyx/config.json
Connection issues
# Test connection telnyx account get
Resources
Telnyx Docs: https://developers.telnyx.com API Portal: https://portal.telnyx.com Telnyx CLI: https://github.com/team-telnyx/telnyx-api-cli
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
3 Docs2 Scripts1 Config
- SKILL.md
- CHANGELOG.md
- README.md
- setup.sh
- test.sh
- config.json