设置你的工具

在开始构建你的早晨简报之前，先让你的 AI 工具连接到 Google 日历和 Gmail。

你需要准备： 一台能联网的电脑，以及一个已启用 Gmail 和日历的 Google 账号。无需任何编程经验 —— 我们会一步一步带你完成每个步骤。

1. 安装 Node.js

   已有 Node.js？ 如果你在之前的教程中已经安装过，跳过此步骤。在终端运行 node --version 检查 —— 你应该会看到类似 v22.x.x 的版本号。

   Node.js 是一个免费工具，让你可以在电脑上运行 Gemini CLI。

   Windows

   1. 前往 nodejs.org
   2. 点击绿色大按钮 LTS 下载安装程序
   3. 打开下载的 .msi 文件
   4. 点击下一步完成所有屏幕 —— 默认设置即可
   5. 点击安装，然后点击完成

   macOS

   1. 前往 nodejs.org
   2. 点击绿色大按钮 LTS 下载安装程序
   3. 打开下载的 .pkg 文件
   4. 点击继续完成所有屏幕 —— 默认设置即可
   5. 点击安装，然后点击关闭

   如何知道安装成功了？

   打开终端并输入：

   node --version

   你应该看到类似 v22.x.x 的版本号。如果看到错误，尝试关闭并重新打开终端，然后再次运行该命令。

2. 安装 Gemini CLI

   已有 Gemini CLI？ 如果你在之前的教程中已经安装过，跳过此步骤。只需在终端运行 gemini 确认它还能正常运行。

   Gemini CLI 是 Google 的免费 AI 助手。它在你的终端中运行，根据你的描述帮助你完成任务。

   打开终端并输入：

   npm install -g @google/gemini-cli

   等待安装完成。然后输入以下命令启动它：

   gemini

   第一次运行时，Gemini CLI 会要求你登录：

   • 选择 "Sign in with Google"
   • 浏览器窗口会打开 —— 用你的 Google 账号登录
   • 当提示已连接时，返回终端

   免费套餐： 每分钟 60 次请求，每天 1,000 次请求 —— 对于本教程和日常使用已绰绰有余。

   'npm' 未被识别

   这意味着 Node.js 没有正确安装。返回重新安装 Node.js。重新安装后，完全关闭终端并打开一个新的终端，然后再试一次。

   权限被拒绝错误

   Windows： 关闭 PowerShell，右键单击重新打开并选择**"以管理员身份运行"**，然后再次尝试安装命令。

   macOS： 在命令前加 sudo：

   sudo npm install -g @google/gemini-cli

   在提示时输入你的电脑密码（输入时不会显示字符 —— 这是正常的）。

   暂时输入 /quit 退出 Gemini CLI。安装 Google Workspace CLI 之后再重新启动。

3. 安装 Google Workspace CLI（gws）

   gws 是一个命令行工具，可以从终端控制你所有的 Google 应用 —— Gmail、Calendar、Drive、Docs、Sheets。它让 AI 无需打开浏览器就能管理你的 Google Workspace。

   打开终端并输入：

   复制此命令

   npm install -g @googleworkspace/cli

   等待安装完成。然后设置你的 Google Cloud 项目：

   复制此命令

   gws auth setup

   gws auth setup 做什么？ 它为你创建一个 Google Cloud 项目，启用你需要的 API，并为登录做好一切准备。它需要 gcloud CLI —— 如果你没有，请参阅下面的故障排除部分。

   设置完成后，登录并选择要连接的 Google 服务：

   复制此命令

   gws auth login -s gmail,calendar,drive,docs,sheets

   浏览器窗口会打开 —— 用你的 Google 账号登录并批准权限。

   "Google 尚未验证此应用"警告： 这是正常的。点击高级 → **转到 [应用名称]（不安全）**继续。这对个人使用是安全的 —— Google 对所有尚未通过官方审核流程的应用都会显示此提示。

   权限复选框： 如果你看到权限复选框列表，在点击继续之前选择所有选项（或点击全选）。这些是 gws 读取和管理你的 Google 应用所需的权限。

   通过查看今天的日程来验证安装：

   复制此命令

   gws calendar +agenda

   你应该在终端中看到你即将到来的日程。如果可以，说明 gws 正常工作。

   免费使用： gws 是免费开源的。它使用你自己的 Google 账号连接到 Google 的 API —— 除了 Google 自己的 API 配额之外没有使用限制。

   'gws' 未被识别

   安装可能没有将 gws 添加到你的系统 PATH。尝试完全关闭终端并打开一个新的终端，然后运行 gws --version。如果仍然不起作用，尝试重新安装：

   npm install -g @googleworkspace/cli

   'gcloud' 未安装

   gws auth setup 使用 gcloud CLI 自动创建项目。你有两个选项：

   1. 安装 gcloud，从 cloud.google.com/sdk/docs/install 安装，然后再次运行 gws auth setup
   2. 跳过 gcloud —— 在 Google Cloud Console 中手动设置 OAuth 凭据。创建项目，启用所需 API，创建 OAuth Desktop App 客户端，下载 JSON，并将其保存到 ~/.config/gws/client_secret.json。然后运行 gws auth login。

   权限被拒绝错误

   Windows： 关闭 PowerShell，右键单击重新打开并选择**"以管理员身份运行"**，然后再次尝试安装命令。

   macOS： 在命令前加 sudo：

   sudo npm install -g @googleworkspace/cli

   在提示时输入你的电脑密码（输入时不会显示字符 —— 这是正常的）。

   API 未启用错误

   如果你看到类似"Gmail API has not been used in project..."的错误，需要启用该 API：

   1. 在错误消息中找到 enable_url 链接
   2. 在浏览器中打开该链接
   3. 点击启用
   4. 等待 10 秒，然后重试你的命令

   你也可以再次运行 gws auth setup —— 它会自动启用所有需要的 API。

   登录时出现'访问被阻止'或 403

   你的 Google 账号未被列为 OAuth 应用的测试用户。在你的 Google Cloud 项目中打开 OAuth 同意屏幕 → 测试用户 → 添加用户 → 输入你的 Google 账号邮箱。然后重试 gws auth login。

4. 将 Gemini CLI 连接到 gws

   现在让 Gemini CLI 获得使用 gws 的能力 —— 这样当你提问时，它就能读取你的日历和邮件。

   打开终端，运行以下命令：

   复制此命令

   gemini extensions install https://github.com/googleworkspace/cli

   这告诉 Gemini CLI 将 Google Workspace CLI 作为扩展使用。安装完成后，Gemini 就能提取你的日历事件、对收件箱进行分类并生成站会摘要 —— 全部通过自然语言提示词实现。

   什么是扩展？ 扩展是为 Gemini CLI 添加新功能的插件。这个扩展将 Gemini 连接到你的 Google Workspace 应用 —— 类似于在手机上安装一款应用。

   命令失败或卡住

   确保你有网络连接，且 Node.js 已正确安装。先运行 node --version 检查。如果那个可以，但扩展安装失败，试着关闭并重新打开终端，然后再次运行命令。

5. 安装 Wispr Flow（可选）

   此步骤是可选的。 Wispr Flow 让你可以说话代替打字 —— 如果你更喜欢说话而不是打字，会很方便。如果你更喜欢打字输入提示词，可以跳过此步骤。

   使用此邀请链接注册，获得一个月免费 Pro 版： https://wisprflow.ai/r?CHAN115

   你和教程作者都能受益 —— 你获得一个月免费 Pro，当你口述 2,000 个单词时，作者也会获得一个月免费！

   1. 在 wisprflow.ai/r?CHAN115 注册
   2. 下载并安装适合你操作系统的应用
   3. 配置设置 —— 启用以下选项以获得最佳体验：
      • 实验性功能 > Command Mode —— 启用高级语音命令
      • Press Enter Command —— 当你说"press enter"时自动按回车
      • Bulk Import —— 导入片段和字典项目

   什么是 Wispr Flow？

   Wispr Flow 是一款语音转文字工具，让你可以口述代替打字。它在任何应用中都能使用，包括终端。与其向 Gemini CLI 打出一段长提示词，你可以直接说出来。如果你觉得打字慢或疲惫，这特别有用。

6. 测试连接

   启动 Gemini CLI 并让它读取你的日历 —— 这将确认所有连接都正常。

   复制此命令

   gemini

   Gemini CLI 运行后，用 Wispr Flow 说出或直接输入以下提示词：

   说出或复制此提示词

   What meetings do I have today?

   你应该会看到 Gemini CLI 访问你的 Google 日历并返回今天的事件列表。如果成功，一切都已正常运行。

   Gemini 要求确认？ 如果 Gemini CLI 要求批准工具调用，输入 y 并按 Enter。这是正常现象 —— 它在访问你的 Google 数据之前征求你的许可。

   Gemini 说它没有日历工具

   扩展可能没有正确安装。再次运行安装命令：

   gemini extensions install https://github.com/googleworkspace/cli

   然后退出（/quit）并重启 Gemini CLI。你可以在 Gemini CLI 内运行 /extensions list 查看已安装的扩展。

   浏览器窗口没有弹出用于身份验证

   复制终端中显示的 URL，手动粘贴到浏览器中。在那里完成登录，然后返回终端。

验证你的设置

Node.js 已安装

在终端运行 node --version，应显示一个版本号。

Gemini CLI 已安装并登录

在终端运行 gemini，可正常启动并显示一个可输入的提示符。

gws 已安装并完成身份验证

在终端运行 gws calendar +agenda，应显示即将到来的事件。

Gemini CLI 扩展已安装

扩展安装时无报错。可在 Gemini CLI 内运行 /extensions list 进行验证。

连接已测试

当你询问"What meetings do I have today?"时，Gemini CLI 能够告知你的会议安排。

一切就绪？前往获取你的早晨简报，开始你的第一次 AI 驱动的早晨例程。