安装方式
命令行安装
在项目根目录执行以下命令，完成 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 — 所有发送、读取和管理邮件的命令