name: mail-summary
description: 获取过去 24 小时内的 Gmail 邮件，按重要性排序，以要点形式进行摘要，并为识别出的会议自动创建 Google Calendar 事件。

Email & Calendar Assistant 技能

描述

该技能读取 Gmail 邮件，按重要性对邮件进行排序，将每封邮件摘要为若干要点，并在检测到邮件中包含尚未添加至日历的会议或面试时，自动创建对应的 Google Calendar 事件。

能力

• 读取邮件（只读）
• 按重要性对邮件进行排序
• 将邮件摘要为要点列表
• 识别含会议/面试内容的邮件
• 创建 Google Calendar 事件（仅当该事件尚未存在时）
• 按需自动刷新 Google OAuth token，确保访问不中断。

安装

通过 ClawHub 安装（推荐）：

clawhub install mail-summary

手动安装：

git clone https://github.com/Russidan-Nadee/mail-summary.git ~/.openclaw/workspace/skills/mail-summary

配置说明（首次使用时需执行）

步骤 1 — 获取 Google API 凭据

1. 访问 Google Cloud Console
2. 新建一个项目（或选择已有项目）
3. 在左侧边栏中，进入 APIs & Services → 点击 Enable APIs and Services
4. 搜索并启用以下各项：
   • Gmail API
   • Google Calendar API
5. 在左侧边栏中，进入 APIs & Services → OAuth consent screen
   • 点击 Get Started
   • 填写 App name 和 User support email → 点击 Save and Continue
   • 在 Audience 下 → 点击 Add Users → 添加您的 Google 邮箱地址 → 点击 Save
6. 在左侧边栏中，进入 APIs & Services → Credentials
7. 点击 Create Credentials → OAuth client ID
8. 在 Application type 中选择 Desktop app
9. 为其命名（例如：Mail Summary）→ 点击 Create
10. 点击 Download JSON → 您将获得一个名为 client_secret_*.json 的文件

步骤 2 — 连接代理（agent）

1. 将 client_secret_*.json 文件作为附件发送给 agent
   • 通过 Telegram：在 Clawdbot 聊天窗口中以“文件”形式（非图片）发送
   • 通过 Claude Desktop：将文件拖拽至聊天窗口中
   • 通过 其他平台：以与上传任意文档相同的方式附加该文件
2. agent 将输出一条授权 URL —— 点击该链接，在浏览器中打开
3. 使用您的 Google 账户登录，并点击 Allow
4. 浏览器将跳转至一个显示错误的 localhost 页面 —— 此现象属正常
5. 复制浏览器地址栏中的完整 URL（以 http://localhost/?... 开头）
6. 将该 URL 粘贴回 agent 聊天窗口中

步骤 3 — 完成！

agent 将确认：“Auth complete. I can now access your Gmail and Google Calendar.”（认证完成，现在可访问您的 Gmail 和 Google Calendar）

此后，您只需说：“Summarize today's important emails”（摘要今日重要邮件）

配置

该技能在项目根目录下使用 config.yaml 文件进行运行时配置。您可通过编辑该文件来调整时区、重试行为及日志级别。

示例 config.yaml：

timezone: Asia/Bangkok    # 日历事件所用时区（例如：Asia/Bangkok、UTC、Asia/Tokyo）
max_retries: 5            # 认证及 API 调用的最大重试次数
log_level: INFO           # 日志级别：DEBUG、INFO、WARNING、ERROR、CRITICAL

Agent 指令

详见 agent/instructions.md 文件，其中包含完整的 agent 指令说明（支持命令、认证配置、行为逻辑等）。