← Back to Skills Marketplace
weavmail
by
Yan-ke Guo
· GitHub ↗
· v1.0.5
397
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install weavmail
Description
Use weavmail CLI to manage emails for the current task. Use when you need to read, send, reply to, or move emails as part of completing a task.
Usage Guidance
This skill appears to do what it says: a CLI email client that will require you to install the weavmail binary (via 'uv') and supply IMAP/SMTP credentials. Before installing, verify you trust the source of the weavmail binary and the 'uv' tool, and prefer an app-specific password for your mail account. Check where weavmail stores account credentials and whether they are encrypted, and be aware it will write email bodies and metadata to a local mails/ directory. The skill can send and move emails (network operations) — follow the HEARTBEAT.md guidance to avoid allowing the agent to act on emails without your explicit instruction.
Capability Analysis
Type: OpenClaw Skill
Name: weavmail
Version: 1.0.5
The weavmail skill bundle provides a structured interface for an AI agent to manage emails using a CLI tool. The instructions in SKILL.md and HEARTBEAT.md are well-documented, focusing on standard IMAP/SMTP configuration, mail synchronization to local Markdown files, and user-approved actions. Notably, the bundle includes strong safety guardrails in HEARTBEAT.md that explicitly forbid the agent from performing autonomous mail operations (sending, trashing, or archiving) without direct user instruction.
Capability Assessment
Purpose & Capability
Name/description match the instructions: the SKILL.md describes installing and using a weavmail CLI to read, send, and move mail. The only declared binary requirement is 'uv', which is used in the install instruction, so the requested artifacts align with the stated purpose.
Instruction Scope
Instructions tell the agent to install weavmail, configure IMAP/SMTP credentials via CLI, sync mailboxes, and read/write local Markdown files under ./mails/. This is expected for an email client. Note: SKILL.md does not state how account credentials are stored (location/encryption), and the client will write local files containing full email bodies and metadata—users should be aware of local storage of potentially sensitive content.
Install Mechanism
There is no packaged install specification in the registry; the docs instruct the user to run 'uv tool install weavmail'. Requiring 'uv' is coherent with that workflow. Installing via 'uv' will fetch external artifacts (normal for CLI tools) — the installer source and trust should be verified before running.
Credentials
The skill declares no required environment variables and the only secrets used are IMAP/SMTP username/password provided through the weavmail CLI—these are appropriate and proportional for an email client. No unrelated credentials or config paths are requested.
Persistence & Privilege
The skill is not marked 'always' and uses normal autonomous-invocation defaults. It will create local mailbox files and a local account config (expected for a CLI mail client). There is no indication it modifies other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install weavmail - After installation, invoke the skill by name or use
/weavmail - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
- Added support for batch operations in the `trash` and `archive` commands: multiple mail files can now be processed in one call.
- Updated documentation to clarify that `trash` and `archive` commands now accept multiple `MAIL_FILE` arguments for batch moves.
- Clarified how the account is determined for `trash` and `archive` (always from the mail file's front matter; no `--account` option).
- Adjusted edge case notes for command account handling and batch processing.
v1.0.4
- Added ARCHIVE mailbox support: new `archive` command moves mail to an archive folder, configurable via `--archive-mailbox`.
- Updated setup instructions to include optional `--archive-mailbox` field alongside Sent and Trash.
- Enhanced sync: new `--account` option allows syncing multiple (comma-separated) or all accounts at once.
- Documentation revised for clarity and expanded to cover multi-account syncing and the new archive feature.
- Added HEARTBEAT.md file.
v1.0.3
- Added support for `--cc` and `--bcc` options in the `send` command, allowing multiple recipients for these fields.
- Documentation for the send command updated to mention repeatable `--cc` and `--bcc` options.
- No code changes detected; update limited to documentation.
v0.1.1
- Added instructions to configure Sent and Trash mailboxes in the account settings after setup.
- Introduced a new `weavmail trash` command for moving emails directly to the configured trash mailbox.
- Clarified the requirement for `--trash-mailbox` configuration when using the trash command.
- Updated account handling: the `trash` command works like `move` and `send --reply` in reading the account from mail file front matter.
- Expanded documentation for mailbox configuration and usage.
v0.1.0
- Initial release of weavmail, a command-line email client for managing task-related emails.
- Supports reading, sending, replying to, moving, and organizing emails via simple CLI commands.
- Syncs emails as local Markdown files with complete metadata.
- Allows configuration of multiple email accounts and folders.
- Provides mailbox listing, file-based mail manipulation, and robust account management options.
Metadata
Frequently Asked Questions
What is weavmail?
Use weavmail CLI to manage emails for the current task. Use when you need to read, send, reply to, or move emails as part of completing a task. It is an AI Agent Skill for Claude Code / OpenClaw, with 397 downloads so far.
How do I install weavmail?
Run "/install weavmail" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is weavmail free?
Yes, weavmail is completely free (open-source). You can download, install and use it at no cost.
Which platforms does weavmail support?
weavmail is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created weavmail?
It is built and maintained by Yan-ke Guo (@yankeguo); the current version is v1.0.5.
More Skills