Set up Gmail integration for email management

方案 2 的落地步骤（我们就按这个来）

我会在这台 Clawdbot 服务器上做：

1. 写一个脚本：拉取 Gmail 未读邮件（From/Subject/时间/正文摘要/链接）
2. 设置定时：每 X 分钟检查一次
3. 把摘要推送给你（Telegram）
你需要做的 2 件事

A. 创建 Google OAuth 客户端

1. 打开 Google Cloud Console → 创建项目
2. APIs & Services → Enable APIs → 启用 Gmail API
3. Credentials → Create Credentials → OAuth client ID
类型选 “Desktop App”（最省事）
4. 下载生成的 client_secret_*.json
B. 把这个 json 发给我

• 最好用 Telegram 直接发 文件（不要粘贴在消息里）
• 我会把它放到服务器的 secrets/ 并只用于 OAuth 授权
我不会要你的 Gmail 密码，也不需要你给 2FA 验证码。



我还需要你确认 3 个设置（我才能一次配好）

1. 只读够不够？还是你想我也能 打标签/标记已读？（默认：只读）
2. 推送频率：每 5/15/30/60 分钟一次？
3. 推送规则：  • 只推 “未读且重要（Primary）”
  • 还是推所有未读（含 Promotions/Social）？

你回我这 3 个答案 + 把 client_secret_*.json 发过来，我就开始在服务器上搭脚本和定时任务。

行，老板，三项设置我收到了：

1. 标记已读
2. 每 3 小时推送一次
3. 只推 Primary 未读
但现在还差最后一步：我需要你再给我一个 gmail_token.json（里面必须带 refresh_token），这样我才能在服务器上定时拉取邮件并“标记已读”。
注意：为了能标记已读，授权 scope 需要 gmail.modify（只读的 gmail.readonly 不够）。

你要做的事（在你自己的电脑上，5 分钟）

1. 新建一个文件夹，把你刚发的那个 client_secret.json 放进去
2. 在该文件夹里执行：
npm init -y
npm i googleapis @google-cloud/local-auth
3. 然后下载/复制我这段脚本（我服务器里已经准备好了同名脚本，你也可以让我发你文本），保存为 gmail_token_from_desktop.js，再运行：
node gmail_token_from_desktop.js ./client_secret.json
它会弹浏览器让你登录授权，成功后会生成 gmail_token.json。

4. 把生成的 gmail_token.json 发回给我（文件形式）。
我拿到 token 后会做什么

• 在服务器上启用定时任务：每 3 小时检查 is:unread category:primary
• 有新邮件就给你发 Telegram 摘要（标题/发件人/时间/摘要）
• 然后把这些邮件标记为已读（避免重复推送）
顺带一句：你刚发的 client_secret 属于敏感信息，但它单独不能直接读你邮箱；真要停用也很简单——去 Google 账号里撤销第三方授权即可。

你把 gmail_token.json 发我就可以开跑了。

npm init -y
npm i googleapis @google-cloud/local-auth

const fs = require('fs');
const path = require('path');
const { authenticate } = require('@google-cloud/local-auth');
const { google } = require('googleapis');

const SCOPES = ['https://www.googleapis.com/auth/gmail.modify'];

async function main() {
  const clientPath = process.argv[2];
  if (!clientPath) {
    console.error('Usage: node gmail_token_from_desktop.js ./client_secret.json');
    process.exit(1);
  }

  const auth = await authenticate({
    keyfilePath: path.resolve(clientPath),
    scopes: SCOPES,
  });

  const tokenPath = path.join(process.cwd(), 'gmail_token.json');
  fs.writeFileSync(tokenPath, JSON.stringify(auth.credentials, null, 2));
  console.log('Saved token to:', tokenPath);
  console.log('Scopes:', SCOPES.join(' '));
}

main().catch(err => {
  console.error(err);
  process.exit(1);
});

node gmail_token_from_desktop.js ./client_secret.json

{
  "hooks": {
    "gmail": {
      "enabled": true,
      "topic": "your-pubsub-topic",
      "subscription": "your-subscription-name"
    }
  }
}