Get Esim
Skill by inthaiguy
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/inthaiguy/get-esimGet eSIM Skill
Purchase eSIM data packages using USDC on Base Mainnet (or testnet for testing) via the x402 protocol.
Description
This skill enables AI agents to purchase eSIM data packages for users. It uses the x402 payment protocol to pay with USDC on Base Mainnet (default) or Base Sepolia testnet (for testing), then delivers the eSIM installation page.
Default Network: Base Mainnet (production - real eSIMs) Test Network: Base Sepolia (testing - mock eSIMs)
Prerequisites
- A wallet skill or USDC-capable wallet on Base (Mainnet or Sepolia)
- USDC balance for purchases
- ETH for gas (if using
transferscheme)
Suggested wallets: Coinbase Agentic Wallet, any x402-compatible wallet, or any wallet that supports Base USDC transfers.
Network Selection
By default, purchases happen on Base Mainnet (real eSIMs). For testing, explicitly specify the testnet network.
When to Use Each Network
| Network | Use Case | eSIM Type |
|---|---|---|
| Base Mainnet (default) | Production purchases | Real eSIMs |
| Base Sepolia | Development/testing | Mock eSIMs |
Specifying Network
The user can indicate their preference by:
- Saying "testnet", "testing", "mock", or "demo" → Use Sepolia testnet
- Not specifying, or saying "mainnet", "production", "real" → Use Base mainnet (default)
Invocation
Use this skill when a user:
- Asks for an eSIM or mobile data
- Needs cellular data for travel
- Wants to buy a data plan for a specific country
- Mentions needing connectivity abroad
- Requests "test" or "mock" eSIM for development
Important: Transaction Timing
Crypto and eSIM transactions are NOT instant. Expect:
- USDC transfer: 5-15 seconds for on-chain confirmation
- Purchase completion: Additional 3-30 seconds for API to verify the transaction on-chain
- Total purchase flow: Can take 30-60 seconds from payment initiation to eSIM delivery
Inform the user that the purchase is processing and to wait for confirmation.
Workflow
- Determine network: Ask or detect if user wants mainnet (real) or testnet (testing)
- Discover needs: Ask which country they need data for
- Search packages: Query esimqr.link for available packages
- Present options: Show available data plans with prices
- Get selection: User picks a package
- Confirm purchase: Show price, network (mainnet/testnet), and wallet balance, get confirmation
- Execute x402 flow:
- POST to /api/agent/purchase (mainnet) or /api/agent-testnet/purchase (testnet) → receive 402 with payment details
- Pay using your wallet
- Retry POST with payment proof header
- Deliver eSIM: Return the
esimPageUrl- a user-friendly page with QR code and install buttons
Example Conversation
Mainnet (Real eSIM)
User: I need an eSIM for my trip to USA
Agent: I can help you get an eSIM! This will be a real eSIM on Base Mainnet.
[Agent searches packages]
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-inthaiguy-get-esim": {
"enabled": true,
"auto_update": true
}
}
}