← 返回 Skills 市场
entzclaw

Email Checker by EntzAI

作者 entzclaw · GitHub ↗ · v1.1.1 · MIT-0
darwin ⚠ suspicious
243
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install email-checker-by-entzai
功能描述
Automated email assistant for Apple Mail. Runs on a schedule, scores priority, drafts AI replies, and emails you a report. Manage your inbox from Telegram or...
使用说明 (SKILL.md)

Email Checker for Mac

Automated email assistant for Apple Mail on macOS. Runs on a schedule, scores your unread emails by priority, drafts AI replies, and sends you a report — so you can manage your inbox from Telegram or WhatsApp without ever opening Mail.app.

Installation

git clone https://github.com/entzclaw/email-checker-for-mac
cd email-checker-for-mac
bash setup.sh

Setup

The wizard handles everything:

  1. Auto-discovers your Mail.app accounts
  2. Prompts for name, report email, trusted senders
  3. Picks your LLM provider (LM Studio, Ollama, OpenAI, or skip)
  4. Tests the connection and writes config/settings.json
  5. Installs the crontab

Usage

# Run a manual check
python3 scripts/email/checker.py

# Send a reply
python3 scripts/email/send_reply.py \
    --to [email protected] \
    --subject "Re: Something" \
    --content "Your reply here"

# Check logs
tail -f logs/email_check.log

OpenClaw Integration

Tell OpenClaw via Telegram or WhatsApp:

"Run the email checker now" "Send the draft reply to Alice" "Add @company.com to my trusted senders"

Supported LLM Providers

Provider Notes
LM Studio Local or remote vLLM endpoint
Ollama Local
OpenAI Requires API key
None Reports without AI drafts

Requirements

  • macOS (tested on Tahoe 26.3, Apple Silicon)
  • Python 3
  • Mail.app with at least one configured account
  • Automation permission: System Settings → Privacy & Security → Automation → Terminal → Mail
安全使用建议
Plain-language recommendations before you install: - Confirm the missing AppleScript: The Python checker expects a get_unread_emails.scpt file (used to read unread Mail.app messages), but that .scpt is not present in the provided manifest. Ask the author or check the repository for that file; without it the checker will fail. - Understand the privileges you must grant: setup.sh requires you to allow Terminal to control Mail.app and may ask for Full Disk Access if running from cron. That lets the scripts read and send email on your behalf — only grant this on a machine/account you trust for this purpose. - Cron persistence: setup.sh installs a crontab entry so the checker runs on a schedule. If you prefer manual runs, decline crontab installation and run the script manually. If you do install cron, note the skill will run even when you are not actively using the agent. - LLM API keys live on disk: If you select OpenAI or another remote LLM, the API key is stored in config/settings.json. Ensure that file is protected, not in source control, and rotate the key if you stop using the skill. Prefer local LLMs (LM Studio/Ollama) if you don't want keys sent to external APIs. - Review AppleScript string interpolation and inputs: The code constructs AppleScript snippets using subject/to addresses and other fields. This is expected for AppleScript-based Mail control, but if you allow external inputs (via files or agent commands) ensure they are trusted to avoid injection-like issues. - Test in an isolated account: Run the setup and test on a disposable macOS account or VM with a dedicated bot inbox (as suggested in README) before giving it access to your primary email. If you want, I can: (a) search the repo for the missing get_unread_emails.scpt, (b) point out exact lines in the scripts that construct AppleScript or run subprocesses for a closer review, or (c) generate a checklist of settings/permissions to review on macOS before installation.
功能分析
Type: OpenClaw Skill Name: email-checker-by-entzai Version: 1.1.1 The skill bundle is classified as suspicious due to a command injection vulnerability in `scripts/email/send_reply.py`, where the `--subject` argument is interpolated into an AppleScript string without sanitization, allowing for arbitrary code execution. The bundle also utilizes `osascript` to control Mail.app and modifies system persistence via `crontab` in `setup.sh`. While these capabilities are necessary for the stated purpose of an automated email assistant, the lack of input validation on externally influenced data (like email subjects) creates a significant security risk that could be exploited through indirect prompt injection.
能力评估
Purpose & Capability
Name/description match the included code: Python scripts use osascript to read Mail.app, score messages, draft replies, and send reports. Required binaries (python3, osascript) and Mail.app are appropriate. However, the code references a get_unread_emails.scpt AppleScript file used to fetch messages but that .scpt is not present in the provided file manifest — if actually missing the checker cannot fetch unread emails as described.
Instruction Scope
SKILL.md and setup.sh instruct the user to grant Terminal permission to control Mail.app (Automation) and possibly Full Disk Access, and to install a cron job. Those are necessary for the stated functionality but are high-privilege actions: the scripts will read mailbox contents and send messages via Mail.app. The README/SKILL.md also expect OpenClaw to edit config/settings.json directly; that gives the agent write access to runtime config. The instructions are fairly specific (not open-ended), but they do expand the agent's operational surface to persistent, privileged automation.
Install Mechanism
No external download/install spec is included; this is instruction-and-source bundled in the skill. The setup is local (setup.sh writes config and installs a crontab). There are no downloads from arbitrary URLs, package manager installs, or extract steps in the skill package — low install-mechanism risk.
Credentials
The registry metadata declares no required env vars. The interactive setup optionally requests an LLM API key (OpenAI or other) and stores it in config/settings.json (gitignored). Requesting API keys is proportionate to the LLM feature. Be aware the key is stored on disk in a file that the skill and any process with file access can read; OpenClaw edits that config as part of its integration, which could expose or change stored credentials.
Persistence & Privilege
setup.sh (the provided installer) will install a cron job to run the checker on a schedule and instruct the user to grant Terminal Automation/Full Disk Access. That creates persistent background activity outside the immediate agent invocation and gives Mail.app automation rights. The skill metadata does not set always:true, but the installed cron plus automation permissions increases the blast radius — review and approve these system-level changes before proceeding.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install email-checker-by-entzai
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /email-checker-by-entzai 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.1
- Updated documentation in README.md and SKILL.md for clarity and consistency. - Refreshed metadata and configuration details in _meta.json. - Made setup.sh adjustments to align with documentation updates.
v1.1.0
- Internal documentation cleaned up: removed DEVLOG, USER-EXPERIENCE, and WORKFLOW markdown files from the docs directory. - README, meta, script, and setup files updated. - No user-facing functionality changes in this release.
v1.0.0
Initial release of Email Checker for Mac: - Automated assistant for Apple Mail on macOS, running on a schedule. - Prioritizes unread emails, drafts AI replies, and emails you a report. - Supports interaction via Telegram or WhatsApp through OpenClaw integration. - Setup wizard auto-discovers accounts, configures options, and installs crontab. - Compatible with LM Studio, Ollama, OpenAI, or no AI provider. - Requires macOS, Python 3, and Mail.app.
元数据
Slug email-checker-by-entzai
版本 1.1.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

Email Checker by EntzAI 是什么?

Automated email assistant for Apple Mail. Runs on a schedule, scores priority, drafts AI replies, and emails you a report. Manage your inbox from Telegram or... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 243 次。

如何安装 Email Checker by EntzAI?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install email-checker-by-entzai」即可一键安装,无需额外配置。

Email Checker by EntzAI 是免费的吗?

是的,Email Checker by EntzAI 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Email Checker by EntzAI 支持哪些平台?

Email Checker by EntzAI 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin)。

谁开发了 Email Checker by EntzAI?

由 entzclaw(@entzclaw)开发并维护,当前版本 v1.1.1。

💬 留言讨论