ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

agent-email

Send and receive email as your AI agent. Use when the user wants to check inbox, send email, reply to messages, set up an email alias, or manage agent email. Covers "check my email", "send an email", "what's my agent email", "set up email", "inbox".

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/agnicpay-prog/agnic-agent-email
Or

Agent Email

Each agent gets a unique email address in the format agent-<id>@agnic.ai. Use npx agnic@latest email commands to manage it.

Authentication

Run npx agnic@latest status --json to verify. If not authenticated:

  • Headless (CI/server/agent): Set AGNIC_TOKEN env var or pass --token <token>
  • Interactive (has browser): Run npx agnic@latest auth login

See the authenticate-wallet skill for details.

Commands

Set up email alias

npx agnic@latest email setup --display-name "My Agent" --json

Check email address

npx agnic@latest email address --json

Check inbox

npx agnic@latest email inbox --limit 10 --json

Send email

npx agnic@latest email send --to <address> --subject "<subject>" --body "<body>"

Reply to a message

npx agnic@latest email reply --message-id <id> --body "<reply text>"

Input Validation

Before constructing commands, validate user-provided values:

  • --to: Must be a valid email address. Reject if it contains spaces, semicolons, pipes, or backticks.
  • --subject: Single-quote the value. Escape internal single quotes.
  • --body: Single-quote the value. Escape internal single quotes.
  • --message-id: Must be alphanumeric or UUID format.

Do not pass unvalidated user input into the command.

Important Notes

  • Emails are stored with 30-day retention
  • Display name can be set once during setup
  • Inbox returns most recent messages first

Prerequisites

  • Must be authenticated (npx agnic@latest status to check)
  • Agent identity must exist (created automatically during sign-up)

Error Handling

Common errors:

  • "Not authenticated" -- Run npx agnic@latest auth login or set AGNIC_TOKEN
  • "No email alias found" -- Run npx agnic@latest email setup first
  • "Agent not found" -- The user may not have an agent registered; sign up at app.agnic.ai
  • "Message not found" -- Check the message ID with email inbox first
Read Full Documentation on GitHub

Metadata

Author@agnicpay-prog
Stars4473
Views0
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-agnicpay-prog-agnic-agent-email": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

trade-tokens

Swap or trade tokens on Base network. Use when you or the user want to trade, swap, exchange, buy, sell, or convert between tokens like USDC, ETH, and WETH. Covers phrases like "buy ETH", "sell ETH for USDC", "convert USDC to ETH", "get some ETH", "swap tokens", "trade USDC for WETH".

agnicpay-prog 4473

check-balance

Check USDC balance across networks (Base, Solana). Use when the user wants to check balance, see how much USDC is available, view funds, or verify wallet balance. Covers "check my balance", "how much do I have", "show funds", "wallet balance".

agnicpay-prog 4473

ai-gateway

Access 340+ AI models via the Agnic AI Gateway -- chat, image generation, model listing. Use when the user wants to chat with AI, generate images, ask GPT, use Claude, list models, delegate to another LLM, or get a second opinion. Covers "ask GPT", "use Claude", "generate an image", "list AI models", "call a model".

agnicpay-prog 4473

authenticate-wallet

Authenticate Agnic wallet via browser OAuth or headless API token. Use when the user wants to sign in, log in, authenticate, connect wallet, set up CLI, or resolve "Not authenticated" errors. Supports AGNIC_TOKEN env var for CI/server/agent environments.

agnicpay-prog 4473

agnic

Complete AI agent wallet with payments, trading, email, and on-chain identity. Use when the user wants to manage their agent's wallet, make payments, trade tokens, send/receive email, or check their agent identity.

agnicpay-prog 4473