{"skill":{"slug":"email-cron-handler","displayName":"email-cron-handler","summary":"邮件指令定时处理任务。通过 IMAP/SMTP 自动接收并执行邮件中的指令，以邮件形式回复执行结果。适用于：(1) 创建定时任务监控指定邮箱 (2) 通过邮件下发指令给 AI Agent (3) 实现邮件驱动的自动化工作流。需配置：收件邮箱、SMTP/IMAP 配置、指令发件人白名单。","description":"---\nname: email-cron-handler\ndescription: 邮件指令定时处理任务。通过 IMAP/SMTP 自动接收并执行邮件中的指令，以邮件形式回复执行结果。适用于：(1) 创建定时任务监控指定邮箱 (2) 通过邮件下发指令给 AI Agent (3) 实现邮件驱动的自动化工作流。需配置：收件邮箱、SMTP/IMAP 配置、指令发件人白名单。\n---\n\n# Email Cron Handler\n\n通过邮件接收指令、定时执行并回复结果的自动化工作流。\n\n## 核心功能\n\n- 定时检查指定邮箱的新邮件\n- 过滤白名单发件人的指令邮件\n- 执行邮件中的指令并回复结果\n- 支持成功/失败/超时状态反馈\n\n## 文件结构\n\n```\nemail-cron-handler/\n├── SKILL.md\n├── scripts/\n│   ├── process_email.py      # 主处理脚本\n│   └── config.json.example   # 配置示例文件\n└── references/\n    └── config-template.md    # 详细配置说明\n```\n\n## 快速开始\n\n### Step 1: 配置邮箱参数\n\n```bash\ncd ~/.agents/skills/email-cron-handler/scripts\ncp config.json.example config.json\n# 编辑 config.json，填入你的实际配置\n```\n\n配置项说明：\n- `email`: 你的邮箱账号\n- `password`: 邮箱授权码（QQ邮箱需在设置中开启IMAP/SMTP后获取）\n- `imap_host`/`imap_port`: IMAP 服务器地址和端口\n- `smtp_host`/`smtp_port`: SMTP 服务器地址和端口\n- `whitelist_sender`: 白名单发件人（只处理这些地址发来的邮件）\n\n### Step 2: 初始化存储目录\n\n```bash\nmkdir -p ~/.openclaw/workspace/memory\necho '[]' > ~/.openclaw/workspace/memory/processed_emails.json\n```\n\n### Step 3: 创建定时任务\n\n**方式一：使用脚本（推荐）**\n\nCron 任务只需执行简单逻辑：\n1. 调用 `python process_email.py fetch` 获取未处理邮件\n2. 对每封邮件执行指令\n3. 调用 `python process_email.py reply <uid> <结果>` 回复结果\n\n**方式二：直接用 LLM（当前方式）**\n\n保持现有指令模板即可，脚本作为备用/调试工具。\n\n## 脚本用法\n\n```bash\n# 获取未处理邮件\npython process_email.py fetch\n\n# 回复邮件（内容直接提供）\npython process_email.py reply <uid> \"执行结果内容\"\n\n# 回复邮件（从文件读取内容）\npython process_email.py reply <uid> --file result.txt\n\n# 标记邮件为已处理（不回复）\npython process_email.py mark <uid>\n```\n\n## 常见问题\n\n**Q: 如何测试脚本？**\n```bash\ncd ~/.agents/skills/email-cron-handler/scripts\npython process_email.py fetch\n```\n\n**Q: 授权码在哪里获取？**\nA: QQ 邮箱 → 设置 → 账户 → 开启 IMAP/SMTP 服务 → 获取授权码\n\n**Q: 脚本和 LLM 指令选哪个？**\nA: \n- 脚本方式：稳定快速，适合简单场景\n- LLM 指令方式：灵活可扩展，适合复杂指令执行\n","topics":["Cron","Email","定时任务","定时","工作流"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":709,"installsAllTime":27,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773582855612,"updatedAt":1779078293279},"latestVersion":{"version":"1.0.0","createdAt":1773582855612,"changelog":"Initial release of email-cron-handler:\n\n- Automates processing of command emails via IMAP/SMTP and replies with execution results.\n- Supports scheduled mailbox monitoring, sender whitelisting, and execution status feedback (success/failure/timeout).\n- Provides example configuration and documentation for quick setup.\n- Includes scripts for fetching, replying to, and marking processed emails.","license":"MIT-0"},"metadata":null,"owner":{"handle":"pebblerwon","userId":"s1745eazw8n51tfw634t7fyhk9884jfz","displayName":"王浩楠","image":"https://avatars.githubusercontent.com/u/10150276?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089897822}}