A powerful utility for AI agents to acquire disposable phone numbers and automate OTP verification for website signups using crypto payments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install shadow-phone
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install shadow-phone using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Shadow Number?
The Shadow Number skill enables AI agents to bypass phone verification hurdles by providing temporary, disposable phone numbers from over 60 countries. It integrates seamlessly with the x402 protocol, allowing for automated micro-payments of approximately $0.10 USDC on the Base network to secure numbers for popular services like Telegram, WhatsApp, and Google.
This skill is a core component of Openclaw Skills designed to streamline the lifecycle of account creation and identity management in automated workflows. By handling the complexities of API polling and real-time SMS reception, it empowers developers to build agents that can independently navigate signup forms and verification gates while maintaining privacy and operational efficiency.
Shadow Number Use Cases
- Automated account creation on platforms requiring SMS verification.
- Maintaining user privacy by using temporary numbers instead of personal contact information.
- Scalable testing of signup flows and user onboarding in different geographic regions.
- Bypassing regional restrictions by selecting specific country codes for mobile verification.
How Shadow Number Works
- The agent identifies the target service (e.g., Telegram, Gmail) and selects the corresponding service code and country.
- A POST request is made to the Shadow API buy endpoint, which triggers an automated x402 payment of ~$0.10 USDC from the agent wallet.
- The skill returns a real temporary phone number, which the agent enters into the website's registration form.
- The system initiates a polling sequence, checking the OTP endpoint every 15 seconds for the incoming SMS.
- Upon receiving the code, the skill extracts the OTP and automatically populates the verification field on the target site to complete the process.
Shadow Number Setup
To integrate this capability into your workflow using Openclaw Skills, you must provide a valid wallet key for the Base network to handle the automated x402 payments.
export SHADOW_WALLET_KEY=your_private_key_here
The skill communicates with the base API URL: https://extraordinary-charisma-production.up.railway.app. Ensure your wallet has a small balance of USDC on Base to facilitate number purchases.
Shadow Number Data Schema & Taxonomy
The skill utilizes a structured approach to manage temporary number orders and SMS data.
| Data Point | Type | Description |
|---|---|---|
phoneNumber |
String | The temporary mobile number (e.g., 14155552671). |
orderId |
String | Unique identifier used for polling and managing the number lifecycle. |
orderExpireIn |
Integer | Seconds remaining until the number expires (typically 5-10 minutes). |
sms.code |
String | The extracted One-Time Password received via SMS. |
service |
String | The specific service code (e.g., opt29 for WhatsApp). |
Shadow Number Advanced Features
- Automated x402 crypto-payment integration for frictionless, per-number billing.
- Error recovery endpoints (
refuseandban) to handle numbers rejected by the target service. - Support for 60+ country codes, allowing for global geographic simulation.
- Intelligent polling logic that monitors expiration and order status automatically.
- Extensive service support covering major platforms like PayPal, Apple, and Instagram via Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
OpenClaw WhatsApp Bridge
A high-performance WhatsApp bridge for OpenClaw that enables AI-powered auto-replies, message synchronization, and full-text search through a single Go binary.
Demo Video Creator
Automate browser-based product demos and interactive walkthroughs using Playwright and FFmpeg to generate high-quality video or GIF assets.
Claw Werewolf
An automated AI bot variety show that allows agents to compete in strategic werewolf social deduction matches.
Claw Werewolf Live
A competitive variety show platform where AI bots participate in automated Werewolf matches with live spectator viewing.
ClawdNet Agent Skill
Register, discover, and interact with decentralized AI agents through the ClawdNet registry.
ClankerKit
A comprehensive suite for AI agents to manage autonomous smart contract wallets, execute trades, and enforce spending policies on the Monad blockchain.
Featured*
