@zlr_236/email-marketing 1.0.0

package/README.md

@@ -0,0 +1,19 @@
+# @zlr_236/email-marketing
+
+Professional Email Marketing extension for OpenClaw.
+
+## Features
+- **Bulk Sender**: Send personalized emails from Excel with HTML templates.
+- **Anti-Spam**: Built-in random fingerprinting and human-like delay.
+- **Auto-Reply**: Automated FAQ-based email responses with language detection.
+
+## Installation
+```bash
+openclaw plugins install @zlr_236/email-marketing
+```
+
+## Configuration
+Requires environment variables:
+- `EMAIL_SMTP_HOST`, `EMAIL_SMTP_PORT`, `EMAIL_SMTP_USER`, `EMAIL_SMTP_PASS`
+- `EMAIL_IMAP_HOST`, `EMAIL_IMAP_PORT`
+- `EMAIL_EXCEL_PATH`, `EMAIL_HTML_PATH`, `EMAIL_TITLE_PATH`

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@zlr_236/email-marketing",
+  "version": "1.0.0",
+  "description": "Professional Email Marketing & Auto-Reply extension for OpenClaw. Features: Bulk Sending, HTML Rendering, Gmail Anti-Spam, and FAQ-based Auto-Reply.",
+  "main": "index.js",
+  "keywords": ["openclaw", "email-marketing", "automation", "bulk-sender"],
+  "author": "zhenglr",
+  "license": "MIT",
+  "dependencies": {
+    "pandas": "*",
+    "openpyxl": "*"
+  }
+}

package/skills/email-marketing/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: email-marketing
+description: 执行邮件营销任务，包括从桌面 Excel 读取名单、TXT 读取标题、HTML 读取正文并群发，以及统计回信和退信率。适用于需要通过网易邮箱进行自动化达人营销或客户开发的场景。
+---
+
+# 邮件营销 Skill (Email Marketing)
+
+本 Skill 专门为哥哥定制，用于稳健地执行网易邮箱营销任务。
+
+## 核心功能
+
+1. **个性化群发**：自动读取桌面 `邮箱.xlsx`，根据每行数据动态替换 HTML 中的 `【变量名】` 占位符，实现一对一精准营销。
+2. **测试发信**：在正式群发前，向指定邮箱发送测试邮件。
+3. **效果统计**：实时检查今日的发信、回信、退信并分析原因。
+
+## 资源依赖
+
+*   **名单**：`/Users/admin/Desktop/邮箱.xlsx` (自动识别首行标题。支持读取多列数据，如 `kol name`, `gender` 等，用于内容替换)
+*   **标题**：`/Users/admin/Desktop/邮件标题.txt`
+*   **内容**：`/Users/admin/Desktop/邮件内容.html`
+
+## 操作指南
+
+### 1. 测试发送
+执行测试以检查标题和 HTML 渲染是否正确。测试邮件将发送至 `EMAIL_TEST_TARGET` 环境变量配置的邮箱。
+`python3 final_sender.py`
+
+### 2. 执行全量群发
+确认测试无误后，执行正式发送。
+`python3 final_sender.py run`
+
+### 3. 查看今日统计
+检查当天的发送、回信和退信情况。输出必须保持极度简洁。
+`python3 check_replies.py`
+**输出格式要求**：
+- 发送：[数字]
+- 失败：[数字]
+- 回信：[数字]
+- 退信：[数字]
+
+**退信分析**：
+如果退信数量 > 0，必须读取退信邮件内容，并根据报错代码（如 550, 554 等）简洁总结失败原因（如：账号不存在、被判定为垃圾邮件、频率受限等）。
+
+## 注意事项
+*   **稳重原则**：发信脚本已配置批次发送策略：
+    *   **分批发送**：每 135 个收件人为一个批次，每个批次独立建立连接。
+    *   **快速投递**：取消单封邮件间隔，批次内连续发送以提高效率。
+*   **配置更新**：如需更换邮箱或授权码，请修改脚本开头的配置。

package/skills/email-marketing/auto_reply_manager.py

@@ -0,0 +1,157 @@
+import imaplib
+import email
+from email.header import decode_header
+import smtplib
+from email.mime.text import MIMEText
+from email.mime.multipart import MIMEMultipart
+import os
+import ssl
+import json
+import time
+
+# --- 配置信息 (从环境变量读取) ---
+IMAP_HOST = os.getenv("EMAIL_IMAP_HOST", "smtp.corp.netease.com")
+IMAP_PORT = int(os.getenv("EMAIL_IMAP_PORT", 993))
+SMTP_HOST = os.getenv("EMAIL_SMTP_HOST", "smtp.corp.netease.com")
+SMTP_PORT = int(os.getenv("EMAIL_SMTP_PORT", 465))
+EMAIL_USER = os.getenv("EMAIL_SMTP_USER", "")
+EMAIL_PASS = os.getenv("EMAIL_SMTP_PASS", "")
+
+FAQ_PATH = "/home/node/.openclaw/media/inbound/c3b043ac-df37-4fb0-9e21-89c4282030ef"
+PENDING_REPLIES_FILE = "pending_replies.json"
+
+def get_unread_emails():
+    """连接 IMAP 获取未读邮件"""
+    try:
+        mail = imaplib.IMAP4_SSL(IMAP_HOST, IMAP_PORT)
+        mail.login(EMAIL_USER, EMAIL_PASS)
+        # 选择发件箱以检查是否已回复
+        mail.select('"[Gmail]/Sent Mail"' if "gmail" in IMAP_HOST else "Sent Messages") # 简化逻辑，实际可能需适配不同服务商
+        # 这里为了简化，我们改为：在收件箱中只处理未读邮件，或者通过数据库记录已处理的 Message-ID
+        
+        mail.select("inbox")
+        # 搜索所有未读且未回复标志的邮件
+        status, response = mail.search(None, '(UNSEEN)')
+        unread_msg_nums = response[0].split()
+        
+        emails = []
+        for num in unread_msg_nums:
+            status, msg_data = mail.fetch(num, '(RFC822)')
+            raw_email = msg_data[0][1]
+            msg = email.message_from_bytes(raw_email)
+            
+            # 解析发件人
+            from_ = decode_header(msg.get("From"))[0][0]
+            if isinstance(from_, bytes): from_ = from_.decode()
+            
+            # 解析主题
+            subject = decode_header(msg.get("Subject"))[0][0]
+            if isinstance(subject, bytes): subject = subject.decode()
+            
+            # 解析正文
+            body = ""
+            if msg.is_multipart():
+                for part in msg.walk():
+                    content_type = part.get_content_type()
+                    if content_type == "text/plain" and not body:
+                        body = part.get_payload(decode=True).decode(errors='ignore')
+                    elif content_type == "text/html":
+                        html_body = part.get_payload(decode=True).decode(errors='ignore')
+                        # 如果没有纯文本，或者纯文本太短，则使用 HTML（后续可以加清洗）
+                        if not body or len(body) < 10:
+                            body = "[HTML Content] " + html_body
+            else:
+                body = msg.get_payload(decode=True).decode(errors='ignore')
+            
+            emails.append({
+                "id": num.decode(),
+                "from": from_,
+                "subject": subject,
+                "body": body.strip(),
+                "msg_id": msg.get("Message-ID")
+            })
+            
+        mail.logout()
+        return emails
+    except Exception as e:
+        print(f"IMAP 读取失败: {e}")
+        return []
+
+def save_pending_reply(email_data, draft_reply):
+    """保存待确认的回信"""
+    try:
+        data = []
+        if os.path.exists(PENDING_REPLIES_FILE):
+            with open(PENDING_REPLIES_FILE, 'r') as f:
+                data = json.load(f)
+        
+        data.append({
+            "email_id": email_data["id"],
+            "to": email_data["from"],
+            "original_subject": email_data["subject"],
+            "original_body": email_data["body"],
+            "draft_reply": draft_reply,
+            "status": "pending",
+            "timestamp": time.time()
+        })
+        
+        with open(PENDING_REPLIES_FILE, 'w') as f:
+            json.dump(data, f, indent=4)
+    except Exception as e:
+        print(f"保存待回信失败: {e}")
+
+def send_reply(to_email, subject, body, original_msg_id=None):
+    """发送回信"""
+    try:
+        # 跳过证书验证
+        context = ssl.create_default_context()
+        context.check_hostname = False
+        context.verify_mode = ssl.CERT_NONE
+
+        msg = MIMEMultipart()
+        msg['From'] = f"Youdao Ads <{EMAIL_USER}>"
+        msg['To'] = to_email
+        # 如果是回复，标题加上 Re:
+        if not subject.lower().startswith("re:"):
+            msg['Subject'] = "Re: " + subject
+        else:
+            msg['Subject'] = subject
+        
+        if original_msg_id:
+            msg['In-Reply-To'] = original_msg_id
+            msg['References'] = original_msg_id
+
+        msg.attach(MIMEText(body, 'plain', 'utf-8'))
+
+        with smtplib.SMTP_SSL(SMTP_HOST, SMTP_PORT, context=context) as server:
+            server.login(EMAIL_USER, EMAIL_PASS)
+            server.send_message(msg)
+        return True
+    except Exception as e:
+        print(f"发送回信失败: {e}")
+        return False
+
+if __name__ == "__main__":
+    import sys
+    # 如果通过命令行参数调用发送
+    if len(sys.argv) > 4 and sys.argv[1] == "send":
+        to = sys.argv[2]
+        subj = sys.argv[3]
+        content = sys.argv[4]
+        if send_reply(to, subj, content):
+            print("SUCCESS")
+        else:
+            print("FAILED")
+        sys.exit(0)
+    
+    # 默认扫描逻辑
+    unread = get_unread_emails()
+    if unread:
+        print(f"发现 {len(unread)} 封新回信。")
+        for e in unread:
+            print(f"--- 邮件来自: {e['from']} ---")
+            print(f"标题: {e['subject']}")
+            print(f"内容摘要: {e['body'][:100]}...")
+            # 后续逻辑将交由 Agent 使用 FAQ 进行拟稿并通知用户
+    else:
+        print("没有发现新回信。")

package/skills/email-marketing/check_replies.py

@@ -0,0 +1,134 @@
+import imaplib
+import email
+import json
+import os
+from datetime import datetime
+
+# --- 配置信息 (优先从环境变量读取) ---
+IMAP_HOST = os.getenv("EMAIL_IMAP_HOST","")
+IMAP_PORT = int(os.getenv("EMAIL_IMAP_PORT",465)) if os.getenv("EMAIL_IMAP_PORT") else 465
+IMAP_USER = os.getenv("EMAIL_SMTP_USER", "")
+IMAP_PASS = os.getenv("EMAIL_SMTP_PASS", "")
+REPLY_LOG = "reply_stats.json"
+
+def analyze_bounce_reason(body):
+    body_lower = body.lower()
+    if "user not found" in body_lower or "invalid user" in body_lower or "不存在" in body:
+        return "账号不存在 (Invalid User)"
+    elif "spam" in body_lower or "rejected" in body_lower or "垃圾邮件" in body:
+        return "触发垃圾邮件风控 (Spam/Rejected)"
+    elif "full" in body_lower or "quota" in body_lower or "满" in body:
+        return "对方邮箱已满 (Mailbox Full)"
+    return "其他原因 (详见摘要)"
+
+def check_replies():
+    # 修正已发人数统计：从日志文件中尝试汇总今日数据
+    sent_total = 0
+    if os.path.exists("email_status.json"):
+        try:
+            with open("email_status.json", "r") as f:
+                data = json.load(f)
+                # 如果是单次发信逻辑，这里显示最后一次成功数
+                sent_total = data.get("success", 0)
+        except: pass
+
+    replied_list = []
+    bounce_list = []
+    
+    # 严格过滤名单：系统号/订阅号不计入回信
+    SYSTEM_KEYWORDS = ["noreply", "notification", "service", "support", "no-reply", "report"]
+
+    today_imap = datetime.now().strftime("%d-%b-%Y")
+
+    try:
+        mail = imaplib.IMAP4_SSL(IMAP_HOST, IMAP_PORT)
+        mail.login(IMAP_USER, IMAP_PASS)
+        mail.select("INBOX") 
+
+        status, response = mail.search(None, f'(SINCE "{today_imap}")')
+        
+        if status == 'OK' and response[0]:
+            ids = response[0].split()
+            for r_id in ids:
+                status, data = mail.fetch(r_id, '(RFC822)')
+                if status != 'OK': continue
+                
+                msg = email.message_from_bytes(data[0][1])
+                from_addr = msg.get('From', '').lower()
+                subject = msg.get('Subject', '')
+                
+                # 解码标题
+                try:
+                    subject_parts = email.header.decode_header(subject)
+                    decoded_subject = ""
+                    for part, encoding in subject_parts:
+                        if isinstance(part, bytes):
+                            decoded_subject += part.decode(encoding or 'utf-8', errors='ignore')
+                        else:
+                            decoded_subject += part
+                    subject = decoded_subject
+                except: pass
+
+                # 提取正文摘要用于退信分析
+                body = ""
+                if msg.is_multipart():
+                    for part in msg.walk():
+                        if part.get_content_type() == "text/plain":
+                            payload = part.get_payload(decode=True)
+                            if payload: body = payload.decode('utf-8', errors='ignore')
+                            break
+                else:
+                    payload = msg.get_payload(decode=True)
+                    if payload: body = payload.decode('utf-8', errors='ignore')
+
+                # 1. 检查退信
+                if "系统退信" in subject or "systems bounce" in subject.lower() or "mailer-daemon" in from_addr:
+                    reason = analyze_bounce_reason(body)
+                    bounce_list.append({"from": from_addr, "reason": reason, "summary": body[:50]})
+                
+                # 2. 检查真实回信 (排除自己和系统号)
+                else:
+                    is_system = any(kw in from_addr for kw in SYSTEM_KEYWORDS)
+                    is_self = IMAP_USER.lower() in from_addr
+                    
+                    if not is_system and not is_self:
+                        replied_list.append({"from": from_addr, "subject": subject})
+
+        mail.logout()
+
+        stats = {
+            "sent_total": sent_total,
+            "replied_total": len(replied_list),
+            "bounce_total": len(bounce_list),
+            "replied_details": replied_list,
+            "bounce_details": bounce_list,
+            "check_time": datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+        }
+
+        with open(REPLY_LOG, 'w', encoding='utf-8') as f:
+            json.dump(stats, f, ensure_ascii=False, indent=4)
+        
+        return stats
+
+    except Exception as e:
+        return None
+
+if __name__ == "__main__":
+    results = check_replies()
+    if results:
+        print("\n--- 邮件营销综合效果报告 ---")
+        print(f"统计日期: {datetime.now().strftime('%Y-%m-%d')}")
+        print(f"最近一次群发人数: {results['sent_total']}")
+        print(f"真实回信人数: {results['replied_total']}")
+        print(f"今日退信数量: {results['bounce_total']}")
+        
+        if results['replied_total'] > 0:
+            print("\n[回信详情]:")
+            for r in results['replied_details']:
+                print(f"- 来自: {r['from']}")
+                print(f"  标题: {r['subject']}")
+        
+        if results['bounce_total'] > 0:
+            print("\n[退信分析]:")
+            for b in results['bounce_details']:
+                print(f"- 原因: {b['reason']}")

package/skills/email-marketing/final_sender.py

@@ -0,0 +1,185 @@
+import pandas as pd
+import smtplib
+import ssl
+from email.mime.text import MIMEText
+from email.mime.multipart import MIMEMultipart
+import time
+import json
+import os
+import random
+import string
+import re
+
+# --- 配置信息 (从环境变量读取) ---
+SMTP_HOST = os.getenv("EMAIL_SMTP_HOST", "")
+SMTP_PORT = int(os.getenv("EMAIL_SMTP_PORT", 465)) if os.getenv("EMAIL_SMTP_PORT") else 465
+SMTP_USER = os.getenv("EMAIL_SMTP_USER", "")
+SMTP_PASS = os.getenv("EMAIL_SMTP_PASS", "")
+TEST_EMAIL = os.getenv("EMAIL_TEST_TARGET", "")
+
+EXCEL_PATH = os.path.expanduser(os.getenv("EMAIL_EXCEL_PATH", "~/Desktop/邮箱.xlsx"))
+HTML_PATH = os.path.expanduser(os.getenv("EMAIL_HTML_PATH", "~/Desktop/邮件内容.html"))
+TITLE_TXT_PATH = os.path.expanduser(os.getenv("EMAIL_TITLE_PATH", "~/Desktop/邮件标题.txt"))
+LOG_FILE = "email_status.json"
+
+BATCH_SIZE = 135  # 每个批次的收件人数量
+
+def get_title_from_txt(path):
+    try:
+        if os.path.exists(path):
+            with open(path, 'r', encoding='utf-8') as f:
+                return f.read().strip()
+        return "你好"
+    except Exception as e:
+        print(f"读取 TXT 标题失败: {e}")
+        return "你好"
+
+def generate_random_tag():
+    """生成随机隐藏标识符，干扰反垃圾扫描"""
+    chars = string.ascii_letters + string.digits
+    tag = ''.join(random.choice(chars) for _ in range(8))
+    return f'<div style="display:none !important; color:transparent; visibility:hidden; opacity:0; font-size:0px;">ID:{tag}</div>'
+
+def get_email_data():
+    """读取 Excel 并识别标题行和数据列"""
+    try:
+        # 先读取前几行看是否有标题
+        peek = pd.read_excel(EXCEL_PATH, nrows=5)
+        # 简单判断首行是否包含邮箱格式特征
+        has_header = not any("@" in str(col) for col in peek.columns)
+        
+        if has_header:
+            df = pd.read_excel(EXCEL_PATH)
+        else:
+            df = pd.read_excel(EXCEL_PATH, header=None)
+            # 给第一列起个默认名
+            df.columns = ["email"] + [f"col_{i}" for i in range(1, len(df.columns))]
+            
+        # 寻找包含邮箱的那一列
+        email_col = None
+        for col in df.columns:
+            if df[col].astype(str).str.contains("@").any():
+                email_col = col
+                break
+        
+        if email_col is None:
+            raise ValueError("Excel 中未找到有效的邮箱地址列")
+            
+        return df, email_col
+    except Exception as e:
+        print(f"读取 Excel 数据失败: {e}")
+        return None, None
+
+def replace_placeholders(text, row_data):
+    """将文本中的 【变量名】 替换为行数据中的对应值"""
+    if not isinstance(text, str): return text
+    
+    # 查找所有 【...】 格式的占位符
+    placeholders = re.findall(r"【(.*?)】", text)
+    for p in placeholders:
+        # 在列名中寻找匹配（不区分大小写，去掉空格）
+        match_col = None
+        clean_p = p.strip().lower()
+        for col in row_data.index:
+            if str(col).strip().lower() == clean_p:
+                match_col = col
+                break
+        
+        if match_col is not None:
+            val = str(row_data[match_col])
+            if val.lower() == "nan": val = ""
+            text = text.replace(f"【{p}】", val)
+    return text
+
+def send_bulk_emails(test_mode=True, test_email=None):
+    # 加载数据
+    df, email_col = get_email_data()
+    if df is None: return
+
+    # 获取基础标题
+    subject_template = get_title_from_txt(TITLE_TXT_PATH)
+    
+    # 读取 HTML 模板
+    try:
+        with open(HTML_PATH, 'r', encoding='utf-8') as f:
+            html_template = f.read()
+    except Exception as e:
+        print(f"读取 HTML 失败: {e}")
+        return
+
+    context = ssl.create_default_context()
+    context.check_hostname = False
+    context.verify_mode = ssl.CERT_NONE
+    results = {"total": 1 if test_mode else len(df), "success": 0, "failed": [], "start_time": time.strftime("%Y-%m-%d %H:%M:%S")}
+
+    # 准备任务列表
+    if test_mode:
+        # 测试模式下，取第一行数据（如果有）来模拟替换效果，但发送给 test_email
+        row = df.iloc[0].copy()
+        row[email_col] = test_email
+        task_list = [row]
+    else:
+        task_list = [row for _, row in df.iterrows()]
+
+    # 分批发送
+    for i in range(0, len(task_list), BATCH_SIZE):
+        batch = task_list[i:i + BATCH_SIZE]
+        print(f"正在发送批次 {i//BATCH_SIZE + 1}，包含 {len(batch)} 个收件人...")
+        
+        try:
+            with smtplib.SMTP_SSL(SMTP_HOST, SMTP_PORT, context=context) as server:
+                server.login(SMTP_USER, SMTP_PASS)
+                
+                for row in batch:
+                    addr = str(row[email_col])
+                    try:
+                        # 执行变量替换
+                        final_subject = replace_placeholders(subject_template, row)
+                        final_html = replace_placeholders(html_template, row)
+                        
+                        # 插入干扰码
+                        final_html += generate_random_tag()
+                        
+                        msg = MIMEMultipart()
+                        msg['From'] = f"Youdao Ads <{SMTP_USER}>"
+                        msg['To'] = addr
+                        msg['Subject'] = final_subject
+                        msg.attach(MIMEText(final_html, 'html', 'utf-8'))
+
+                        server.send_message(msg)
+                        results["success"] += 1
+                        print(f"成功发送至: {addr}")
+                        
+                        # 降低发信频率，增加随机性
+                        if not test_mode:
+                            # 基础间隔 + 随机波动
+                            time.sleep(random.uniform(3.0, 8.0))
+                            # 每发送 10 封进行一次长休息
+                            if results["success"] % 10 == 0:
+                                time.sleep(random.uniform(10, 20))
+                        
+                    except Exception as e:
+                        print(f"发送至 {addr} 失败: {e}")
+                        results["failed"].append({"email": addr, "reason": str(e)})
+                
+                if not test_mode: time.sleep(2)
+                
+        except Exception as e:
+            print(f"连接失败: {e}")
+
+    results["end_time"] = time.strftime("%Y-%m-%d %H:%M:%S")
+    with open(LOG_FILE, 'w', encoding='utf-8') as f:
+        json.dump(results, f, ensure_ascii=False, indent=4)
+    return results
+
+if __name__ == "__main__":
+    import sys
+    if len(sys.argv) > 1 and sys.argv[1] == "run":
+        send_bulk_emails(test_mode=False)
+    else:
+        test_addr = TEST_EMAIL
+        if not test_addr:
+            print("错误: 未配置 EMAIL_TEST_TARGET 环境变量")
+            sys.exit(1)
+        print(f"准备发送测试邮件至: {test_addr}")
+        send_bulk_emails(test_mode=True, test_email=test_addr)