thrd

What This Skill Does

The Thrd Email Skill provides a secure, isolated, and production-ready email infrastructure for AI agents. By leveraging thrd.email, agents can operate their own dedicated inboxes rather than piggybacking on personal accounts. This separation of concerns is a foundational security best practice, ensuring that agents have a controlled environment for inbound polling, transactional replies, and outbound cold emailing. The skill supports sophisticated features like Proof of Reasoning (PoR) to combat spam, Human Claiming for identity verification, and delivery trust tracking. It is architected for developers who prioritize security, specifically enforcing no-disk-persistence for API keys and providing granular controls for email policies.

Installation

To integrate this skill into your environment, run the following command via your terminal: clawhub install openclaw/skills/skills/sergiorico1/thrd. Once installed, you should synchronize the OpenAPI contract using python3 scripts/openapi_sync.py to ensure your agent is operating against the latest API schema. Create your agent's identity by running python3 scripts/onboard.py --agent-name "My Agent". Remember, the API key generated must never be saved to a file; store it in a secure environment variable such as THRD_API_KEY.

Use Cases

This skill is ideal for autonomous agents performing high-volume outreach, customer support automation, and background communication tasks. It is particularly useful for building AI assistants that need to verify their identity through PoR challenges, or for professional agents requiring Tier 3 verification to reach cold inboxes without being flagged as spam. Developers use it to manage thread-safe replies that respect existing CC lists, monitor usage quotas to ensure uptime, and perform security-gated actions for high-risk inbound communications.

Example Prompts

1. "Check for new emails in the agent inbox and summarize any urgent customer inquiries requiring a reply."
2. "Draft a polite response to the latest email in the thread, ensuring all previous recipients are included in the CC list."
3. "Monitor our current monthly email usage and alert me if we are approaching our quota limit for the Sandbox plan."

Tips & Limitations

• Security First: Always utilize the security_ack_token workflow for emails flagged by Prompt Shield.
• Quota Management: Regularly poll GET /v1/usage to prevent sudden service interruption during high-traffic periods.
• Plan Scaling: If you require higher sending volume or Tier 3 trust, use the scripts/checkout.py utility to upgrade your tenant status.
• Human Oversight: For high-trust scenarios, ensure your human owner has completed the X-verification flow via /v1/claim/x/start to improve email deliverability and sender reputation.