A temporary email management utility for automating signup flows and message polling through the Vortex API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install temp-mail
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 temp-mail 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 temp-mail?
The temp-mail skill is a specialized tool designed for developers and AI agents requiring disposable email functionality. By leveraging the Vortex API backend, this Openclaw Skills integration allows for the seamless creation of random localpart addresses, real-time message polling, and automated mailbox clearing. It is particularly valuable for developers who need to bypass personal email requirements during automated testing or research tasks.
This skill provides a Python-based interface to interact with hosted Vortex instances, ensuring that users can handle verification codes and magic links without manual intervention. As part of the wider ecosystem of Openclaw Skills, it provides a programmatic way to manage the lifecycle of a temporary inbox from creation to deletion.
temp-mail Use Cases
- Automating user registration and signup flows in end-to-end testing environments.
- Receiving and extracting verification codes or authentication links for browser automation.
- Testing email delivery and content formatting without cluttering production inboxes.
- Enhancing privacy by using unique disposable addresses for one-off service interactions within Openclaw Skills workflows.
How temp-mail Works
- The user or agent generates a new mailbox using the create command, which produces a random localpart at a specified domain.
- The generated address is provided to external services requiring an email input.
- The skill uses the fetch or poll commands to query the Vortex HTTP API for incoming messages.
- If polling is used, the script waits until a message arrives or a predefined timeout is reached.
- Once the necessary data is retrieved, the clear command is used to purge all messages from the temporary address.
temp-mail Setup
To integrate this skill into your Openclaw Skills environment, ensure you have the necessary dependencies installed using Python or the uv package manager.
# Install dependencies via pip
python -m pip install -r scripts/requirements.txt
# Or run directly using uv for an ephemeral environment
uv run scripts/temp_mail.py create
You can override the default domain or API endpoint by setting the VORTEX_DOMAIN and VORTEX_URL environment variables respectively.
temp-mail Data Schema & Taxonomy
The temp-mail skill manages data through the Vortex API, focusing on mailbox metadata and message content. The following table describes the primary data elements:
| Attribute | Description |
|---|---|
| Email Address | The full address consisting of a random localpart and chosen domain. |
| Message List | An array of incoming emails associated with the specific address. |
| API Endpoint | The Vortex instance URL used for GET and DELETE requests. |
| Timeout | The duration in seconds the script will wait during a poll operation. |
temp-mail Advanced Features
- Support for multiple domains including dash.dino.icu and skyfall.dev via environment configuration.
- Smart polling logic that allows AI agents within Openclaw Skills to wait for asynchronous email delivery.
- CLI-first design compatible with uv, enabling zero-install execution for CI/CD pipelines.
- Automated mailbox clearing to maintain data hygiene and privacy after verification tasks are complete.
SKILL.md
Loading
Related Openclaw Skills
Clawbox Media Server
A lightweight, bidirectional LAN file sharing solution that allows AI agents and users to exchange files over a local network without internet access.
Rate Limit Validator
A diagnostic tool for testing if HTTP endpoints correctly enforce rate limiting and provide standard throttling headers.
Credential Hygiene Validator
A security auditing tool designed to detect exposed credentials, improper file permissions, and git contamination within AI agent environments.
badass-revival
Register sovereign domains like .badass and .forever as ERC-721 NFTs on Ethereum mainnet using Impervious Domains contracts.
Privy Agentic Wallets
Enable AI agents to autonomously manage crypto wallets and execute onchain transactions with robust policy-based guardrails.
Clawmegle Staking
A specialized tool for AI agents to stake $CLAWMEGLE tokens and earn dual rewards in ETH and $CLAWMEGLE from Clanker LP fees.
Featured*
