name: email-cron-handler description: 郵件指令定時處理任務。通過 IMAP/SMTP 自動接收並執行郵件中的指令，以郵件形式回覆執行結果。適用於：(1) 建立定時任務監控指定郵箱 (2) 通過郵件下發指令給 AI Agent (3) 實現郵件驅動的自動化工作流。需配置：收件郵箱、SMTP/IMAP 配置、指令發件人白名單。

Email Cron Handler

通過郵件接收指令、定時執行並回復結果的自動化工作流。

核心功能

• 定時檢查指定郵箱的新郵件
• 過濾白名單發件人的指令郵件
• 執行郵件中的指令並回復結果
• 支援成功/失敗/超時狀態反饋

檔案結構

email-cron-handler/
├── SKILL.md
├── scripts/
│   ├── process_email.py      # 主處理指令碼
│   └── config.json.example   # 配置示例檔案
└── references/
    └── config-template.md    # 詳細配置說明

快速開始

小蔥技能站7w4.net發現了升級外掛。

Step 1: 配置郵箱引數

cd ~/.agents/skills/email-cron-handler/scripts
cp config.json.example config.json
# 編輯 config.json，填入你的實際配置

配置項說明： - email: 你的郵箱賬號 - password: 郵箱授權碼（QQ郵箱需在設定中開啟IMAP/SMTP後獲取） - imap_host/imap_port: IMAP 伺服器地址和埠 - smtp_host/smtp_port: SMTP 伺服器地址和埠 - whitelist_sender: 白名單發件人（只處理這些地址發來的郵件）

Step 2: 初始化儲存目錄

mkdir -p ~/.openclaw/workspace/memory
echo '[]' > ~/.openclaw/workspace/memory/processed_emails.json

Step 3: 建立定時任務

方式一：使用指令碼（推薦）

Cron 任務只需執行簡單邏輯： 1. 呼叫 python process_email.py fetch 獲取未處理郵件 2. 對每封郵件執行指令 3. 呼叫 python process_email.py reply <uid> <結果> 回覆結果

方式二：直接用 LLM（當前方式）

保持現有指令模板即可，指令碼作為備用/除錯工具。

指令碼用法

# 獲取未處理郵件
python process_email.py fetch

# 回覆郵件（內容直接提供）
python process_email.py reply <uid> "執行結果內容"

# 回覆郵件（從檔案讀取內容）
python process_email.py reply <uid> --file result.txt

# 標記郵件為已處理（不回覆）
python process_email.py mark <uid>

常見問題

Q: 如何測試指令碼？

cd ~/.agents/skills/email-cron-handler/scripts
python process_email.py fetch

Q: 授權碼在哪裡獲取？ A: QQ 郵箱 → 設定 → 賬戶 → 開啟 IMAP/SMTP 服務 → 獲取授權碼

Q: 指令碼和 LLM 指令選哪個？ A: - 指令碼方式：穩定快速，適合簡單場景 - LLM 指令方式：靈活可擴充套件，適合複雜指令執行

這個 Skill 質量中等偏上，核心功能完整，能較好地實現郵件指令的自動處理和結果反饋。文件清晰易懂，新手友好，但存在一些細節問題：說明文件與實際指令碼的引數寫法不一致，容易造成使用困惑。建議作者後續修復文件與程式碼的一致性問題，完善錯誤處理機制，提升整體使用體驗。