用途：为 GhostClaw 智能体接入 Gmail MCP 服务器，让机器人可读取、搜索、发送和管理邮件。该功能为可选，非 GhostClaw 核心能力，但可用于读取验证码、检查紧急邮件、发送摘要或标记待处理事项。
主要能力：启用后智能体获得以下 MCP 工具——search_emails（按 Gmail 查询语法搜索）、read_email（按 ID 读取）、send_email（发送）、draft_email（创建草稿）、modify_email（移动/标记）、list_email_labels（列出标签）、create_filter（创建收件箱过滤器）、download_attachment（下载附件）。
使用方式：1) 在 Google Cloud Console 创建项目并启用 Gmail API，创建 OAuth 2.0 凭据（桌面应用类型），下载凭据 JSON；2) 运行 npx @gongrzhe/server-gmail-autoauth-mcp 并完成浏览器 OAuth 流程，凭据生成在 ~/.gmail-mcp/；3) 在 .env 添加 GMAIL_MCP_ENABLED=1；4) 重新构建并重启：cd agent-runner && npx tsc，随后 macOS 执行 launchctl kickstart -k gui/$(id -u)/com.ghostclaw，或 Linux 执行 systemctl --user restart ghostclaw；5) 向机器人发送消息“Check my recent emails”测试。
原理与替换：agent-runner/src/index.ts 在 GMAIL_MCP_ENABLED=1 时条件性加入 Gmail MCP 服务器，该服务器作为智能体子进程运行并继承 HOME 以发现 OAuth 凭据。还可换用 Outlook/365（Microsoft Graph MCP）、任意 IMAP（通用 IMAP MCP）、Proton Mail（Bridge + IMAP MCP）；切换方式为编辑 agent-runner/src/index.ts 中 gmail 配置块的 MCP 服务器命令，其余接线不变。
限制：Gmail 路线需一次性 Google Cloud 配置，难度中等；其他提供商配置难度各异。禁用时移除 .env 中的 GMAIL_MCP_ENABLED=1 并重启即可。资料未提供价格、性能等更多细节。