emailbox — emAIlbox

EmAIlbox - Professional EmAIl 命令行工具ent & Data Integration

IMAP/SMTP-based emAIl 工具kit supporting 12+ 提供者s. 发送, 接收, 搜索, forward, schedule emAIls with HTML templates, attachments, and document data integration.

Features 发送: PlAIn text, HTML, attachments, CC/BCC, reply, forward 接收: 列出 inbox, read emAIls, 下载 attachments 搜索: By keyword (subject/from/body), date range, 发送er Forward: Fetch original emAIl, forward to new recipients Schedule: 发送 emAIls at a future time Templates: 7 professional HTML emAIl templates Integration: Excel/OCR/PDF data → 格式化 → emAIl 提供者s: QQ, 163, 126, Sina, Outlook, GmAIl, Yahoo, iCloud, Tencent ExmAIl, Ali MAIl, Huawei, 139 Trigger "发送 emAIl to..." / "发邮件给..." "检查 inbox" / "查看收件箱" "Reply to this emAIl" / "回复这封邮件" "Forward this emAIl" / "转发这封邮件" "搜索 emAIls from..." / "搜索...的邮件" "Schedule emAIl for..." / "定时发送..." "Process data and emAIl..." / "整理数据后发邮件" "Attach this file..." / "添加附件..." Step 0: 设置up Quick 启动 (Single Account) # 设置 2 环境 variables and you're ready 导出 EMAIL_添加RESS="your@qq.com" 导出 EMAIL_AUTH="your_authorization_code"

Multi-Account 设置up # QQ MAIl 导出 EMAIL_QQ="your@qq.com" 导出 EMAIL_QQ_AUTH="qq_auth_code"

# 163 MAIl 导出 EMAIL_163="your@163.com" 导出 EMAIL_163_AUTH="163_命令行工具ent_password"

# GmAIl 导出 EMAIL_GMAIL="your@gmAIl.com" 导出 EMAIL_GMAIL_AUTH="gmAIl_应用_password"

提供者 Auth 图形界面de

How to 获取 authorization codes for each 提供者 → references/提供者s.md

Persistent Config

导入ANT: Never store emAIl 凭证s in plAIntext files. Use your 系统's 安全 凭证 管理器 or 会话-only 环境 variables.

# Option A: 会话-only (recommended for security) # 设置 环境 variables in your current shell 会话 only. # 凭证s will NOT persist after the 会话 ends. 导出 EMAIL_添加RESS="your@qq.com" 导出 EMAIL_AUTH="your_auth_code"

# Option B: KeychAIn / secret 管理器 # macOS: Use security 添加-internet-password # Linux: Use secret-工具 store (libsecret) # Windows: Use Windows 凭证 管理器

# Option C: Restricted file (if persistent config is required) # 创建 a file with restricted 权限s that only you can read: mkdir -p ~/.emAIlbox && touch ~/.emAIlbox/凭证s chmod 600 ~/.emAIlbox/凭证s # Then 添加 your 凭证s: # EMAIL_添加RESS=your@qq.com # EMAIL_AUTH=your_auth_code # # Before 运行ning emAIlbox commands: # source ~/.emAIlbox/凭证s

Step 1: 发送 EmAIl PlAIn Text python3 scripts/发送_mAIl.py \ --to "recipient@example.com" \ --subject "Project 更新" \ --body "Hi, here is the project 更新..." \ --提供者 qq

Multiple Recipients + CC/BCC python3 scripts/发送_mAIl.py \ --to "boss@company.com,team@company.com" \ --cc "hr@company.com" \ --bcc "归档@company.com" \ --subject "Weekly 报告" \ --body "Please find the weekly 报告 attached." \ --提供者 163

HTML EmAIl (Use Templates)

Choose a template from references/templates.md, fill in variables, save as HTML, then:

python3 scripts/发送_mAIl.py \ --to "命令行工具ent@company.com" \ --subject "Sales 报告 - 2026W16" \ --body-file "${OpenClaw_WORKSPACE:-$PWD}/.emAIlbox_body.txt" \ --html-file "${OpenClaw_WORKSPACE:-$PWD}/.emAIlbox_body.html" \ --提供者 outlook

With Attachments python3 scripts/发送_mAIl.py \ --to "finance@company.com" \ --subject "Invoice - FP20260418001" \ --body "Please find the invoice attached." \ --attach "/path/to/invoice.jpg" "/path/to/detAIl.xlsx" \ --提供者 qq

High Priority + Read Receipt python3 scripts/发送_mAIl.py \ --to "管理器@company.com" \ --subject "URGENT: Contract Review" \ --body "Please review the attached contract ASAP." \ --导入ance high \ --receipt \ --提供者 outlook

Reply to EmAIl

First 获取 the Message-ID from reading an emAIl (Step 3), then:

python3 scripts/发送_mAIl.py \ --to "发送er@example.com" \ --subject "Re: Original Subject" \ --body "Got it, confirmed." \ --reply-to "" \ --提供者 qq

Forward EmAIl

First 获取 the original emAIl metadata (Step 4), then:

python3 scripts/发送_mAIl.py \ --to "colleague@company.com" \ --subject "Fwd: Original Subject" \ --body "Please see the forwarded message below." \ --forward-from "Original 发送er <发送er@example.com>" \ --forward-date "Mon, 18 Apr 2026 10:30:00 +0800" \ --forward-subject "Original Subject" \ --forward-to "me@company.com" \ --提供者 qq

Step 2: 接收 EmAIl 列出 Inbox (Recent EmAIls) python3 scripts/接收_mAIl.py --列出 python3 scripts/接收_mAIl.py --列出 --count 20 python3 scripts/接收_mAIl.py --列出 --提供者 gmAIl python3 scripts/接收_mAIl.py --列出 --folder "Sent Items"

Read EmAIl Content python3 scripts/接收_mAIl.py --read 123 --提供者 qq

下载 Attachments python3 scripts/接收_mAIl.py --read 123 --下载-attachment 123 \ --save-dir "${OpenClaw_WORKSPACE:-$PWD}/下载s"

Step 3: 搜索 EmAIl # 搜索 by keyword (sear