SuperAPI AI 工具集

add-gmail

办公与效率

查看项目

更新于 10-16 05:50

技能介绍

用途:为 BastionClaw 添加 Gmail 能力,提供两种模式。工具模式下智能体可读取和发送邮件,但仅能从 WhatsApp 触发;频道模式在工具模式基础上,还支持邮件触发智能体、安排任务和接收邮件回复,需要邮件轮询基础设施。

主要能力:通过 Gmail MCP 工具进行邮件搜索、读取、发送、创建草稿和列出标签;频道模式支持按标签、地址模式或主题前缀触发,并可按邮件线程、发件人或单一上下文组织会话。

使用方式:交互统一使用 AskUserQuestion 工具提供结构化选项。先检查 ~/.gmail-mcp/ 是否已有配置,创建配置目录,在 Google Cloud 控制台启用 Gmail API 并创建 OAuth 桌面应用凭据,保存为 gcp-oauth.keys.json 放入 ~/.gmail-mcp/,再运行 npx -y @gongrzhe/server-gmail-autoauth-mcp auth 完成授权。工具模式需在 container/agent-runner/src/index.ts 的 mcpServers 中加 gmail,在 allowedTools 加 mcp__gmail__*,挂载凭据目录到容器,更新 groups/CLAUDE.md 与 groups/main/CLAUDE.md 后依次执行 cd container && ./build.sh、npm run build、launchctl kickstart -k gui/$(id -u)/com.bastionclaw 并重启验证。频道模式在此基础上增加 EmailChannelConfig 配置、processed_emails 表、src/email-channel.ts 模块、主循环 startEmailLoop 及邮件智能体运行器等改动。

适用场景:希望在 BastionClaw 中通过 WhatsApp 或邮件自动处理 Gmail 收发、任务调度与回复的场景。

限制:需用户自行提供 Google Cloud OAuth 凭据并完成浏览器授权;个人 OAuth 应用可能显示未验证警告;频道模式的轮询实现依赖自行选择的调用方式,资料中相关函数为占位实现。