Gmail Local — Gmail 本地化
v1.0.0使用Google App Password实现本地Gmail IMAP/SMTP访问。当用户想要搜索、阅读或发送Gmail邮件而不通过Maton或其他第三方服务时使用。
运行时依赖
安装命令
点击复制技能文档
使用本地Gmail 直接使用Gmail IMAP/SMTP和Google App Password。该技能不使用Maton或任何第三方代理。信任边界邮件直接在此主机和Google Gmail服务器之间传递: IMAP:imap.gmail.com:993 SMTP:smtp.gmail.com:465 这些端点在helper中固定,不可通过环境变量配置。凭据保持本地,必须通过以下方式提供: GMAIL_ADDRESS GMAIL_APP_PASSWORD_FILE 永远不要打印、记录、提交或回显应用密码。不要直接将其作为环境变量传递。应用密码需要Google 2-Step Verification,可能对某些账户、Workspace策略或高级保护账户不可用。必须在Gmail设置中启用IMAP。
命令 本地helper位于此技能文件夹下:scripts/gmail_local.py 列出最近的收件箱消息:python3 scripts/gmail_local.py list --limit 10 使用IMAP查询进行搜索:python3 scripts/gmail_local.py search --query 'UNSEEN' python3 scripts/gmail_local.py search --query 'FROM "person@example.com"' 按UID读取消息:python3 scripts/gmail_local.py read --uid 12345 仅在显式批准后发送邮件:python3 scripts/gmail_local.py send \ --to person@example.com \ --subject "主题" \ --body "消息正文" \ --confirm-send
安全规则 在发送前,显示收件人、抄送、密送、主题和正文预览,然后获取用户的显式批准。helper拒绝发送,除非提供--confirm-send并获得批准。不要使用此技能进行群发邮件、垃圾邮件、抓取联系人或发送敏感数据而不进行确认。优先使用只读命令(list、search、read),除非用户明确要求发送。如果发生身份验证错误,请不要反复重试;请用户检查IMAP设置并在需要时轮换应用密码。
设置 在以下位置创建Google应用密码:https://myaccount.google.com/apppasswords 将其存储在本地0600文件中:install -m 600 /dev/null ~/.openclaw/gmail-app-password nano ~/.openclaw/gmail-app-password 然后为网关服务设置本地环境。示例: openclaw config set env.vars.GMAIL_ADDRESS you@gmail.com openclaw config set env.vars.GMAIL_APP_PASSWORD_FILE ~/.openclaw/gmail-app-password openclaw gateway restart