SuperAPI AI 工具集

nopal-setup

通用与其它

查看项目

更新于 10-16 09:56

技能介绍

用途:本文是 Nopal 命令(commands/nopal.md)通过 Read 读取的参考资料。仅在 gws CLI 未安装或未认证时参考,用于「gws 安装」「认证指南」「OAuth 设置」「setup」等请求。

gws CLI 说明:gws(Google Workspace CLI)是可在终端操作 Google Workspace 9 项服务的官方 CLI 工具,Nopal 通过它交互。要点:gws 自行管理 OAuth 令牌;Nopal 插件不直接处理令牌;采用 OAuth 用户认证,而非 API 密钥或服务账号。

安装:前提为 Node.js 18 以上、npm 或 yarn。命令:npm install -g @googleworkspace/cli。用 gws --version 确认版本。失败时:command not found 检查 npm 全局路径是否在 PATH;权限错误可用 sudo 或 nvm;版本过低需升级。默认 /nopal 运行时会尝试自动安装,失败则提示手动安装。

初始设置:gws auth setup 是交互式 TUI,需用户在终端直接运行。五步:确认 gcloud CLI;选择 Google 账号;创建 GCP 新项目(ID 需小写开头、仅含小写字母数字与连字符、6~30 字符且全局唯一,建议形如 nopal-ws-XXXXXX);选择需要的 9 个 Workspace API(Drive、Sheets、Gmail、Calendar、Docs、Slides、Tasks、Chat、Meet),不选其余;配置 OAuth——设置同意屏幕(User Type 选 External)、必须添加测试用户否则出现 403、创建「桌面应用」类型 OAuth 客户端 ID 并填入 Client ID 与 Secret。

登录:执行 gws auth login,选择 Recommended 范围;URL 需手动复制到浏览器打开,遇未验证警告选择高级后继续;成功后需执行 gws auth export --unmasked 2>/dev/null | grep -v '^Using keyring' > ~/.config/gws/credentials.json 生成明文凭证,供 Claude Code 使用。用 gws auth status 验证。

限制与排障:令牌过期可重新登录并导出;凭证损坏可 logout 后重登;403 因测试用户未登记;invalid_scope 因范围超过 25 个;401 因无头环境无法访问 Keyring;浏览器不自动打开;组织账号可能受管理员策略限制;项目 ID 重复需更换随机数字。必要时可执行 gws auth logout 后 gws auth setup 重置。

完成后重新运行 /nopal,命令会自动检测认证状态并进入编排模式。