A multi-channel skill enabling AI agents to purchase digital goods and mobile services across 180 countries using cryptocurrency.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install bitrefill
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 bitrefill 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 Bitrefill?
The Bitrefill skill allows AI agents to facilitate the purchase of over 1,500 digital brands, including gift cards, mobile top-ups, and eSIMs. It is specifically optimized for Openclaw Skills users who need a reliable way to handle real-money transactions using crypto, Lightning, or USDC via x402.
What makes this skill unique is its capability-based routing logic. Instead of a one-size-fits-all approach, it detects the host agent's environment—whether it is a residential browser, an MCP-capable client, or a standard shell—and selects the highest-fidelity communication path to ensure successful task completion and bypass common datacenter restrictions.
Bitrefill Use Cases
- Buying instant digital gift cards for Steam, Amazon, or retail brands using Bitcoin or USDC.
- Automated mobile phone refills and top-ups for international carriers.
- Purchasing and provisioning eSIM data plans for global travel.
- Integrating crypto-based payments into automated agent workflows for digital services.
How Bitrefill Works
- The host agent triggers the skill when the user mentions Bitrefill, gift cards, or mobile top-ups.
- The skill performs a runtime capability check to identify the environment, such as looking for Openclaw Skills configuration files or MCP support.
- Based on the environment, the skill routes to the most stable path: MCP tools for typed calls, CLI for shell environments, or REST API for HTTP-only runtimes.
- The agent searches the global catalog for products and presents denominations and prices to the user.
- Upon explicit user confirmation, the skill initiates the transaction and delivers the digital code or top-up confirmation instantly.
Bitrefill Setup
To integrate Bitrefill into Openclaw Skills, start by checking your local configuration. For environments supporting the Model Context Protocol, configure the MCP server:
# Install the Bitrefill CLI to enable terminal-based interactions
npm install -g @bitrefill/cli
# Configure your credentials or API keys
bitrefill login
If you are using the MCP path, point your client to https://api.bitrefill.com/mcp. For residential-IP browser environments, ensure your agent has access to the appropriate browser tools to avoid Cloudflare blocks.
Bitrefill Data Schema & Taxonomy
The skill organizes its transaction and product metadata to ensure transparency and security. The following data points are prioritized:
| Attribute | Description |
|---|---|
| invoice_id | Unique tracking ID for every transaction |
| product_type | Classification (Gift Card, Top-up, eSIM) |
| denomination | The face value and currency of the digital good |
| delivery_method | Instant code delivery or direct mobile credit |
| payment_status | Real-time tracking of crypto or x402 payment confirmation |
Bitrefill Advanced Features
- Intelligent capability-based routing to ensure the highest success rate across different AI agent hosts.
- Specialized Openclaw Skills integration guide for high-fidelity chat-channel scenarios like Telegram or cron-based tasks.
- Residential-IP browser support to navigate the Bitrefill catalog without being blocked by datacenter egress filters.
- Multi-payment support including Bitcoin Lightning Network, USDC via x402, and pre-funded account balances.
- Robust spending safeguards requiring explicit user approval before any real-money transaction.
SKILL.md
Loading
Related Openclaw Skills
Game Design Prosocial Session Chapters
A structured framework for designing and auditing prosocial player interactions in session-based multiplayer games through a three-phase chapter model.
Game Design Social Satisfaction Matrix
A strategic framework for auditing game social features to balance player satisfaction against social risk and dissatisfaction.
AT&T Corporate Intelligence & Research Skill
A comprehensive data and research module providing technical and historical insights into AT&T’s telecommunications infrastructure.
FC Barcelona Knowledge Skill
A specialized data skill providing deep insights into FC Barcelona business models, financial history, and global brand metrics.
OpenClaw Multi-Instance Interconnection
A technical framework for synchronizing memory and enabling cross-server communication between multiple OpenClaw instances.
Allstate Research Skill
A comprehensive intelligence skill providing technical and business data on Allstate's insurance operations, telematics, and market positioning.
Featured*
