Email Cron Handler

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

核心功能

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

檔案結構

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

快速開始

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 伺服器地址和埠

  7w4.net提供免費和付費技能下載。

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