By name: dingtalk-mail description: 钉钉邮箱。Use when 用户说 发邮件/查邮件/回邮件/转发邮件/未读邮件/邮件搜索。Distinct from dingtalk-chat(钉钉消息)、dingtalk-ding(紧急通知)。命令前缀：dws mail。 cli_version: ">=0.2.14" metadata: category: product stability: experimental requires: bins: - dws
钉钉邮箱 Skill
🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。20 个 dingtalk-* skill 全部通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（
dws skill setup --mode mono）。问题请提 issue 反馈。
PREREQUISITE: Read the
dws-sharedskill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. Thedwsbinary must be on PATH.
⚠️ 命令可用性可能因企业服务发现配置而异。本文档列出的命令基于 dws envelope schema 与本仓库 v1.0.30 实测，但部分命令的 cobra 子命令暴露与否还取决于你的企业 MCP gateway 是否注册了对应 tool。如果跑某条命令报
unknown command或 fall back 到父级 help，说明当前账号企业未开通该能力。实际调用前可用dws <cmd> --help或--dry-run验证。
命令参考：mail.md。复杂搜索、附件、批量处理、草稿等多步邮件场景参考：09-mail.md。
开放平台文档 RAG / 错误码排查
- 任何产品执行中，只要用户问开放平台 API、接口参数、字段含义、权限点、回调、SDK、配额、错误码，或命令返回上游 OpenAPI/SDK 错误，必须先用
dws devdoc article search --query "<关键词>" --format json做官方文档 RAG。 - 查询词优先保留原始 API 名、能力名、权限点、完整错误码和 message；首轮形如
errcode <code> <message>，无结果再换<产品/场景> <错误码>、<接口名> 参数。 - 本地 CLI 错误（如
unknown command/unknown flag/ 认证 / recovery）仍按 rootdws/dws-shared的错误处理执行；devdoc用于开放平台业务错误码和接口语义排查。 devdoc只查钉钉开放平台开发者文档，不查业务数据；排查结论必须基于命中条目的标题、摘要或链接，不能编造错误原因或不存在的命令。
意图表
| 用户说 | 命令 |
|---|---|
| "发邮件给 a@b.com" | dws mail message send --from <自己邮箱> --to a@b.com --subject "<标题>" --body "<正文>" |
| "今天未读邮件" | python scripts/mail_unread_summary.py |
| "带抄送发送" | python scripts/mail_send_with_cc.py --to a@b.com --cc c@d.com --subject "<标题>" --body "<正文>" |
评测高频硬约束
- 用户要"完整内容/看看这封邮件/正文"时，
message search命中后必须继续调用dws mail message get --email <邮箱> --id <messageId> --format json；不要只列候选后停下。 - 搜到多封邮件时，若用户给了明确主题、附件名、发件人或时间线索，先选最匹配的一封执行
message get；只有同等候选无法判断时才询问用户。 - 写入类操作（发送）按安全策略确认；只读查看、搜索不需要确认。
- 所有
dws mail命令加--format json，并复用同一封邮件的messageId，不要重新搜索导致目标漂移。
跨产品协作
- 收件人是人名 → 先用
dingtalk-contact取orgAuthEmail - 钉钉内消息 → 切到
dingtalk-chat