← Back to Skills Marketplace
Post
by
Oliver Drobnik
· GitHub ↗
· v1.5.0
· MIT-0
179
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install post
Description
Manage IMAP email with the Post CLI and local daemon. Use when reading, searching, fetching, drafting, replying, reply-all, moving, archiving, trashing, expo...
Usage Guidance
This skill appears to do exactly what it says: manage IMAP mail via a local CLI and daemon installed from Homebrew. The main risks are operational: 1) Scoped POST_API_KEY tokens grant mailbox access — only give agents the narrowest token they need, store tokens in a restricted workspace (.env with chmod 600) and rotate/delete tokens when unused. 2) If you configure a daemon hook (command), that script will receive email metadata and a JSON payload and can run arbitrary commands on your machine; only use trusted hook scripts and avoid placing hook scripts in paths writable by untrusted agents. 3) Auto-starting postd via LaunchAgent is normal for a daemon but gives continuous background access to mail; ensure you trust the software and the Homebrew tap. If you want added assurance, review the Homebrew formula source and the upstream GitHub repo releases before installing and restrict agent permissions to scoped tokens rather than full-access credentials.
Capability Analysis
Type: OpenClaw Skill
Name: post
Version: 1.5.0
The 'post' skill bundle provides a legitimate interface for managing IMAP email via the Post CLI and daemon on macOS. It includes well-documented procedures for credential management using the macOS Keychain and explicitly encourages the use of scoped API keys to restrict agent access to specific mail servers, which is a strong security practice. While the documentation includes a Python example with a potential shell injection vulnerability (os.system), this is presented as a template for user-defined hooks rather than functional code within the skill itself, and no evidence of intentional malice, data exfiltration, or hidden backdoors was found.
Capability Assessment
Purpose & Capability
Name/description, required binaries (post, postd), and the Homebrew install formula align with a local macOS mail CLI/daemon. Required items are proportional to the stated functionality.
Instruction Scope
Runtime instructions stay on-topic (search, fetch, draft, reply, attachments, daemon setup). They explicitly describe optional config files (~/.post.json), scoped API-key usage, and daemon hook commands. Important: hook commands receive environment variables and a JSON payload and can run arbitrary scripts/commands — this is expected for hook functionality but is the primary area where data (email contents, metadata, and tokens if misconfigured) could be exposed or acted on.
Install Mechanism
Install uses a Homebrew formula from cocoanetics/tap, a standard macOS package mechanism. This is an expected and low-risk install channel for a macOS-only CLI/daemon.
Credentials
The skill does not require environment variables to function, but the documentation instructs using scoped POST_API_KEY tokens and optionally storing them in an agent workspace .env file. Requesting and using API tokens is appropriate, but these tokens grant mailbox access and must be scoped and protected (chmod 600, avoid global shells).
Persistence & Privilege
always is false and the skill does not request system-wide privileges beyond optional LaunchAgent instructions to auto-start the daemon. The provided LaunchAgent and daemon controls are appropriate for a background mail daemon on macOS; no evidence the skill modifies other skills or system-wide agent configs beyond standard daemon install steps.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install post - After installation, invoke the skill by name or use
/post - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.5.0
- Improved and expanded SKILL.md with clearer usage instructions, detailed core rules, and fast command map.
- Added guidance for reply workflows, agent-specific API keys, and mailbox-specific operations.
- Enhanced security recommendations with scoped API key best practices.
- Included more concrete examples for each main Post feature: account/folder inspection, searching, drafting, replying, and mail organization.
- Updated documentation to cover installation, initial setup, and integration with Mail.app.
Metadata
Frequently Asked Questions
What is Post?
Manage IMAP email with the Post CLI and local daemon. Use when reading, searching, fetching, drafting, replying, reply-all, moving, archiving, trashing, expo... It is an AI Agent Skill for Claude Code / OpenClaw, with 179 downloads so far.
How do I install Post?
Run "/install post" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Post free?
Yes, Post is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Post support?
Post is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin).
Who created Post?
It is built and maintained by Oliver Drobnik (@odrobnik); the current version is v1.5.0.
More Skills