mcpField
G
gws-install

gws-install

github.com/jezweb生产力1.1k1.1k 次安装3 周前更新
代码仓库

关于 gws-install

gws-install 是一项设置技能，可使用已有 OAuth 凭据在另一台机器安装 Google Workspace CLI。它会指导认证、Agent 技能安装和访问验证。

主要功能

  1. 01检查 CLI 和认证状态
  2. 02安装 gws CLI
  3. 03配置 OAuth 凭据
  4. 04认证 Google 账号
  5. 05安装 Google Workspace Agent 技能
  6. 06通过 CLI 命令验证访问

适用场景

  1. 01在另一台机器设置 gws
  2. 02使用现有 client_secret.json 认证
  3. 03在 Claude Code 安装 Google Workspace 技能
  4. 04检查 CLI 认证和命令

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jezweb/claude-skills --skill gws-install

安装后在 Claude Code 中输入/gws-install确认已加载。

详细介绍

Google Workspace CLI — 快速安装

使用之前设置的 OAuth 凭据在另一台机器上安装 gws。安装后即可获得已通过身份验证的 CLI，并可使用所有 Agent 技能。

前提条件：用户必须拥有之前运行 gws-setup 时获得的 client_secret.json（或从 Google Cloud Console 获取）。如果没有，请改用 gws-setup 技能。

工作流

步骤 1：安装前检查
which gws && gws --version
ls ~/.config/gws/client_secret.json
gws auth status

如果已经通过正确的作用域完成身份验证，请跳至步骤 4。

步骤 2：安装 CLI
npm install -g @googleworkspace/cli
gws --version
步骤 3：设置凭据

请用户提供其 client_secret.json。有以下三种方式：

选项 A — 粘贴 JSON 内容：

请用户粘贴 JSON。将其写入 ~/.config/gws/client_secret.json：

mkdir -p ~/.config/gws

预期格式：

{
  "installed": {
    "client_id": "...",
    "project_id": "...",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "client_secret": "...",
    "redirect_uris": ["http://localhost"]
  }
}

选项 B — 文件路径：

如果用户在本地有该文件（例如在 Downloads 文件夹中）：

mkdir -p ~/.config/gws
cp /path/to/client_secret.json ~/.config/gws/client_secret.json

选项 C — 环境变量：

export GOOGLE_WORKSPACE_CLI_CLIENT_ID="your-client-id"
export GOOGLE_WORKSPACE_CLI_CLIENT_SECRET="your-client-secret"
步骤 4：进行身份验证

重要：此步骤会打印一个非常长的 OAuth URL（包含 30 多个作用域），用户必须在浏览器中打开该 URL。该 URL 太长，无法从终端输出中复制——它会换行并导致内容中断。务必先将其提取到文件中，再以编程方式打开。

询问用户要使用哪个 Google 账号，然后：

  1. 在后台运行身份验证并捕获输出：
gws auth login -s gmail,drive,calendar,sheets,docs,chat,tasks 2>&1 | tee /tmp/gws-auth-output.txt

作为后台任务运行即可——用户在浏览器中批准后，任务便会完成。

  1. 提取并打开 URL（在输出出现后单独运行）：
grep -o 'https://accounts.google.com[^ ]*' /tmp/gws-auth-output.txt > /tmp/gws-auth-url.txt
cat /tmp/gws-auth-url.txt | xargs open

如果 open 无法运行，请告诉用户：“身份验证 URL 已保存到 /tmp/gws-auth-url.txt——请打开该文件并从中复制 URL。”

  1. 等待用户在浏览器中批准，然后进行验证：
gws auth status

替代方案 — 使用 --full 获取所有作用域：

gws auth login --full

用户可以在原来的机器上运行 gws auth status，查看已授予的作用域。

步骤 5：安装 Agent 技能
npx skills add googleworkspace/cli -g --agent claude-code --all

这会将 90 多项技能安装到 ~/.claude/skills/。如果技能已安装，可以放心重新运行。

步骤 6：验证
gws auth status
gws calendar +agenda --today
gws gmail +triage

故障排除

“Auth error — credentials missing or invalid”（退出代码 2）
  • 检查 ~/.config/gws/client_secret.json 是否存在且包含有效的 JSON
  • 重新运行 gws auth login
令牌已过期
  • 如果 GCP 应用处于“Testing”状态，令牌会在 7 天后过期
  • 重新运行 gws auth login 以刷新令牌
  • 如需永久令牌，请在 GCP Console 的 OAuth 同意屏幕中将应用发布到 Production
技能未显示在 Claude Code 中
  • 技能会在会话开始时加载——安装后请重启 Claude Code
  • 验证：ls ~/.claude/skills/gws-* | wc -l 应显示 30 个以上目录

另请参阅

  • gws-setup — 首次设置，包括创建 GCP 项目
  • gws-shared — 身份验证模式和全局标志

评论

支持 Markdown