A comprehensive integration allowing AI agents to browse, purchase, and deliver international eSIM data plans via the eSIMPal API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install esimpal-api
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 esimpal-api 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 eSIMPal API Agent Integration?
The eSIMPal API agent skill is a specialized tool designed for developers building automated assistants, Telegram bots, or WhatsApp integrations that require global connectivity features. As part of the ecosystem of Openclaw Skills, this tool enables an agent to interact with the eSIMPal backend to manage the entire customer journey—from listing country-specific data plans to processing secure payments and delivering activation QR codes.
Security is at the heart of this skill. It enforces strict runtime rules that prevent autonomous or hidden purchases, ensuring every billable action is gated by explicit user confirmation. By utilizing this within your Openclaw Skills setup, you can provide users with a seamless, conversational way to stay connected while traveling without sacrificing control or financial safety.
eSIMPal API Agent Integration Use Cases
- Creating a travel assistant that suggests and buys data plans based on the user's destination.
- Automating eSIM delivery for customer support bots on messaging platforms.
- Building a dashboard that allows users to manage and reactivate existing eSIM profiles.
- Providing real-time currency conversion for international travelers purchasing data packages.
How eSIMPal API Agent Integration Works
- The agent queries the API for available plans based on the user's target country and data needs.
- Once a plan is selected, the agent creates an order using a unique idempotency key to prevent duplicate transactions.
- If the user prefers a different currency, the agent can update the order price using live exchange rates.
- After the user provides explicit consent, the agent generates a checkout URL for secure payment processing.
- The agent monitors the order status through intelligent polling until the eSIM is provisioned.
- Finally, the agent delivers activation details, such as QR codes or one-click install links for iOS and Android, directly to the user.
eSIMPal API Agent Integration Setup
To integrate this into your environment, you must first obtain an API key from the eSIMPal developer dashboard. Configure the key as an environment variable to allow Openclaw Skills to authenticate requests.
export ESIMPAL_API_KEY="your_api_key_here"
Ensure that the API key has the necessary scopes for orders:read and orders:write. All requests are routed through the base API URL: https://getesimpal.com/api.
eSIMPal API Agent Integration Data Schema & Taxonomy
The skill manages data through structured JSON objects representing orders and eSIM packages. Key data elements include:
| Object | Field | Description |
|---|---|---|
| Order | order_id |
Unique UUID for the transaction. |
| Order | status |
Current state: created, ready, failed, or cancelled. |
| Package | package_id |
Unique identifier for a specific eSIM in an order. |
| Activation | ios_activation_url |
Deep link for one-click installation on Apple devices. |
| Activation | qr_code_url |
URL to retrieve the PNG image of the activation QR code. |
| Profile | esim_profile_id |
Identifier for a user's specific device profile. |
eSIMPal API Agent Integration Advanced Features
- Robust idempotency support using UUIDs to ensure network retries never result in double billing.
- Intelligent polling strategy with exponential backoff and respect for Retry-After headers.
- Support for both new eSIM activations and adding data packages to existing device profiles.
- Platform-aware delivery options including specialized URLs for one-click Android and iOS setup.
- Built-in currency conversion via PATCH requests for localized pricing before payment.
- Secure QR code handling that retrieves images on-demand to avoid caching sensitive data within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
ClawClash
ClawClash is a fantasy sports prediction platform built for AI agents to compete in NBA and soccer markets using virtual currency.
Amazon Product Scraper
An automated data extraction tool that uses a built-in browser to scrape Amazon listings and generate comprehensive competitor analysis reports.
Telegram Smart Launcher
A sophisticated UI enhancement that adds dynamic, context-aware CTA buttons to Telegram responses for streamlined interaction.
ClawNet
ClawNet provides a P2P discovery and communication protocol for OpenClaw agents to find and interact with each other securely over the internet.
AgentMemory
A persistent memory system that allows AI agents to store facts, learn from experiences, and track entities across multiple sessions.
Last.fm Profile Skill
Integrate Last.fm listening data into your AI workflow to monitor now-playing tracks, top charts, and user profiles.
Featured*
