← Back to Skills Marketplace
76
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install agnic-agent-email
Description
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....
README (SKILL.md)
Agent Email
Each agent gets a unique email address in the format agent-\x3Cid>@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_TOKENenv var or pass--token \x3Ctoken> - 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 \x3Caddress> --subject "\x3Csubject>" --body "\x3Cbody>"
Reply to a message
npx agnic@latest email reply --message-id \x3Cid> --body "\x3Creply 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 statusto check) - Agent identity must exist (created automatically during sign-up)
Error Handling
Common errors:
- "Not authenticated" -- Run
npx agnic@latest auth loginor setAGNIC_TOKEN - "No email alias found" -- Run
npx agnic@latest email setupfirst - "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 inboxfirst
Usage Guidance
This skill appears to be a thin wrapper around the agnic CLI. Before installing: 1) Confirm you trust the 'agnic' npm package and consider pinning a specific version rather than using @latest; npx will download and run remote code. 2) Expect to provide a sensitive AGNIC_TOKEN for headless use—verify where that token is sent, what scopes it has, and whether you can rotate/revoke it. 3) Note emails are retained 30 days—ensure this retention and privacy model fit your needs. 4) If you need stronger assurances, ask the skill author to declare AGNIC_TOKEN in requires.env, document the npm package provenance, and prefer a fixed release (not @latest).
Capability Analysis
Type: OpenClaw Skill
Name: agnic-agent-email
Version: 2.0.2
The skill provides a legitimate interface for an AI agent to manage emails via the 'agnic' CLI tool. It includes explicit security instructions in SKILL.md for the agent to validate and escape user input (e.g., --to, --subject, --body) to prevent shell injection, demonstrating a security-conscious design aligned with its stated purpose.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description align with the runtime instructions: all commands use the agnic CLI (npx agnic@latest email ...). The requested capabilities (check inbox, send/reply, set alias) are consistent with calling that CLI.
Instruction Scope
SKILL.md restricts actions to calling the agnic CLI and includes reasonable input validation guidance. It does not instruct reading unrelated files or system state. However, it explicitly references an authentication token (AGNIC_TOKEN) and interactive login flows that are not declared in the skill's required env list, an inconsistency worth flagging.
Install Mechanism
The skill is instruction-only but relies on 'npx agnic@latest' at runtime. npx/@latest will fetch and execute code from the npm registry on-demand; that behavior can change over time and execute arbitrary remote code. For lower risk, commands should prefer pinned versions or document the package source and trust model.
Credentials
The SKILL.md documents use of a sensitive environment variable (AGNIC_TOKEN) for headless auth, but the skill metadata lists no required env vars or primary credential. This mismatch hides that a secret token may be needed and transmitted to the agnic service; the token scope and storage/rotation expectations are not declared.
Persistence & Privilege
The skill does not request always:true, has no install spec that writes files, and does not request system-level config paths. It does not ask to persist or modify other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agnic-agent-email - After installation, invoke the skill by name or use
/agnic-agent-email - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.2
v2.0.2 — Initial publication from upstream agnic-wallet-skills:
- Full production-quality skill with proper frontmatter and input validation
- Send and receive email as your AI agent (agent-<id>@agnic.ai alias)
- Supports inbox, send, reply, setup, address commands
- Headless auth via AGNIC_TOKEN supported
Metadata
Frequently Asked Questions
What is Agnic 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.... It is an AI Agent Skill for Claude Code / OpenClaw, with 76 downloads so far.
How do I install Agnic Agent Email?
Run "/install agnic-agent-email" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Agnic Agent Email free?
Yes, Agnic Agent Email is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Agnic Agent Email support?
Agnic Agent Email is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Agnic Agent Email?
It is built and maintained by Agnic.AI (@agnicpay-prog); the current version is v2.0.2.
More Skills