OpenAirtime is an autonomous agent designed to distribute Nigerian airtime rewards to users on the Farcaster social network.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install open-airtime
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 open-airtime 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 OpenAirtime?
OpenAirtime is a highly specialized autonomous agent built to facilitate the distribution of Nigerian airtime rewards directly through the Farcaster protocol. By leveraging Openclaw Skills, this agent monitors mentions, interacts with users via automated replies, and processes reward claims based on unique codes generated on its companion website. It streamlines the promotional process by handling the technical complexities of social media interaction and airtime disbursement in a single, automated workflow.
This skill is particularly effective for community engagement and promotional campaigns targeting the Nigerian market. It ensures a seamless experience for users who can win rewards by spinning a wheel and simply replying to the bot with their claim details. With built-in duplicate reply prevention and status tracking, OpenAirtime maintains a professional and efficient presence on the Farcaster network while utilizing Openclaw Skills to drive growth.
OpenAirtime Use Cases
- Automating promotional airtime giveaways for Nigerian Farcaster communities.
- Rewarding active users through a gamified spin and win mechanic.
- Managing high volumes of social media mentions and reward claims without manual intervention.
- Verifying claim codes and processing mobile top-ups autonomously using Openclaw Skills.
How OpenAirtime Works
- The agent monitors Farcaster mentions and notifications to identify users requesting airtime rewards.
- It automatically replies with specific instructions, directing the user to the spin-the-wheel landing page.
- Once the user provides a valid claim code (formatted as AIR-XXX-XXX) and their Nigerian phone number, the agent captures the response.
- The agent executes the claim command to validate the request and trigger the airtime disbursement through the configured provider.
- Status checks are performed via Openclaw Skills to ensure rewards are processed and duplicate replies are strictly avoided.
OpenAirtime Setup
To initialize the OpenAirtime agent, ensure Node.js is installed on your system. Configuration for API credentials should be handled within the environment settings. Use the following commands to interact with the Farcaster and Airtime modules using Openclaw Skills:
# Check for new mentions and notifications
node scripts/farcaster.js mentions
# Claim airtime for a specific user
node scripts/airtime.js claim_airtime <FID> <CLAIM_CODE> <PHONE_NUMBER>
# Post a new cast to the network
node scripts/farcaster.js post "Your message here"
OpenAirtime Data Schema & Taxonomy
OpenAirtime manages interaction data and reward statuses through its integrated scripts and Openclaw Skills. The data organization is structured as follows:
| Component | Description |
|---|---|
| FID | The unique Farcaster ID of the user interacting with the agent. |
| Claim Code | A specific identifier (AIR-XXX-XXX) generated from the spin-the-wheel site. |
| Phone Number | The Nigerian mobile number designated for the airtime receipt. |
| Cast Hash | Unique identifier for Farcaster posts used to prevent duplicate replies. |
| Reply Status | Metadata tracking whether a mention has been addressed (REPLIED or NEW). |
OpenAirtime Advanced Features
- Intelligent duplicate reply prevention that automatically skips already processed casts.
- Automated status tracking for every mention and notification to maintain an organized workflow.
- Granular user information retrieval using Farcaster IDs (FID) for better targeting.
- Customizable greeting logic to ensure social posts remain varied and natural.
- Force-reply capabilities for manual overrides when necessary, powered by Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Roborock Vacuum Control
A comprehensive AI agent skill for controlling Roborock vacuums, managing room-specific cleaning, and tracking maintenance.
Phone Calls
An AI-powered calling assistant that uses Bland AI to handle restaurant bookings, appointment scheduling, and service inquiries on your behalf.
Google Workspace
A zero-configuration MCP skill that grants AI agents full access to Google Workspace without requiring Google Cloud Console projects.
ABM Outbound
A multi-channel ABM automation pipeline that transforms LinkedIn URLs into coordinated email, social, and physical handwritten letter campaigns.
Naver Shopping Search
An automated search tool for fetching real-time product data, pricing, and links from the Naver Shopping marketplace.
Presale One-Pass Orchestrator
A high-reliability orchestration skill for executing approved Codex implementation plans with automated preflight gates and mandatory QA loops.
Featured*
