What makes Emailbox notable?

1.1K downloads. Trust evidence available

How should Emailbox be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Emailbox

职业邮箱收发与数据处理一体化工具。IMAP/SMTP protocol for 12+ providers (Gmail/Outlook/QQ/163/Yahoo/iCloud etc). Send/receive/search/schedule emails, HTML templates, attachmen...

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.1k

Updated

Oct 11, 2026

Version

1.2.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.2.1release · observed Jul 3, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s174rz3f0862tcfw7pzfh5w8kn83hv2z:emailbox

Install using `clawhub skill install s174rz3f0862tcfw7pzfh5w8kn83hv2z:emailbox` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/tobewin/emailbox before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-tobewin-emailbox/snapshot"

Documentation

CLAWHUB

143,598 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: emailbox
description: 职业邮箱收发与数据处理一体化工具。IMAP/SMTP protocol for 12+ providers (Gmail/Outlook/QQ/163/Yahoo/iCloud etc). Send/receive/search/schedule emails, HTML templates, attachments, forwarding, data integration. 邮件收发、搜索、定时发送、附件、HTML模板、转发、文档数据联动。
version: 1.2.0
license: MIT-0
metadata: {"openclaw": {"emoji": "📬", "requires": {"bins": ["python3"], "env": ["EMAIL_ADDRESS", "EMAIL_AUTH"]}, "primaryEnv": "EMAIL_AUTH"}}
---

# Emailbox - Professional Email Client & Data Integration

IMAP/SMTP-based email toolkit supporting 12+ providers. Send, receive, search, forward, schedule emails with HTML templates, attachments, and document data integration.

> ⚠️ **数据外发提醒**：邮件内容（收件人、主题、正文、附件）通过 IMAP/SMTP 协议直接发送至邮件服务商服务器。涉及发票、合同、简历等敏感数据时，请在发送前确认收件人正确。
>
> ⚠️ **凭据安全**：邮箱授权码等同于密码。环境变量可能通过 shell history、进程列表、CI 日志泄露。每次使用完后建议 `unset EMAIL_AUTH`。

## Features

- **Send**: Plain text, HTML, attachments, CC/BCC, reply, forward
- **Receive**: List inbox, read emails, download attachments
- **Search**: By keyword (subject/from/body), date range, sender
- **Forward**: Fetch original email, forward to new recipients
- **Schedule**: Send emails at a future time
- **Templates**: 7 professional HTML email templates
- **Integration**: Excel/OCR/PDF data → format → email
- **Providers**: QQ, 163, 126, Sina, Outlook, Gmail, Yahoo, iCloud, Tencent Exmail, Ali Mail, Huawei, 139

## Trigger

- "Send email to..." / "发邮件给..."
- "Check inbox" / "查看收件箱"
- "Reply to this email" / "回复这封邮件"
- "Forward this email" / "转发这封邮件"
- "Search emails from..." / "搜索...的邮件"
- "Schedule email for..." / "定时发送..."
- "Process data and email..." / "整理数据后发邮件"
- "Attach this file..." / "添加附件..."

---

## Step 0: Setup

### Quick Start (Single Account)

```bash
# Set 2 environment variables and you're ready
export EMAIL_ADDRESS="[email protected]"
export EMAIL_AUTH="your_authorization_code"
```

> ⚠️ `export` 设置的变量在当前 shell 及所有子进程可见（包括 ps 命令、CI 日志、崩溃报告）。
> 用完建议 `unset EMAIL_AUTH`，或使用 `.env` 文件 + `source` 替代一次性 export。

### Multi-Account Setup

```bash
# QQ Mail
export EMAIL_QQ="[email protected]"
export EMAIL_QQ_AUTH="qq_auth_code"

# 163 Mail
export EMAIL_163="[email protected]"
export EMAIL_163_AUTH="163_client_password"

# Gmail
export EMAIL_GMAIL="[email protected]"
export EMAIL_GMAIL_AUTH="gmail_app_password"
```

### Provider Auth Guide

How to get authorization codes for each provider → `references/providers.md`

> ⚠️ 授权码等同于邮箱密码，拥有它可以收发你的所有邮件。不要分享给他人，不要在公共终端设置。

### Persistent Config

**IMPORTANT: Never store email credentials in plaintext files.** Use your system's secure credential manager or session-only environment variables.

```bash
# Option A: Session-only (recommended for security)
# Set environment variables in your current shell session only.
# Credentials will NOT persist after the session ends.
export EMAIL_ADDRESS="[email protected]"
export EMAIL_AUTH="your_auth_code"

# Option B: Keychain / secret manager
# macOS: Use `security add-internet-password`
# Linux: Use `secret-tool store` (libsecret)
# Wind

_meta.json

{
  "ownerId": "kn75z6gevjsyrznm7dg2ez6sen82h8sz",
  "slug": "emailbox",
  "version": "1.2.1",
  "publishedAt": 1783070522027
}

references/integrations.md

# 文档数据联动 Document Integration

邮件与文档数据处理的一体化工作流。结合其他 Skills 的能力，实现"数据处理 → 格式化 → 邮件发送"的自动化。

> ⚠️ 以下工作流涉及发票、合同、简历等敏感数据的邮件发送。
> 执行前务必确认收件人地址正确，且用户确实授权发送这些数据。

---

## 场景总览

| 场景 | 数据来源 | 邮件输出 | 关联 Skill |
|------|----------|----------|-----------|
| Excel 报表发送 | .xlsx/.csv 数据 | HTML 表格 + 附件 | excel-studio |
| 发票识别+邮件 | 图片/PDF 发票 | 结构化摘要 + 附件 | china-doc-ocr |
| 合同审核+邮件 | 合同 PDF | 审核要点 + 附件 | china-doc-ocr, china-legal-analysis |
| PDF 报告发送 | PDF 文件 | 摘要 + 附件 | pdf-studio |
| 简历解析+邮件 | 简历 PDF/Word | 候选人摘要 + 附件 | china-doc-ocr |
| 数据分析+邮件 | 原始数据 | 分析结论 + 图表 | data-analyzer |

---

## 工作流模板

### 流程 1：Excel 数据 → 格式化邮件

```
用户请求："把这个 Excel 的销售数据做成表格发邮件给老板"
↓
Step 1: 读取 Excel 文件
  → 使用 excel-studio 读取数据
  → 或使用 python3 + openpyxl 直接读取
↓
Step 2: 数据处理与格式化
  → 提取关键指标（总计、变化、排名等）
  → 生成 HTML 表格（使用 templates.md 中商务报告模板）
  → 生成纯文本摘要（作为 fallback）
↓
Step 3: 生成邮件内容并保存
  → 将 HTML 保存为 ${OPENCLAW_WORKSPACE}/.emailbox_body.html
  → 将纯文本保存为 ${OPENCLAW_WORKSPACE}/.emailbox_body.txt
↓
Step 4: 发送邮件
  python3 scripts/send_mail.py \
    --to [email protected] \
    --subject "销售数据周报 - $(date +%Y%m%d)" \
    --body-file "${OPENCLAW_WORKSPACE}/.emailbox_body.txt" \
    --html-file "${OPENCLAW_WORKSPACE}/.emailbox_body.html" \
    --attach /path/to/sales_data.xlsx \
    --provider qq
```

### 流程 2：OCR 识别 → 邮件通知

> ⚠️ 本流程将发送发票金额、号码、购方/销方信息等财务数据。发送前确认收件人是正确的财务负责人邮箱。

```
用户请求："识别这张发票，把结果发邮件给财务"
↓
Step 1: OCR 识别
  → 使用 china-doc-ocr 识别发票图片/PDF
  → 提取关键字段：发票号码、金额、日期、购方/销方信息
↓
Step 2: 格式化邮件内容
  → 使用 templates.md 中的发票通知模板
  → 填入识别出的字段数据
  → 生成纯文本摘要
↓
Step 3: 发送邮件
  python3 scripts/send_mail.py \
    --to [email protected] \
    --subject "发票处理 - ${invoice_number}" \
    --body-file "${OPENCLAW_WORKSPACE}/.emailbox_body.txt" \
    --html-file "${OPENCLAW_WORKSPACE}/.emailbox_body.html" \
    --attach /path/to/invoice.jpg \
    --provider 163
```

### 流程 3：合同审核 → 邮件汇报

> ⚠️ 合同内容、法务分析、风险点属于高度敏感信息。发送前向用户确认收件人（法务邮箱）无误，且用户清楚邮件包含合同原文及审核意见。

```
用户请求："审核这份合同后把要点发邮件给法务"
↓
Step 1: 识别合同
  → 使用 china-doc-ocr 识别合同文本
↓
Step 2: 法律分析
  → 使用 china-legal-analysis 分析合同条款
  → 提取风险点和审核意见
↓
Step 3: 格式化并发送
  python3 scripts/send_mail.py \
    --to [email protected] \
    --subject "合同审核报告 - ${contract_name}" \
    --body-file "${OPENCLAW_WORKSPACE}/.emailbox_body.txt" \
    --html-file "${OPENCLAW_WORKSPACE}/.emailbox_body.html" \
    --attach /path/to/contract.pdf \
    --importance high \
    --provider qq
```

### 流程 4：简历解析 → 转发 HR

> ⚠️ 简历包含姓名、学历、工作经历等个人敏感信息（PII）。发送前确认用户有权转发该简历，且收件人（HR 邮箱）正确。

```
用户请求："解析这份简历然后转发给HR"
↓
Step 1: 识别简历
  → 使用 china-doc-ocr 识别简历 PDF/图片
↓
Step 2: 结构化提取
  → 提取姓名、学历、工作经验、技能等
  → 生成候选人摘要卡片
↓
Step 3: 转发邮件
  python3 scripts/send_mail.py \
    --to [email protected] \
    --subject "候选人推荐 - ${candidate_name} - ${position}" \
    --body-file "${OPENCLAW_WORKSPACE}/.emailbox_body.txt" \
    --html-file "${OPENCLAW_WORKSPACE}/.emailbox_body.html" \
    --attach /path/to/resume.pdf
```

### 流程 5：数据分析 → 邮件报告

```
用户请求："分析这份数据后发邮件给团队"
↓
Step 1: 读取和数据
  → 使用 data-analyzer 或 python3 分析 CS

references/providers.md

# 邮箱服务商配置 Email Provider Configuration

## 12+ 服务商 IMAP/SMTP 配置

| 服务商 | IMAP 服务器 | SMTP 服务器 | SMTP 端口 | SSL | 环境变量 |
|--------|-------------|-------------|----------|-----|----------|
| QQ 邮箱 | imap.qq.com | smtp.qq.com | 465 | SSL | EMAIL_QQ / EMAIL_QQ_AUTH |
| 163 邮箱 | imap.163.com | smtp.163.com | 465 | SSL | EMAIL_163 / EMAIL_163_AUTH |
| 126 邮箱 | imap.126.com | smtp.126.com | 465 | SSL | EMAIL_126 / EMAIL_126_AUTH |
| 新浪邮箱 | imap.sina.com | smtp.sina.com | 465 | SSL | EMAIL_SINA / EMAIL_SINA_AUTH |
| Outlook | outlook.office365.com | smtp.office365.com | 587 | STARTTLS | EMAIL_OUTLOOK / EMAIL_OUTLOOK_AUTH |
| Gmail | imap.gmail.com | smtp.gmail.com | 587 | STARTTLS | EMAIL_GMAIL / EMAIL_GMAIL_AUTH |
| Yahoo | imap.mail.yahoo.com | smtp.mail.yahoo.com | 587 | STARTTLS | EMAIL_YAHOO / EMAIL_YAHOO_AUTH |
| iCloud | imap.mail.me.com | smtp.mail.me.com | 587 | STARTTLS | EMAIL_ICLOUD / EMAIL_ICLOUD_AUTH |
| 腾讯企业邮箱 | imap.exmail.qq.com | smtp.exmail.qq.com | 465 | SSL | EMAIL_EXMAIL / EMAIL_EXMAIL_AUTH |
| 阿里企业邮箱 | imap.mxhichina.com | smtp.mxhichina.com | 465 | SSL | EMAIL_ALIMAIL / EMAIL_ALIMAIL_AUTH |
| 华为邮箱 | imap.mail.hicloud.com | smtp.mail.hicloud.com | 465 | SSL | EMAIL_HUAWEI / EMAIL_HUAWEI_AUTH |
| 139 邮箱 | imap.mail.139.com | smtp.mail.139.com | 465 | SSL | EMAIL_139 / EMAIL_139_AUTH |

---

## 环境变量配置

### 单账号模式（推荐新手）

最简配置，只需 2 个环境变量：

```bash
export EMAIL_ADDRESS="[email protected]"
export EMAIL_AUTH="your_authorization_code"
```

### 多账号模式（支持多个邮箱）

每个邮箱单独配置：

```bash
# QQ 邮箱
export EMAIL_QQ="[email protected]"
export EMAIL_QQ_AUTH="qq_authorization_code"

# 163 邮箱
export EMAIL_163="[email protected]"
export EMAIL_163_AUTH="163_client_password"

# Outlook
export EMAIL_OUTLOOK="[email protected]"
export EMAIL_OUTLOOK_AUTH="outlook_app_password"

# Gmail
export EMAIL_GMAIL="[email protected]"
export EMAIL_GMAIL_AUTH="gmail_app_password"
```

### 优先级规则

1. 命令行指定 `--from-addr` 和 `--provider` 最高优先
2. 对应服务商的环境变量（如 `EMAIL_QQ` / `EMAIL_QQ_AUTH`）
3. 通用环境变量 `EMAIL_ADDRESS` / `EMAIL_AUTH`

---

## Authorization Code Setup / 授权码获取教程

### QQ Mail / QQ 邮箱

1. Log in to QQ Mail (mail.qq.com) → Settings (设置) → Account (账号)
2. Find "POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV Service"
3. Enable IMAP/SMTP service
4. Click "Generate Authorization Code" (生成授权码)
5. Follow prompts to send SMS verification from your phone
6. Receive 16-character authorization code (no spaces)

```bash
export EMAIL_QQ="[email protected]"
export EMAIL_QQ_AUTH="abcdefghijklmnop"
```

**Note:** QQ Mail authorization code is 16 letters, NOT your QQ password.

### 163 Mail / 163 邮箱

1. Log in to 163 Mail (mail.163.com) → Settings (设置) → POP3/SMTP/IMAP
2. Enable "IMAP/SMTP Service"
3. Click "Client Authorization Password" (客户端授权密码)
4. Verify via SMS, then set the authorization password

```bash
export EMAIL_163="[email protected]"
export EMAIL_163_AUTH="your_client_password"
```

**Note:** 163 Mail requires authorization password, NOT your login password.

### 126 Mail / 126 邮箱

1. Log in to 126 Mail (mail.126.co

references/templates.md

# HTML 邮件模板 HTML Email Templates

专业邮件 HTML 模板，支持中英文场景。使用时将占位符 `{变量名}` 替换为实际内容。

---

## 1. 商务报告模板 Business Report

```html
<!DOCTYPE html>
<html>
<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"></head>
<body style="margin:0;padding:0;background:#f5f5f5;font-family:'Helvetica Neue',Arial,'PingFang SC','Microsoft YaHei',sans-serif;">
<table width="100%" cellpadding="0" cellspacing="0" style="background:#f5f5f5;padding:20px 0;">
<tr><td align="center">
<table width="600" cellpadding="0" cellspacing="0" style="background:#ffffff;border-radius:8px;overflow:hidden;box-shadow:0 2px 8px rgba(0,0,0,0.08);">
<tr><td style="background:linear-gradient(135deg,#1a5276,#2e86c1);padding:30px 40px;color:#ffffff;">
<h1 style="margin:0;font-size:22px;">{report_title}</h1>
<p style="margin:8px 0 0;font-size:14px;opacity:0.9;">{report_period} | {report_date}</p>
</td></tr>
<tr><td style="padding:30px 40px;">
<p style="margin:0 0 20px;font-size:15px;color:#333;">{greeting}，</p>
<p style="margin:0 0 20px;font-size:14px;color:#555;line-height:1.8;">{summary}</p>
<table width="100%" cellpadding="0" cellspacing="0" style="border-collapse:collapse;margin:20px 0;">
<thead><tr style="background:#eaf2f8;">
<th style="padding:12px 16px;text-align:left;font-size:13px;color:#1a5276;border-bottom:2px solid #2e86c1;">{col1_header}</th>
<th style="padding:12px 16px;text-align:right;font-size:13px;color:#1a5276;border-bottom:2px solid #2e86c1;">{col2_header}</th>
<th style="padding:12px 16px;text-align:right;font-size:13px;color:#1a5276;border-bottom:2px solid #2e86c1;">{col3_header}</th>
<th style="padding:12px 16px;text-align:right;font-size:13px;color:#1a5276;border-bottom:2px solid #2e86c1;">{col4_header}</th>
</tr></thead>
<tbody>
{table_rows}
</tbody>
</table>
<p style="margin:20px 0 0;font-size:14px;color:#555;line-height:1.8;">{detail_text}</p>
</td></tr>
<tr><td style="background:#f9f9f9;padding:20px 40px;border-top:1px solid #eee;font-size:12px;color:#999;text-align:center;">
{sender_name} | {sender_department}<br>
此邮件由 emailbox 自动发送
</td></tr>
</table>
</td></tr>
</table>
</body>
</html>
```

**表格行模板：**
```html
<tr style="border-bottom:1px solid #eee;">
<td style="padding:10px 16px;font-size:14px;color:#333;">{col1_value}</td>
<td style="padding:10px 16px;text-align:right;font-size:14px;color:#555;">{col2_value}</td>
<td style="padding:10px 16px;text-align:right;font-size:14px;color:#555;">{col3_value}</td>
<td style="padding:10px 16px;text-align:right;font-size:14px;font-weight:bold;color:{positive_color};">{col4_value}</td>
</tr>
```

---

## 2. 会议邀请模板 Meeting Invitation

```html
<!DOCTYPE html>
<html>
<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"></head>
<body style="margin:0;padding:0;background:#f5f5f5;font-family:'Helvetica Neue',Arial,'PingFang SC','Microsoft YaHei',sans-serif;">
<table width="100%" cellpadding="0" cellspacing="0" style="background:#f5f5f5;padding:20px

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.