用途:在已有 gws-setup 的基础上,将 Google Workspace CLI(gws)快速装到另一台机器,并复用原有 OAuth 凭据完成认证,使命令行可用且技能就绪。
前提:需持有此前 gws-setup 或 Google Cloud Console 生成的 client_secret.json;没有则应改用 gws-setup 技能。
主要步骤:
- 预检查:which gws && gws --version、ls ~/.config/gws/client_secret.json、gws auth status;若已认证且权限范围正确可跳到第 4 步。
- 安装 CLI:npm install -g @googleworkspace/cli,随后 gws --version 验证。
- 配置凭据:三种方式——粘贴 JSON 内容写入 ~/.config/gws/client_secret.json(需先 mkdir -p ~/.config/gws);从本地文件路径复制 cp /path/to/client_secret.json ~/.config/gws/client_secret.json;或设置环境变量 GOOGLE_WORKSPACE_CLI_CLIENT_ID 与 GOOGLE_WORKSPACE_CLI_CLIENT_SECRET。
- 认证:gws auth login -s gmail,drive,calendar,sheets,docs,chat,tasks,输出很长、终端中会换行,需先重定向到文件再用 grep 提取 URL 打开;也可用 gws auth login --full 获取全部权限范围。完成后用 gws auth status 验证。
- 安装技能:npx skills add googleworkspace/cli -g --agent claude-code --all,安装到 ~/.claude/skills/,可重复执行。
- 验证:gws auth status、gws calendar +agenda --today、gws gmail +triage。
常见问题:凭据缺失或无效(退出码 2)需检查 client_secret.json 是否存在且为合法 JSON,并重跑登录;若 GCP 应用处于 Testing 状态,令牌 7 天后过期,需重新登录,或将其推送到 Production 以获得长期令牌;技能未出现在 Claude Code 中时,重启客户端并确认 ~/.claude/skills/gws-* 目录数量不少于 30。
相关:gws-setup 负责首次配置(含创建 GCP 项目),gws-shared 说明认证模式与全局参数。其余细节资料暂未提供。