安装方式
命令行安装
在项目根目录执行以下命令，完成 Skill 安装。
npx bzskills add googleworkspace/cli --skill gws-gmail-forward
skill.md
name: gws-gmail-forward
description: Gmail：将邮件转发给新收件人。
metadata:
version: 0.22.5
openclaw:
category: "productivity"
requires:
bins:
- gws
cliHelp: "gws gmail +forward --help"gmail +forward
前提条件： 阅读../gws-shared/SKILL.md了解认证、全局标志和安全规则。如果文件缺失，请运行gws generate-skills创建。
将邮件转发给新的收件人
用法
gws gmail +forward --message-id <ID> --to <EMAILS>
标志
| 标志 | 必需 | 默认值 | 描述 |
|---|---|---|---|
--message-id | ✓ | — | 要转发的 Gmail 邮件 ID |
--to | ✓ | — | 收件人电子邮件地址，多个地址用逗号分隔 |
--from | — | — | 发件人地址（用于发送别名/别名；省略则使用账户默认地址） |
--body | — | — | 可选注释，显示在转发的邮件上方（纯文本，或使用 --html 时支持 HTML） |
--no-original-attachments | — | — | 不包含原始邮件中的文件附件（--html 模式下的内嵌图片会保留） |
--attach | — | — | 附加文件（可多次指定） |
--cc | — | — | 抄送电子邮件地址，多个地址用逗号分隔 |
--bcc | — | — | 密送电子邮件地址，多个地址用逗号分隔 |
--html | — | — | 将 --body 视为 HTML 内容（默认为纯文本） |
--dry-run | — | — | 显示将要发送的请求，但不实际执行 |
--draft | — | — | 保存为草稿而不是发送 |
示例
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body '供参考，见下文'
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --cc eve@example.com
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body '<p>供参考</p>' --html
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com -a notes.pdf
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --no-original-attachments
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --draft
提示
- 会包含原始邮件及其发件人、日期、主题和收件人信息。
- 默认包含原始附件（与 Gmail 网页版行为一致）。
- 使用 --html 时，内嵌图片会通过 cid: 引用保留。
- 在纯文本模式下，不包含内嵌图片（与 Gmail 网页版行为一致）。
- 使用 --no-original-attachments 可不包含原始邮件的文件来转发。
- 使用 -a/--attach 可添加额外文件附件，可多次指定。
- 原始附件与用户添加的附件总大小限制为 25MB。
- 使用 --html 时，转发块使用 Gmail 的 gmail_quote CSS 类并保留 HTML 格式。使用片段标签（<p>、<b>、<a> 等）即可，无需 <html>/<body> 包裹。
- 使用 --draft 可将转发保存为草稿，而不是立即发送。
另请参阅
- gws-shared — 全局标志和认证
- gws-gmail — 所有发送、读取和管理邮件的命令