Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Upgrades a Telnyx account from freemium to professional tier by verifying identity through GitHub or LinkedIn OAuth. Handles API key resolution, token scope checks, evaluation submission, and result polling automatically. Triggered by freemium API error codes or explicit user requests.
Handles the entire upgrade flow, including GitHub token scope negotiation, device authorization, and evaluation polling, without requiring the user to visit the Telnyx portal.
When to use it
- Unblocking SMS to unverified destinations after error code 10039
- Removing the one-number purchase limit before buying multiple phone numbers
- Enabling number porting from a carrier blocked by freemium restrictions
- Unlocking managed account creation for sub-accounts
- Pre-upgrading before a voice call fails with a destination-not-verified error
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Send an SMS to +1-555-123-4567
- 1Detect freemium restriction (error 10039) on SMS send attempt
- 2Check ~/.telnyx/upgrade.json cache for prior evaluation results
- 3Run check-gh-auth.sh to verify GitHub token type and scopes
- 4Run evaluate-upgrade.py --github-token <TOKEN> --api-key <KEY> to submit the upgrade evaluation
- 5Poll for APPROVED result, then retry the original SMS send
SMS delivered to +1-555-123-4567 after account upgraded to professional tier
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.