A specialized email interface for OpenClaw instances to handle mailbox registration, message retrieval, and outbound email via the Crustacean Email Gateway.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install create-email-address
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 create-email-address 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 Crustacean Email Gateway?
The Crustacean Email Gateway is a robust skill designed to bridge the gap between AI agents and traditional email communication. By leveraging Openclaw Skills, developers can equip their agents with a secure, identity-backed mailbox that supports registration via cryptographic challenges and Proof of Work. This integration allows agents to manage inboxes, track outbox statuses, and send both plain text and HTML emails while adhering to strict security and rate-limiting protocols.
This system ensures that every interaction is authenticated through an instance identity, providing a layer of trust and accountability. By utilizing Openclaw Skills in this manner, developers can build agents that not only process data but also communicate effectively with human users and other automated systems across the global email network.
Crustacean Email Gateway Use Cases
- Registering a unique email identity for an OpenClaw instance to establish a formal communication channel.
- Recovering lost bearer tokens for existing agent accounts using cryptographic signatures.
- Automating inbox monitoring and processing to trigger agent workflows based on incoming mail.
- Sending outbound notifications, reports, or HTML-formatted updates to external stakeholders.
- Configuring email forwarding to bridge agent communications with human-readable mailboxes for oversight.
How Crustacean Email Gateway Works
- The agent identifies the local OpenClaw identity and requests a cryptographic challenge from the Crustacean API base.
- It solves a Proof of Work challenge and signs a unique nonce using its private key to verify the instance identity.
- Upon successful registration or recovery, a bearer token is issued and saved locally to facilitate authenticated requests.
- The agent utilizes specialized Python scripts to fetch inbox contents, retrieve message details, or send outbound messages.
- Status updates like marking messages as read or archiving them are performed via the API to maintain mailbox organization.
- For outbound messages, the system handles queuing and rate-limiting to ensure reliable delivery within service constraints.
Crustacean Email Gateway Setup
To initialize these Openclaw Skills, ensure your environment is configured with your identity file at /root/.openclaw/identity/device.json. You can then run the registration or recovery scripts to obtain your bearer token:
# Register a new mailbox identity
python3 scripts/register_mailbox.py
# Recover a token for an existing registered instance
python3 scripts/recover_token.py
# Check the current mailbox status
python3 scripts/get_mailbox.py
You can override default paths and API endpoints using environment variables such as CRUSTACEAN_API_BASE and OPENCLAW_IDENTITY_PATH.
Crustacean Email Gateway Data Schema & Taxonomy
The skill manages data through local configuration files and specific API payload structures to maintain state and identity. These Openclaw Skills utilize the following data schema:
| Data Component | Format | Description |
|---|---|---|
| Identity File | JSON | Contains the OpenClaw public/private key pair and instance ID. |
| Token File | JSON | Stores the bearer token and associated metadata for session authentication. |
| Message Payload | JSON | Includes fields for sender, recipients (to/cc/bcc), subject, and body (text/HTML). |
| Mailbox Metadata | JSON | Tracks mailbox age, message counts, and current rate limits. |
| Forwarding Config | JSON | Stores the destination email address and active status for mail redirection. |
Crustacean Email Gateway Advanced Features
- Cryptographic identity verification utilizing OpenClaw device signatures for high-security environments.
- Automated Proof of Work (PoW) solvers to satisfy server-side anti-spam requirements during registration.
- Full support for HTML body content, allowing agents to send rich, formatted communications.
- Intelligent rate-limiting logic that parses retry_after_seconds to optimize request scheduling.
- Flexible forwarding management that allows agents to redirect incoming traffic without complex verification flows.
- Comprehensive outbox tracking to monitor the delivery status of queued outbound messages.
SKILL.md
Loading
Related Openclaw Skills
Video Script Generator
An automated scriptwriter that transforms trending news into high-engagement, spoken-word scripts for platforms like Douyin.
Tianpuyue AI Music Generation
An advanced AI-powered music and lyrics generation skill that creates professional-grade audio and compositions via the Tianpuyue API.
zh-novel-writer
A specialized automation tool for batch-generating Chinese web novel chapters using external LLM APIs and structured outlines.
Qiniu Object Storage
A dedicated skill for AI agents to upload local files to Qiniu Object Storage and retrieve secure, shareable delivery links.
Oracle Closing Report Skill
A sophisticated financial reporting tool that generates comprehensive A-share market daily summaries including index data, sentiment analysis, and global indicators.
Contractor Marketing
A comprehensive AI-driven marketing department designed specifically to scale local contracting and home service businesses.
Context Budget Auditor
A diagnostic tool to audit and optimize token consumption across agents, skills, MCP servers, and rule files.
Featured*
