安装方式
命令行安装
在项目根目录执行以下命令，完成 Skill 安装。
npx bzskills add googleworkspace/cli --skill gws-gmail-send
skill.md
name: gws-gmail-send
description: 'Gmail: 发送电子邮件。'
metadata:
version: 0.22.5
openclaw:
category: "productivity"
requires:
bins:
- gws
cliHelp: "gws gmail +send --help"gmail +send
先决条件： 请阅读../gws-shared/SKILL.md了解认证、全局标志和安全规则。如果该文件缺失，请运行gws generate-skills创建。
发送一封电子邮件
使用方法
gws gmail +send --to <EMAILS> --subject <SUBJECT> --body <TEXT>
标志
| 标志 | 必须 | 默认值 | 描述 |
|---|---|---|---|
--to | ✓ | — | 收件人电子邮件地址，以逗号分隔 |
--subject | ✓ | — | 邮件主题 |
--body | ✓ | — | 邮件正文（纯文本，若使用 --html 则为 HTML） |
--from | — | — | 发件人地址（用于“以其他身份发送”/别名；省略则使用账户默认地址） |
--attach | — | — | 附件文件（可多次指定） |
--cc | — | — | 抄送电子邮件地址，以逗号分隔 |
--bcc | — | — | 密送电子邮件地址，以逗号分隔 |
--html | — | — | 将 --body 视为 HTML 内容（默认为纯文本） |
--dry-run | — | — | 显示将要发送的请求，但不实际执行 |
--draft | — | — | 保存为草稿而不实际发送 |
示例
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi Alice!'
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --cc bob@example.com
gws gmail +send --to alice@example.com --subject 'Hello' --body '<b>Bold</b> text' --html
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --from alias@example.com
gws gmail +send --to alice@example.com --subject 'Report' --body 'See attached' -a report.pdf
gws gmail +send --to alice@example.com --subject 'Files' --body 'Two files' -a a.pdf -a b.csv
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --draft
提示
- 自动处理 RFC 5322 格式、MIME 编码和 base64。
- 使用 --from 从已配置的“以其他身份发送”别名发送，而非你的主地址。
- 使用 -a/--attach 添加文件附件。可以多次指定。总大小限制：25MB。
- 使用 --html 时，请使用片段标签（<p>、<b>、<a>、<br> 等）——无需包裹 <html>/<body>。
- 使用 --draft 可将邮件保存为草稿，而非立即发送。
[!CAUTION]
这是一个写入命令——执行前请与用户确认。
另请参阅
- gws-shared——全局标志和认证
- gws-gmail——所有发送、读取和管理电子邮件的命令