qq-email

# QQ Email Skill

Send and receive emails via QQ Mail SMTP/IMAP server.

## When to Use

✅ **USE this skill when:**

- "Send an email to..."
- "Check my emails"
- "Read my unread emails"
- "Email this to [someone]"
- "Notify [person] via email"
- "Share this document via email"
- "What's in my inbox?"

## When NOT to Use

❌ **DON'T use this skill when:**

- Sending SMS/WhatsApp → use messaging tools
- Internal notes → use memory files
- Public posts → use social media tools

## Configuration Required

Before using, configure in `TOOLS.md`:

```markdown
### QQ Email

- Email: your_qq_number@qq.com
- Auth Code: your_16_char_auth_code
- Sender Name: Your Name
```

**Get QQ Auth Code:**
1. Login to mail.qq.com
2. Settings → Account
3. Enable POP3/SMTP service
4. Generate authorization code (16 characters)

## Commands

### Send Email

```bash
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py send \
  --to "recipient@example.com" \
  --subject "Email Subject" \
  --content "Email content here"
```

### Receive/List Emails

```bash
# List 10 recent emails
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive

# List 20 emails
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive --count 20

# Unread emails only
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive --unread
```

### Read Specific Email

```bash
# Read email by UID
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py read --uid 123

# Read and save attachments
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py read --uid 123 --save
```

### Mark Email as Read

```bash
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py mark-read --uid 123
```

### Send HTML Email

```bash
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py send \
  --to "recipient@example.com" \
  --subject "HTML Email" \
  --content "<h1>Hello</h1><p>HTML content</p>" \
  --html
```

### Send with Attachment

```bash
python3 ~/.openclaw/workspace/skills/qq-email/qq_email...

# QQ Email Skill for OpenClaw

通过 QQ 邮箱 SMTP/IMAP 发送和接收邮件的 OpenClaw 技能。

## 📦 安装

技能已位于：`~/.openclaw/workspace/skills/qq-email/`

包含文件：
- `SKILL.md` - 技能说明文档
- `qq_email.py` - Python 脚本工具（发送 + 接收）

## ⚙️ 配置

### 方法 1：环境变量（推荐）

```bash
export QQ_EMAIL_ADDRESS="123456@qq.com"
export QQ_EMAIL_AUTH="abcdefghijklmnop"  # 16 位授权码
export QQ_EMAIL_SENDER="Your Name"  # 可选
```

### 方法 2：TOOLS.md 配置

编辑 `~/.openclaw/workspace/TOOLS.md`，添加：

```markdown
## QQ Email

- Email: 123456@qq.com
- Auth Code: abcdefghijklmnop
- Sender Name: Your Name
```

### 获取 QQ 邮箱授权码

1. 登录 [QQ 邮箱网页版](https://mail.qq.com)
2. 点击 **设置** → **账户**
3. 找到 **POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV 服务**
4. 开启 **IMAP/SMTP 服务**
5. 点击 **生成授权码**
6. 按提示发送短信验证
7. 复制 16 位授权码（只显示一次，请保存好！）

## 🚀 使用方法

### 发送邮件

```bash
# 发送纯文本邮件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py send \
  -t "recipient@example.com" \
  -s "测试邮件" \
  -c "这是邮件内容"

# 发送 HTML 邮件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py send \
  -t "recipient@example.com" \
  -s "HTML 邮件" \
  -c "<h1>你好</h1>" \
  --html

# 发送带附件的邮件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py send \
  -t "recipient@example.com" \
  -s "文件附件" \
  -c "请查收" \
  -a "/path/to/file.pdf"
```

### 接收邮件

```bash
# 查看最近 10 封邮件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive

# 查看最近 20 封邮件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive --count 20

# 只查看未读邮件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive --unread
```

### 读取具体邮件

```bash
# 读取指定 UID 的邮件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py read --uid 123

# 读取并保存附件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py read --uid 123 --save

# 标记为已读
python3 ~/.openclaw/workspace/skills/...