跳到主要内容
版本：2026 HER WAKA 活动

设置你的工具

在开始将邮件转化为行动之前，先把你的 AI 工具连接到 Gmail、日历和 Google 文档。

你需要准备： 一台能联网的电脑和一个 Google 账号（Gmail + 日历 + 文档）。无需任何编程经验 —— 我们会一步一步带你完成每个步骤。

  1. 安装 Node.js

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

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

    1. 前往 nodejs.org
    2. 点击绿色大按钮 LTS 下载安装程序
    3. 打开下载的 .msi 文件
    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 工具后，我们会重新启动它。

  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 获得使用 Google Workspace 工具的能力。打开终端并运行：

    复制此命令
    gemini extensions install https://github.com/googleworkspace/cli

    这将 Gemini CLI 与 gws 连接起来，当你发出自然语言指令时，Gemini 可以代你读取 Gmail、创建日历事件并写入 Google 文档。

    这是做什么的？ 它安装了一个扩展，让 Gemini CLI 可以自动调用 gws 命令。你不用再输入 gws calendar +insert ...，只需说"为周五创建一个日历事件"，Gemini 会自动处理。

    命令失败或卡住了

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

  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

    然后说（通过 Wispr Flow）或输入：

    说出或复制此提示词
    Check my Gmail and tell me how many unread emails I have.

    你应该会看到 Gemini CLI 访问你的 Gmail 并返回收件箱信息。现在试试这条：

    说出或复制此提示词
    What meetings do I have today?

    你应该会看到列出的日历事件。如果两条都正常，说明一切已连接就绪。

    Gemini 要求授权？ 如果 Gemini CLI 要求批准工具调用，输入 y 并按 Enter。这是正常的 —— 它在访问你的 Google 应用之前请求你的许可。

    Gemini 说没有 Gmail 或日历工具

    扩展可能没有正确安装。尝试重新运行安装命令：

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

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

    出现权限或认证错误

    你的 Google 授权可能已过期。退出 Gemini CLI，再次运行 gws auth login -s gmail,calendar,drive,docs,sheets 重新授权，然后重启 Gemini CLI。

验证你的设置​

Node.js 已安装

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

Gemini CLI 已安装并登录

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

gws 已安装并登录

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

Gemini CLI 扩展已安装

扩展安装没有报错。你可以在 Gemini CLI 内用 /extensions list 验证。

Gmail 和日历访问正常

当你询问时，Gemini CLI 能告诉你未读邮件数量和今天的会议安排。

连接测试通过

两条测试提示词都从你的 Gmail 和日历返回了真实结果。

一切就绪？前往自动化你的工作流，开始将邮件转化为行动。