gmail

name	gmail
description	[暂不可用] Gmail 邮件集成。收发邮件、搜索邮件、管理标签。通过 MorphixAI 代理安全访问 Gmail API。
metadata	{"openclaw":{"emoji":"📬","requires":{"env":["MORPHIXAI_API_KEY"]}}}

Gmail 邮件（暂不可用）

状态：暂不可用 — Gmail 账号尚未链接，该工具暂时不可使用。如需启用，请通过 mx_link 工具链接 Gmail 账号（app: gmail）。

通过 mx_gmail 工具管理 Gmail 邮箱：读取、搜索、发送邮件，管理标签。

前置条件

1. 安装插件: openclaw plugins install openclaw-morphixai
2. 获取 API Key: 访问 morphix.app/api-keys 生成 mk_xxxxxx 密钥
3. 配置环境变量: export MORPHIXAI_API_KEY="mk_your_key_here"
4. 链接账号: 访问 morphix.app/connections 链接 Gmail 账号，或通过 mx_link 工具链接（app: gmail）

核心操作

查看用户信息

mx_gmail:
  action: get_profile

列出邮件

mx_gmail:
  action: list_messages
  max_results: 10

list_messages 只返回邮件 ID 列表，需用 get_message 获取完整内容。

查看邮件详情

mx_gmail:
  action: get_message
  message_id: "18dxxxxxxxx"

搜索邮件

mx_gmail:
  action: search_messages
  query: "from:[e-mail] subject:周报"
  max_results: 5

Gmail 搜索语法支持：

• from: / to: — 发件人/收件人
• subject: — 主题
• is:unread / is:starred — 未读/星标
• newer_than:7d / older_than:30d — 时间范围
• has:attachment — 有附件
• label: — 标签

发送邮件

mx_gmail:
  action: send_mail
  to: "[e-mail]"
  subject: "项目更新"
  body: "Hi，项目进展如下：\n1. 完成了 API 开发\n2. 正在编写测试"
  cc: "[e-mail]"

列出标签

mx_gmail:
  action: list_labels

标记已读

mx_gmail:
  action: mark_as_read
  message_id: "18dxxxxxxxx"

删除邮件（移入回收站）

mx_gmail:
  action: trash_message
  message_id: "18dxxxxxxxx"

常见工作流

查看未读邮件

1. mx_gmail: list_messages, q: "is:unread", max_results: 5
2. mx_gmail: get_message, message_id: "xxx"  → 逐条查看
3. mx_gmail: mark_as_read, message_id: "xxx"  → 标记已读

搜索并回复（通过发送新邮件）

1. mx_gmail: search_messages, query: "from:[e-mail]"
2. mx_gmail: get_message → 查看内容
3. mx_gmail: send_mail, to: "[e-mail]", subject: "Re: xxx"

注意事项

• list_messages 返回的是邮件 ID 列表，需用 get_message 获取完整内容
• 发送邮件内容为纯文本格式
• Gmail 搜索语法功能强大，建议充分利用
• account_id 参数通常省略，工具自动检测已链接的 Gmail 账号

---

文档与源码：GitHub