在openclaw中配置gmail自动处理需五步：一、启用gmail api并获取oauth客户端id与密钥；二、通过oauth 2.0授权gmail账户并保存刷新令牌；三、设置基于多条件匹配的可视化规则；四、使用es6脚本编写自定义处理逻辑；五、通过操作日志验证执行结果并排查失败原因。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在OpenClaw中配置邮箱Skills以实现Gmail自动处理操作，则需完成授权、规则设定与触发条件绑定等关键步骤。以下是具体配置流程：
一、启用Gmail API并获取OAuth凭据
OpenClaw依赖Gmail官方API读取和操作邮件，必须通过Google Cloud Console启用该API，并创建OAuth 2.0凭据以获得客户端ID与密钥。
1、访问Google Cloud Console，选择或新建项目。
2、在左侧菜单中进入“API和服务” → “库”，搜索“Gmail API”，点击启用。
3、进入“凭据”页面，点击“创建凭据” → “OAuth客户端ID”，应用类型选择“桌面应用”。
4、记录生成的客户端ID与客户端密钥，后续将填入OpenClaw配置界面。
二、在OpenClaw中添加Gmail账户授权
系统需获得用户明确授权才能访问Gmail收件箱、标签及发送权限，授权过程基于OAuth 2.0流，不接触用户密码。
1、登录OpenClaw管理后台，进入“Skills” → “邮箱” → “添加新账户”。
2、选择“Gmail”作为服务提供商，粘贴上一步获取的客户端ID和客户端密钥。
3、点击“开始授权”，系统跳转至Google登录页；使用目标Gmail账号登录并同意所需权限范围（如查看邮件、管理标签、发送邮件）。
4、授权成功后，OpenClaw将保存刷新令牌（Refresh Token），用于长期维持访问有效性。
三、配置自动化处理规则
每条规则定义了“在什么条件下对哪些邮件执行何种动作”，支持基于发件人、主题关键词、时间范围、附件存在性等多维度匹配。
1、在已授权的Gmail账户下点击“新建规则”，输入规则名称，如“自动归档促销邮件”。
2、设置触发条件：在“匹配条件”中勾选“发件人包含”，输入“news@amazon.com”；或勾选“主题包含”，输入“订单确认”。
3、设置执行动作：从下拉菜单选择“移动到标签”，并指定目标标签为“已处理/促销”；可叠加动作，如同时勾选“标记为已读”。
4、启用规则开关，并点击“保存”。规则立即生效，无需重启服务。
四、部署自定义脚本式处理逻辑
对于无法通过可视化规则覆盖的复杂场景（如解析邮件正文中的订单号并调用外部API），OpenClaw支持嵌入JavaScript片段执行定制化操作。
1、在规则编辑页切换至“高级模式”，启用“自定义处理函数”选项。
2、在代码编辑区输入合法ES6语法脚本，例如使用message.getBody().includes("发票")判断内容，再调用claw.gmail.move(message.id, "发票归档")。
3、确保脚本中所有Gmail操作均使用OpenClaw提供的claw.gmail对象方法，不可直接调用浏览器Gmail DOM。
4、点击“测试脚本”按钮，系统将模拟一条匹配邮件运行该函数，并输出控制台日志供调试。
五、验证与日志追踪
配置完成后，系统会持续监听新邮件并按规则执行，所有动作均记录在独立审计日志中，便于定位失败原因或确认执行状态。
1、进入“Skills” → “邮箱” → 对应Gmail账户 → “操作日志”，筛选最近24小时记录。
2、查找状态为success的条目，确认message_id、action_type及target_label字段符合预期。
3、若出现failed状态，点击详情查看错误码，常见包括“invalid_grant”（刷新令牌失效）、“rateLimitExceeded”（API调用超限）。
4、对失败项可手动重试，或调整规则频率限制（如设置“每封邮件最多触发1次/分钟”）。
