Mailly文档

给 OpenClaw 一个专属邮箱

通过 Remote MCP 和 OAuth 把 OpenClaw 连接到 Mailly 邮箱，让你的助手读信、保存回复草稿，并在你确认后发送。

OpenClaw 可以直接处理一个真实邮箱：搜索会话、读取来信、保存回复草稿，并在你确认最终正文后发送。Mailly 给它一个 your-name@mailly.site 这样的地址，通过 Remote MCP 连接，配置保存在 OpenClaw 配置的 mcp.servers 下。

你会得到

  • 一个可收可发的 @mailly.site 邮箱；Developer 套餐还可以使用自己的域名。
  • 约 70 个类型明确的 MCP 工具，覆盖会话、草稿、发信、域名、联系人、模板、Campaign 和 Workflow，并受你授予的授权范围限制。
  • 发信由你把关：OpenClaw 会展示确切的正文和收件人，Mailly 在你确认后才发送。

开通邮箱

已有 Mailly 账户可跳过这一步。

把下面的提示词发给你的 OpenClaw 助手。它会读取 Mailly 的开通说明，询问你想要的名称，通过 HTTP 预留，再把验证链接交给你。

Prompt
Read https://mailly.site/auth.md
and set up a Mailly inbox for me over HTTP.
Ask me for the name if unknown; if taken, ask for another,
with no blind retries.
Send me the verification link.
After I confirm the inbox in my browser,
store the API key securely, tell me the address,
and ask me before sending any email.

打开链接，用你自己已验证的邮箱登录或注册，然后确认这个邮箱。之后 OpenClaw 会拿到邮箱地址和你账户的 API Key。也可以直接在 mailly.site/onboard 开始。规则见让 Agent 帮你开通邮箱。

添加 Mailly MCP 服务器

openclaw mcp add mailly \
  --url https://mcp.mailly.site/mcp \
  --transport streamable-http \
  --auth oauth

请显式指定传输方式：省略时 OpenClaw 使用 SSE。也可以在 Control UI 的 Settings → MCP 中添加（Configured servers → Add server，传输方式选 Streamable HTTP），或者用 JSON 保存定义：

openclaw mcp set mailly '{"url":"https://mcp.mailly.site/mcp","transport":"streamable-http","auth":"oauth"}'

登录并选择授权范围

openclaw mcp login mailly

打开命令打印的授权链接并登录 Mailly。OpenClaw 通常会捕获本地回环回调并自动保存凭据；如果浏览器访问不到回调监听（例如在远程主机上），运行 OpenClaw 打印的 --code 命令。在 Mailly 授权页上决定 OpenClaw 能做什么：

授权范围OpenClaw 可以
mail:read读取邮箱、会话、已发邮件、草稿和设置。始终授予。
mail:draft保存、修改、放弃回复草稿；不能发送。
mail:send发送你审核过的回复、转发和新邮件。
workspace:manage管理地址、域名、模板、联系人、Campaign、Workflow 和 Webhook。

已经在运行的 Gateway 可能需要重新加载或重启才会使用新服务器；开启 Gateway 热重载时，下一轮对话就会生效。

改用 API Key

无法使用 OAuth 时，去掉 auth，在请求头里引用环境变量来发送 Mailly API Key。auth 为 oauth 时，OpenClaw 会忽略静态的 Authorization 请求头。

openclaw mcp set mailly '{"url":"https://mcp.mailly.site/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${MAILLY_API_KEY}"}}'

API Key 拥有完整的账户权限，不受授权范围限制。请放在环境变量里，不要贴进聊天或写成配置里的明文。在工作台的接入页查看。

验证连接

  1. 运行 openclaw mcp doctor mailly --probe。它会校验保存的定义，建立实时连接并列出 Mailly 的工具。openclaw mcp status --verbose 只汇总已保存的配置，不建立连接。
  2. 对助手说：“用 Mailly 列出我的邮箱地址和最近 5 个会话。” 它应调用 mailly_list_inbox_addresses 和 mailly_list_threads。
  3. 用你的个人邮箱给 Mailly 地址发一封邮件，然后说：“读取我在 Mailly 的最新会话并保存一份回复草稿，给我看确切正文，先不要发送。” OpenClaw 会调用 mailly_read_thread 和 mailly_save_draft。在对话中批准或放弃这份草稿。

如果只想让 OpenClaw 读信和起草，不要授予 mail:send。也可以在 OpenClaw 一侧隐藏工具，例如 openclaw mcp tools mailly --exclude 'mailly_send_email,mailly_approve_draft,mailly_forward_message'。

改用 CLI

OpenClaw 也可以通过 shell 工具运行 mailly-cli。所有命令都支持 --json。

npm install -g mailly-cli   # Node.js 18+
mailly login --no-browser   # 打印登录链接
mailly inbox addresses list --json
mailly inbox threads list --json

常见问题

  • openclaw mcp status 显示 authorization-required：重新运行 openclaw mcp login mailly。
  • 登录卡住或令牌已轮换：先运行 openclaw mcp logout mailly，再运行 openclaw mcp login mailly。logout 会保留已保存的服务器定义。
  • 探测连接失败：确认 transport 为 streamable-http，否则 OpenClaw 会尝试 SSE。
  • 缺少某个工具：它需要你没有授予的权限，或者被 openclaw mcp tools 过滤掉了。退出后重新登录并勾选该权限。Mailly 不会自动扩大已有授权。
  • 收不到邮件：在工作台确认地址，并查看收件箱的垃圾邮件文件夹。

Gemini CLI

通过 Remote MCP 和 OAuth 把 Gemini CLI 连接到 Mailly 邮箱，让它读信、保存回复草稿，并在你确认后发送。

自定义域名

用自己的域名收发邮件。

本页内容

你会得到开通邮箱添加 Mailly MCP 服务器登录并选择授权范围改用 API Key验证连接改用 CLI常见问题