shitty-email

What This Skill Does

The Shitty Email skill provides a robust interface for OpenClaw agents to generate, manage, and monitor disposable email addresses directly via the Shitty Email API. It allows agents to handle temporary communication needs programmatically without polluting the user's primary inbox. The skill is designed to handle the full lifecycle of an email session: creation, monitoring, content retrieval, lifetime extension, and secure deletion. By managing session tokens internally, the agent ensures that all interactions with a specific inbox remain authenticated and coherent throughout the duration of a task.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/johanski/shitty-email Ensure that your agent has the necessary permissions to perform network requests to https://shitty.email before attempting to initiate an inbox session.

Use Cases

• Service Signups: Automatically register for websites that require email verification while maintaining total privacy and avoiding spam.
• QA Testing: Validate automated email notification triggers in development environments without relying on personal accounts.
• Information Retrieval: Extract sensitive or one-time use verification codes from confirmation emails sent by third-party platforms.
• Privacy Guarding: Use temporary addresses for newsletters or trials to prevent tracking and unwanted marketing emails from reaching your primary inbox.

Example Prompts

1. "Create a temporary email address and sign up for the newsletter at the website I'm currently viewing, then wait for the confirmation link."
2. "Check my current temporary inbox for a verification code and tell me what the code is so I can finish setting up my account."
3. "The account verification is taking longer than expected; please extend the lifetime of my current disposable email session by an hour."

Tips & Limitations

• Token Management: The session token is the key to your inbox. If the agent loses the token, the inbox becomes inaccessible. Always ensure the token is stored in the agent's short-term memory during a session.
• Expiration: By default, inboxes expire after 60 minutes. If your task involves a long wait period, remember to request a lifetime extension.
• Cleanup: Always trigger the delete command once your task is complete to ensure you are practicing good digital hygiene and respecting API resource limits.
• Content Parsing: For complex emails, the skill returns both raw text and HTML. When looking for links or codes, prefer parsing the text field using regex patterns for better accuracy.