Zoho邮件集成

技能简介

Zoho Email Integration 是一套完整的 Zoho Mail 集成方案，支持 OAuth2 认证与 REST API 后端，操作速度比传统 IMAP/SMTP 快 5-10 倍。该技能内置 Clawdbot 扩展，可通过 /email 命令在 Telegram/Discord 中直接管理邮件，同时提供 HTML 邮件、附件传输、批量操作等高级功能。

业务背景

Zoho邮件集成帮助业务人员高效处理日常邮件事务。通过OAuth2安全认证和REST API技术，大幅提升邮件操作速度；支持在Telegram、Discord等聊天工具中直接管理邮件，无需切换应用；同时具备批量处理、干运行预览等功能，降低误操作风险，让团队协作更顺畅。

落地案例：销售团队每日需处理大量客户询盘邮件。使用本技能后，成员可在Slack或企业微信中输入/email命令，快速查看未读邮件数量、搜索特定客户往来记录，或直接发送带产品资料的HTML邮件。批量标记已跟进询盘、清理过期邮件等重复工作也可一键完成，减少在不同系统间来回切换的时间损耗。

能做什么

• 通过 OAuth2 或应用密码两种方式完成身份验证
• 使用 REST API 快速读取、搜索、发送邮件，自动回退至 IMAP
• 发送富文本 HTML 邮件并附带文件附件
• 批量标记、删除、移动邮件，支持干运行模式预览操作
• 实时监控收件箱未读数量，对接通知系统
• 通过 Clawdbot 扩展在聊天机器人中执行邮件指令

使用说明

安装指令：

clawdhub install zoho-email
pip3 install requests

前置要求：Python 3.x、Zoho Mail 账户

配置步骤：

1. 登录 Zoho Mail，进入「设置 → 安全 → 应用密码」，生成专用应用密码（勿用主密码）
2. 设置环境变量：

   export ZOHO_EMAIL="your-email@domain.com"
   export ZOHO_PASSWORD="your-app-specific-password"

3. 测试连接：

   python3 scripts/zoho-email.py unread

常用命令：

• 诊断配置：python3 scripts/zoho-email.py doctor
• 未读统计：python3 scripts/zoho-email.py unread
• 搜索邮件：python3 scripts/zoho-email.py search "invoice"
• 发送邮件：python3 scripts/zoho-email.py send recipient@example.com "主题" "正文"
• 清空垃圾邮件（默认干运行）：python3 scripts/zoho-email.py empty-spam --execute 执行实际操作

输入与输出

见下方输入与输出表格。

风险提示

• v2.2.5 以下版本存在命令注入漏洞，若曾部署 email-command.js 示例文件，须立即强制更新
• 切勿将主密码硬编码，务必使用应用密码或 OAuth2 令牌
• 批量删除操作默认开启干运行模式，确认无误后再附加 –execute 执行
• 凭证文件建议设置 600 权限，避免其他用户读取

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/briansmith80/zoho-email-integration/SKILL.md
来源类型：GitHub 仓库