← 返回 Skills 市场
124
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install email-usage
功能描述
使用本地邮件服务器收发我们自己域名的邮件。固定脚本位于 scripts/ 目录，直接执行即可。发送失败或密码遗忘时联系 小爪子。
使用说明 (SKILL.md)
Email 使用
SMTP 发送（需要认证）
python3 skills/email-usage/scripts/send_email.py \x3C收件人> \x3C主题> \x3C正文> \x3C发件邮箱> \x3C密码>
参数：收件人、主题、正文、发件邮箱、密码（向 小爪子 查询）
示例：
python3 skills/email-usage/scripts/send_email.py \
'[email protected]' '邮件标题' '邮件正文' \
'[email protected]' 'test1234'
IMAP 读取
python3 skills/email-usage/scripts/read_email.py \x3C用户名> \x3C密码> [最新N封，默认5]
示例：
python3 skills/email-usage/scripts/read_email.py '[email protected]' 'test1234' 3
新增邮箱账号
python3 skills/email-usage/scripts/create_email.py \x3C邮箱> \x3C密码>
示例：
python3 skills/email-usage/scripts/create_email.py [email protected] securepass
账号创建后，发件和收件使用同一套密码。
规则
- 不要配置 SMTP/Postfix/amavis
- 不要操作邮件队列（postqueue/postsuper）
- 不要修改容器内配置
- 连接超时或发送失败 → 联系 小爪子
- 密码遗忘 → 联系 小爪子
安全使用建议
This skill appears to do what it says (create accounts in a local mailserver container, read via IMAP, send via SMTP). Before using it: 1) Verify you trust the skill source (no homepage and unknown owner). 2) Confirm your environment matches the scripts' assumptions (container named 'mailserver', IMAP on 1143, SMTP on 587). 3) Avoid passing passwords on the command line (use an interactive prompt or protected environment variable) because CLI args appear in process lists and shell history. 4) Be aware create_email.py calls 'docker exec' — the account running the script must have Docker access; that implies significant local privileges and potential for executing arbitrary commands in the container. 5) If you plan to let an agent call these scripts autonomously, restrict which agent actions are allowed and audit logs; do not grant broad host-level Docker access to untrusted agents. If any of these assumptions or requirements are unacceptable, do not install the skill or review/modify the scripts to fit your security policies.
功能分析
Type: OpenClaw Skill
Name: email-usage
Version: 1.0.2
The skill bundle provides standard utilities for interacting with a local Docker-based mail server (likely docker-mailserver). It includes scripts for sending emails via SMTP (send_email.py), reading them via IMAP (read_email.py), and managing accounts via Docker commands (create_email.py). The code uses safe subprocess execution (list-based arguments) and standard libraries without evidence of data exfiltration, obfuscation, or malicious intent.
能力评估
Purpose & Capability
The scripts implement sending, reading, and creating local mail accounts and the SKILL.md documents how to run them. Requiring docker (to run 'docker exec mailserver ...' in create_email.py) is consistent with the create-account action. Minor inconsistency: _meta.json lists no required binaries while SKILL.md and the script clearly expect docker.
Instruction Scope
Instructions stay within the stated purpose and only tell you to run the provided scripts. However the instructions direct you to pass plaintext passwords on the command line (exposed in process lists and shell history) and assume a specific local setup (container named 'mailserver', IMAP on localhost:1143, SMTP on localhost:587). The send script will attempt authentication and then fallback to unauthenticated send on auth failure — this is functional but can be abused if run on an open SMTP listener.
Install Mechanism
No install spec — instruction-only with bundled scripts. Nothing is downloaded or written by an installer, which is the lowest-risk install pattern.
Credentials
No environment variables or external credentials are requested by the skill manifest. However create_email.py invokes the local Docker CLI and therefore requires access to the Docker socket/daemon. That gives whoever runs these scripts (or an agent that can invoke them) the ability to execute commands inside the 'mailserver' container and, depending on host configuration, broad local privileges. Also, passing passwords on the CLI exposes secrets via process listings and shell history.
Persistence & Privilege
The skill does not request persistent/always-on presence, does not modify other skills or system-wide config, and is user-invocable only. Autonomous invocation is allowed by default but not combined with other alarming privileges.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install email-usage - 安装完成后，直接呼叫该 Skill 的名称或使用
/email-usage触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.2
支持 SASL 认证、新增 create_email.py、subject 解码、5参数调用
v1.0.1
- Clarified in the Python SMTP example that the envelope sender is rewritten to [email protected] by Postfix canonical_maps.
- Added logic in the send_email function to ensure from_addr defaults to [email protected] if not provided.
v1.0.0
- Initial release of the "email-usage" skill.
- Provides clear examples in Python and bash for sending emails via SMTP (localhost:1025) and reading emails via IMAP (localhost:1143).
- Explicitly states no involvement with server configuration, SMTP setup, or container management.
- Defines operational rules and directs users to contact mailserver-maintenance in case of connection timeouts or sending failures.
元数据
常见问题
Email Usage 是什么？
使用本地邮件服务器收发我们自己域名的邮件。固定脚本位于 scripts/ 目录，直接执行即可。发送失败或密码遗忘时联系 小爪子。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 124 次。
如何安装 Email Usage？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install email-usage」即可一键安装，无需额外配置。
Email Usage 是免费的吗？
是的，Email Usage 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Email Usage 支持哪些平台？
Email Usage 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Email Usage？
由 AxelHu（@axelhu）开发并维护，当前版本 v1.0.2。
推荐 Skills