A read-only integration to track PopUp referral links, vendor signups, and total earned commissions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install popup-referrals
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 popup-referrals 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 PopUp Referrals?
PopUp Referrals is a specialized technical integration designed for the Openclaw Skills ecosystem that allows organizers to monitor their referral program performance seamlessly. It provides a secure, read-only interface to the PopUp API, enabling users to retrieve their unique shareable URLs and detailed financial statistics without manual dashboard logins. This skill focuses on transparency and data retrieval, ensuring organizers can stay updated on their $100 rewards per successful vendor subscription while maintaining a clear view of their account balance.
PopUp Referrals Use Cases
- Monitoring the status of referred vendors to see who has converted to annual plans.
- Retrieving your unique shareable URL quickly to provide to potential partners.
- Checking total cash and credit balances earned through the Openclaw Skills framework.
- Auditing recent signups to track the effectiveness of marketing campaigns.
How PopUp Referrals Works
- The user provides the POPUP_API_KEY environment variable to authenticate the AI agent.
- The skill sends a GET request to the /referrals endpoint of the PopUp Organizer API.
- The API returns a JSON response containing reward structures, stats, and a list of referred vendors.
- The skill parses this data to present a clean summary of signups, earnings, and current account balances to the user.
PopUp Referrals Setup
To enable this functionality within Openclaw Skills, you must provide your PopUp API key as an environment variable.
- Obtain your API key from your PopUp organizer dashboard.
- Configure your environment:
export POPUP_API_KEY="pk_live_your_key_here"
- Ensure your agent environment has network access to usepopup.com.
PopUp Referrals Data Schema & Taxonomy
The skill interacts with a structured JSON response wrapped in a data object. Key metrics include:
| Attribute | Description |
|---|---|
| referralCode | Unique identifier for the organizer. |
| shareUrl | The public link for referring new vendors. |
| stats | Nested object containing totalSignups, totalCashEarned, and totalCreditsEarned. |
| accountBalance | Current withdrawable balance in cents. |
| referrals | Array of objects including vendor name, signup date, and subscription status. |
PopUp Referrals Advanced Features
- Automated tracking of the 31-day maturation period for annual subscription rewards.
- Detailed breakdown of $100 cash rewards versus account credits based on account type.
- Read-only safety profile ensuring the skill never contacts vendors or posts on social media autonomously.
- Built-in handling for rate limiting (60 requests per minute) to ensure stable Openclaw Skills operations.
SKILL.md
Loading
Related Openclaw Skills
Buildertrend Automation Skill
A comprehensive automation suite for Buildertrend that uses browser relay to handle 43 construction workflows including financials, scheduling, and project management.
ClawHub Intro Skill
A foundational demonstration skill designed to showcase the standardized structure and publication workflow for the Openclaw registry.
Payroll Oracle
A decentralized HR and payroll infrastructure that audits GitHub or Linear work to trigger automated USDC payments via the x402 protocol.
Superpowers: Structured Multi-Agent Development
A disciplined engineering framework for Openclaw Skills that utilizes sub-agents and a rigorous 5-step lifecycle to deliver high-quality code.
Excalidraw Diagram Generator
A specialized skill for converting natural language descriptions into fully editable Excalidraw JSON diagram files.
Fortune Oracle
A local, privacy-first AI agent skill that provides personalized daily horoscopes, lucky elements, and behavioral suggestions based on astrological charts and birthdays.
Featured*
