安装方式
命令行安装
在项目根目录执行以下命令，完成 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 | — | — | CC 电子邮件地址，逗号分隔 |
--bcc | — | — | 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 'FYI 见下文'
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>FYI</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 — 所有发送、读取和管理邮件的命令