agentmail-cli

Name: agentmail-cli
Author: stepandel

功能描述

Manage email inboxes and messages via AgentMail API. Create disposable inboxes, send/receive emails, and list messages. Use when the agent needs to send or receive email, create temporary inboxes, or check for incoming messages.

使用说明 (SKILL.md)

CLI for AgentMail — create inboxes, send messages, and read email.

API Key Setup

The API key MUST be configured before any command will work. Two methods:

Config file (preferred for persistent agents):

agentmail config set-key YOUR_API_KEY

This stores the key at ~/.agentmail/config.json and persists across sessions.

Environment variable:

export AGENTMAIL_API_KEY=YOUR_API_KEY

Verify configuration:

agentmail config show

If commands fail with auth errors, re-run agentmail config set-key — the env var alone may not persist between shell sessions.

Always Use --json

Always pass --json to every command for machine-readable output. Parse with jq when needed.

Inbox Commands

Create an inbox:

agentmail inbox create --json
agentmail inbox create --domain example.com --json
agentmail inbox create --username support --domain example.com --display-name "Support Team" --json

List inboxes:

agentmail inbox list --json
agentmail inbox list --limit 10 --json

Get inbox details:

agentmail inbox get \x3Cinbox-id> --json

Delete an inbox:

agentmail inbox delete \x3Cinbox-id>

Message Commands

Send a message:

agentmail message send --from \x3Cinbox-id> --to [email protected] --subject "Subject" --text "Body text" --json

Send with HTML:

agentmail message send --from \x3Cinbox-id> --to [email protected] --subject "Subject" --html "\x3Ch1>Hello\x3C/h1>" --json

Multiple recipients, CC, BCC:

agentmail message send --from \x3Cinbox-id> --to "[email protected],[email protected]" --cc "[email protected]" --bcc "[email protected]" --subject "Subject" --text "Body" --json

List messages in an inbox:

agentmail message list \x3Cinbox-id> --json
agentmail message list \x3Cinbox-id> --limit 20 --json

Get a specific message:

agentmail message get \x3Cinbox-id> \x3Cmessage-id> --json

Delete a message (deletes entire thread):

agentmail message delete \x3Cinbox-id> \x3Cmessage-id>

Common Workflow

# 1. Create inbox, capture ID
INBOX_ID=$(agentmail inbox create --json | jq -r '.inboxId')

# 2. Send email
agentmail message send --from "$INBOX_ID" --to [email protected] --subject "Hello" --text "Message body" --json

# 3. Check for replies
agentmail message list "$INBOX_ID" --json

Notes

Get an API key at https://agentmail.to
Config file location: ~/.agentmail/config.json
Env var AGENTMAIL_API_KEY takes precedence over config file
Deleting a message deletes the entire thread containing it

安全使用建议

This skill appears to be what it says: a CLI wrapper for AgentMail that needs an API key. Before installing, verify the npm package and GitHub repo (author, recent commits, downloads) and inspect the package contents if you can. Be aware that the CLI can persist your AGENTMAIL_API_KEY to ~/.agentmail/config.json in plaintext if you use 'agentmail config set-key' — if you prefer not to leave credentials on disk, use an environment variable for ephemeral sessions and revoke the key afterward. Limit the API key's permissions (if the service supports it), and avoid installing the package on high-value hosts until you inspect the code or run it in a sandbox.

功能分析

Type: OpenClaw Skill Name: agentmail-cli Version: 1.0.0 The skill bundle is benign. It provides instructions for installing and using the `agentmail-cli` tool to manage email, which aligns with its stated purpose. The `SKILL.md` clearly outlines API key setup, command usage, and installation via npm. There is no evidence of prompt injection, data exfiltration beyond the necessary API key for the service, malicious execution, persistence mechanisms, or obfuscation within the provided files. The use of `jq` for JSON parsing is standard and not indicative of malicious intent.

能力评估

✓ Purpose & Capability

Name/description, required binary (agentmail), primary env var (AGENTMAIL_API_KEY), and the declared npm install (@stepandel/agentmail-cli) are all consistent: the skill is a CLI client for AgentMail and requests exactly the API key and binary needed to operate.

✓ Instruction Scope

SKILL.md only instructs use of the agentmail CLI (create/list/delete inboxes, send/list/get/delete messages) and how to configure the API key via env var or ~/.agentmail/config.json. It does not ask the agent to read unrelated files, query other credentials, or post data to unexpected endpoints.

ℹ Install Mechanism

Install is via an npm package (@stepandel/agentmail-cli) which will place an 'agentmail' binary on PATH. This is a standard approach but carries the usual npm-origin risks (supply-chain/malicious package); verify the package/author and review code before installing in sensitive environments.

✓ Credentials

Only AGENTMAIL_API_KEY is required and it is the natural credential for an email-sending/receiving service. The SKILL.md documents config file location (~/.agentmail/config.json) and that the env var takes precedence — storing the key unencrypted on disk is expected behavior but worth noting.

ℹ Persistence & Privilege

always:false (no forced persistence). The skill instructs the CLI to persist the API key to ~/.agentmail/config.json if the user runs 'agentmail config set-key' — this is appropriate for a CLI but means persistent plaintext storage of credentials unless the user avoids that step.

版本历史

v1.0.0

Initial release

元数据

Slug agentmail-cli

版本 1.0.0

许可证 —

累计安装 7

当前安装数 6

历史版本数 1

常见问题

agentmail-cli 是什么？

Manage email inboxes and messages via AgentMail API. Create disposable inboxes, send/receive emails, and list messages. Use when the agent needs to send or receive email, create temporary inboxes, or check for incoming messages. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1973 次。

如何安装 agentmail-cli？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install agentmail-cli」即可一键安装，无需额外配置。

agentmail-cli 是免费的吗？

是的，agentmail-cli 完全免费（开源免费），可自由下载、安装和使用。

agentmail-cli 支持哪些平台？

agentmail-cli 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 agentmail-cli？

由 Stepan Arsentjev（@stepandel）开发并维护，当前版本 v1.0.0。