← Back to Skills Marketplace
124
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install email-usage
Description
使用本地邮件服务器收发我们自己域名的邮件。固定脚本位于 scripts/ 目录，直接执行即可。发送失败或密码遗忘时联系 小爪子。
README (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）
- 不要修改容器内配置
- 连接超时或发送失败 → 联系 小爪子
- 密码遗忘 → 联系 小爪子
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install email-usage - After installation, invoke the skill by name or use
/email-usage - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is Email Usage?
使用本地邮件服务器收发我们自己域名的邮件。固定脚本位于 scripts/ 目录，直接执行即可。发送失败或密码遗忘时联系 小爪子。 It is an AI Agent Skill for Claude Code / OpenClaw, with 124 downloads so far.
How do I install Email Usage?
Run "/install email-usage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Email Usage free?
Yes, Email Usage is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Email Usage support?
Email Usage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Email Usage?
It is built and maintained by AxelHu (@axelhu); the current version is v1.0.2.
More Skills