Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Provision a dedicated inbox for your AI agent and manage email safely via thrd.email. Includes instant onboarding, inbound polling, reply/send (idempotent +...
Provision a dedicated inbox for your AI agent and manage email safely via thrd.email. Includes instant onboarding, inbound polling, reply/send (idempotent +...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
This skill helps you create and operate an isolated inbox for an AI agent using thrd.email, without connecting your personal inbox. Safety by default: don't connect your primary inbox to an agent; use a dedicated agent inbox.
To avoid stale assumptions, refresh the OpenAPI contract and read info.version: python3 scripts/openapi_sync.py python3 scripts/openapi_sync.py --print-version This uses HTTP cache validators (ETag/Last-Modified) and only re-downloads when changed.
To create a new email account, run the onboarding script: python3 scripts/onboard.py --agent-name "My Agent" [--tenant-name "My Company"] This prints a JSON payload to stdout with the new inbox data and a redacted API key by default. If you explicitly need the one-time raw key in a trusted terminal: python3 scripts/onboard.py --agent-name "My Agent" --reveal-api-key Security note: Do not write your API key to disk. Store it in your runtime's secret manager and set THRD_API_KEY as an environment variable. (The rest of the tools require THRD_API_KEY; onboarding does not.)
To start paid billing for your current tenant, use the checkout script: python3 scripts/checkout.py <plan_name> Plans: sandbox -> Sandbox Starter (9 EUR/month, raises Tier 1 monthly limit from 100 to 2,000 emails) limited -> Tier 2 verified -> Tier 3 Forward the resulting Stripe URL to your human owner for payment.
Tier 3 (Verified Outbound) requires a responsible human linked via X. Start the flow: POST /v1/claim/x/start Forward the claim_url to your human owner. Check status: GET /v1/claim/x/status
Cold outbound (Tier 3) may require a reasoning challenge to prevent spam. If you receive a 428 por_required error, solve the logical challenge provided in the response. Re-send the request with por_token and por_answer.
For detailed API usage (polling, sending, replying, trust scores, and checking delivery status), see references/api.md. Note: replies use reply-all behavior by default: they preserve historical CC and keep recipients from the latest inbound To line so participants are not dropped. Tier2+ may add CC via cc[]. In Tier1, cc[] may only contain addresses already present in that thread's CC history. Security note: when Prompt Shield marks an inbound email as high-risk, Tier2/3 flows may require creating a short-lived security_ack_token (POST /v1/security/ack) before reply/send. Quota note: use GET /v1/usage to monitor monthly usage (used, remaining, state, reset_at) and avoid hitting hard limits mid-run.
Many LLM runtimes do not reliably maintain background polling. Use wake webhooks when possible: Configure webhook: PUT /v1/wake/webhook Read status: GET /v1/wake/webhook Disable webhook: DELETE /v1/wake/webhook THRD sends signed inbox.pending pings, then your runtime should immediately pull with GET /v1/events and ACK. Fallback when webhooks are not available: python3 scripts/poll_daemon.py --cursor-file .thrd_cursor This keeps pull-based delivery alive without requiring a public webhook endpoint.
scripts/onboard.py: Instant provisioning of a new email inbox. scripts/checkout.py: Generate a Stripe Checkout URL for upgrades. scripts/openapi_sync.py: Refresh/cache latest OpenAPI and read current info.version. scripts/poll_daemon.py: Fallback long-poll daemon for runtimes without wake webhook support.
Messaging, meetings, inboxes, CRM, and teammate communication surfaces.
Largest current source with strong distribution and engagement signals.