Google Workspace¶
启用后，AI 执行任务时可以直接读写你的 Google 表格、云盘文件、 Gmail、文档和日历——例如把广告数据填进周报表格、把发票归档到指定文件夹、给供应商发送跟进邮件、把上新排期写进日历。
底层使用 Google Workspace 官方命令行工具 gws（一个命令覆盖全部 Workspace API）。Vibe Seller 负责把它整理成 AI 能用的技能；你要做的是装好 gws、登录一次 Google 账号，然后在设置里点击启用。
各集成分别配在哪里、彼此怎么分工，见集成总览。
接入前准备¶
- gws 命令行工具（见下面第一步）；
- 一个能访问 Google Workspace 的 Google 账号（普通 @gmail.com 账号也可以，只是部分企业功能用不了）；
- 一个 Google Cloud 项目——没有的话第二步会引导你创建。
第一步：安装 gws¶
任选一种方式（官方 README）：
- 下载预编译二进制（推荐）：到
GitHub Releases
下载对应系统的包，解压后把
gws放进 PATH； - npm：
npm install -g @googleworkspace/cli； - Homebrew（macOS / Linux）：
brew install googleworkspace-cli。
安装完成后在终端运行 gws --version 确认可用。Vibe Seller 的设置卡片也会显示检测到的版本号。
第二步：登录 Google 账号¶
gws 需要一个 Google Cloud 项目的 OAuth 凭据才能访问你的数据。两种做法：
A. 有 gcloud（最省事）——在终端运行：
gws auth setup # 向导：选账号、建/选项目、开 API、建 OAuth 客户端
gws auth login # 在浏览器里完成 Google 登录授权
B. 不装 gcloud，手动创建：
- 打开 Google Cloud Console 创建一个项目；
- 配置 OAuth 同意屏幕：类型选 External（Testing 模式即可）；
- 在 Test users 里加上你自己的 Google 账号——漏了这一步登录时会报 "Access blocked"；
- 创建一个 OAuth 客户端：类型选 Desktop app，下载 JSON 保存为
~/.config/gws/client_secret.json； - 在终端运行
gws auth login，按提示勾选需要的服务完成授权。
登录成功的标志是 gws auth status 显示已登录。Vibe Seller 设置卡片里的认证一栏也会变成绿色的已登录。
官方文档：gws CLI README。
Google 尚未验证此应用？
Testing 模式的应用都会出现这个提示，点击 继续（高级）→
转到...（不安全） 即可；这是你自己的应用，出现风险自负类的提示属于正常流程。另外，未验证应用的授权范围上限约 25 个，如果 gws auth login 报 scope 太多，改用
gws auth login -s drive,gmail,sheets 只勾选需要的服务。
第三步：在 Vibe Seller 里启用¶
打开设置›集成›Google Workspace：
- 卡片会先显示两项检查：gws 可执行文件（安装后显示版本号）和 认证（登录后显示已登录）；
- 两项都通过后，点击启用一行右侧的 启用 按钮。第一次需要 20–30 秒——gws 要为所有 API 生成文档，生成完自动装入工作区；
- 看到已启用 — 已安装 19 个子技能就完成了。
三态对照：
还没装 gws：点击提示里的链接去下载
已安装但没登录：按提示在终端运行 gws auth login
启用后：按钮变为禁用，随时可以关闭
验证¶
- 回到这块设置：启用一行下面的提示变为「智能体可调用 gws 统一技能。」，按钮也变成了禁用；
- 创建一个任务试试：把这张 Google 表格的最后一列汇总一下（附上表格链接）；
- AI 能读出表格内容并给出汇总，就说明接入成功了。
接入后 AI 能做什么¶
技能按 Google 的产品分组，任务里 AI 按需取用：
| 产品 | 能做的事 |
|---|---|
| 表格 Sheets | 读写单元格、追加行、更新库存和报表 |
| 云盘 Drive | 查找文件、上传发票和资质、整理文件夹 |
| Gmail | 读写邮件、转发、回复、汇总未读 |
| 文档 Docs | 追加文字、更新 listing 文案和 SOP |
| 日历 Calendar | 查询日程、创建上新和促销日程 |
这些操作都以你登录的 Google 账号身份进行，权限范围就是你在授权时勾选的那些。不想让 AI 继续使用，随时在设置卡片点击 禁用——技能会从工作区移除。
常见问题¶
gws 可执行文件显示未找到？
gws 不在 PATH 里。按第一步重新安装，然后重启 Vibe Seller （让它重新检测）。Windows 上把 gws.exe 放进 PATH 后同样需要重启。
认证显示需要登录，但我在浏览器登录过 Google？
gws 的登录是独立的——需要在终端里运行 gws auth login 完成一次授权，浏览器里的 Google 登录状态不算数。卡片下方显示的
gws auth login 就是复制到终端里运行的。
点启用报错 gws is installed but not authenticated？
先完成第二步的登录（gws auth login），再回来点击启用。启用开关只有在 gws 装好且登录之后才可以点击。
启用要多久？会不会很慢？
第一次 20–30 秒——gws 在为所有 API 生成文档。之后的启用、禁用都很快。
登录时报 "Access blocked" 或 403？
OAuth 应用处于 Testing 模式，而你的账号没有加入 Test users。回到
Cloud Console 的 OAuth 同意屏幕 → Test users → Add users
加上自己的邮箱，重新运行 gws auth login。
公司 Google Workspace 账号有什么限制？
管理员可以关闭部分 API 或限制第三方应用访问。如果授权后某些操作报权限错误，请管理员在管理控制台检查对应的服务开关。个人 @gmail.com 账号没有这个层级的管控。
禁用后数据还在吗？
禁用只移除技能包，不会改动你的 Google 数据，也不会删除 gws 的登录凭据。想再使用时随时重新启用。