Google Admin

通过 Google Admin API（使用 OAuth 认证）访问 Google Workspace Admin SDK，用于管理用户、群组、域名、设备及目录数据。

本技能使用 ClawLink 托管连接流程与凭据，您无需自行配置 Google Admin API 访问权限。

三步完成设置

工作原理

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│ Google Admin SDK │
│   (用户会话)    │     │   (OAuth)    │     │   (REST)         │
└─────────────────┘     └──────────────┘     └──────────────────┘
         │                       │                       │
         │  1. 安装插件          │                       │
         │  2. 绑定设备           │                       │
         │  3. 连接 Google Admin                       │
         │                       │  4. 获取安全令牌      │
         │                       │  5. 代理请求          │
         │                       │                       │
         ▼                       ▼                       ▼
   ┌──────────┐           ┌──────────┐           ┌──────────┐
   │  SKILL   │           │ 控制台   │           │ Google   │
   │  文件    │           │ 认证     │           │ Workspace│
   └──────────┘           └──────────┘           └──────────┘

安装

从 ClawHub 安装已验证的 ClawLink 插件。用户确认后，请完成全部设置，使 ClawLink 工具在下一次 OpenClaw 会话中可见。

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

然后告知用户：“OpenClaw 已重启。请单独发送 /new 消息以开启全新会话，再重新请求 Google Admin 功能。”

快速入门

# 列出域内所有用户
clawlink_call_tool --tool "google_admin_list_all_users" --params '{}'

# 获取指定用户信息
clawlink_call_tool --tool "google_admin_get_a_user" --params '{"user_key": "user@example.com"}'

# 列出所有群组
clawlink_call_tool --tool "google_admin_list_all_groups" --params '{}'

认证机制

所有 Google Admin 工具调用均由 ClawLink 自动完成认证，使用的是用户已连接的 Google Workspace 管理员账号。

会话中无需提供 API 密钥。 ClawLink 安全存储 OAuth 令牌，并代表用户将该令牌注入每一次 Google Admin API 请求中。

建立连接

1. 安装 ClawLink 插件（参见上方“安装”章节）。
2. 若插件尚未配置，请运行 clawlink_begin_pairing 启动配对流程。
3. 访问 https://claw-link.dev/dashboard?add=google-admin 并连接 Google Admin。
4. 调用 clawlink_list_integrations 验证连接是否已激活。

连接管理

列出所有连接

clawlink_list_integrations

响应：返回所有已连接的集成项。请在列表中查找 google-admin。

验证连接状态

clawlink_list_tools --integration google-admin

响应：返回 Google Admin 的实时工具目录。

重新连接

若 Google Admin 工具缺失或连接显示错误，请执行以下操作：

1. 引导用户访问 https://claw-link.dev/dashboard?add=google-admin
2. 用户确认后，调用 clawlink_list_integrations 验证连接状态
3. 随后调用 clawlink_list_tools --integration google-admin

安全与权限

• 访问范围限定于所连接管理员账号有权管理的 Google Workspace 域及其资源。
• 所有写入操作均需用户明确确认。 在执行任何创建、更新或删除操作前，必须向用户确认目标资源及预期影响。
• 破坏性操作（如删除用户、移除群组）被标记为高影响操作，必须经用户确认后方可执行。
• 本技能要求具备 Google Workspace 管理员权限。个人 Gmail 账号无法访问 Admin SDK。

工具参考

用户

群组

组织单位（Organization Units）

设备

域名管理

代码示例

列出所有用户

clawlink_call_tool --tool "google_admin_list_all_users" 
  --params '{
    "customer": "my_customer",
    "max_results": 100
  }'

创建新用户

clawlink_call_tool --tool "google_admin_create_user" 
  --params '{
    "primary_email": "newuser@example.com",
    "name": {
      "given_name": "New",
      "family_name": "User"
    },
    "password": "secure-password-here"
  }'

将用户加入群组

clawlink_call_tool --tool "google_admin_add_user_to_group" 
  --params '{
    "group_email": "engineering@example.com",
    "user_email": "newuser@example.com",
    "role": "MEMBER"
  }'

列出所有群组

clawlink_call_tool --tool "google_admin_list_all_groups" 
  --params '{}'

发现工作流

1. 调用 clawlink_list_integrations 确认 Google Admin 是否已连接。
2. 调用 clawlink_list_tools --integration google-admin 查看实时工具目录。
3. 以返回的列表为准，切勿猜测或假设存在哪些工具。
4. 若用户描述了某项能力但具体工具不明确，请使用简短查询词配合集成标识 google-admin 调用 clawlink_search_tools。
5. 若未出现任何 Google Admin 工具，请引导用户访问 https://claw-link.dev/dashboard?add=google-admin。

执行工作流

┌─────────────────────────────────────────────────────────────┐
│  读取操作（安全）                                           │
│  list → get → search → describe → call                      │
│                                                             │
│  示例：列出用户 → 获取用户 → 展示详情                        │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  写入操作（需用户确认）                                     │
│  list → get → describe → preview → confirm → call         │
│                                                             │
│  示例：描述工具 → 预览用户创建操作                           │
│           → 用户批准 → 执行创建                             │
└─────────────────────────────────────────────────────────────┘

1. 对于不熟悉的工具、模糊的请求或任意写入操作，请首先调用 clawlink_describe_tool。
2. 依据返回的指导说明、参数 Schema、whenToUse、askBefore、safeDefaults、examples 及 followups 构建调用请求。
3. 在可能降低歧义的前提下，优先执行读取、列出、搜索和获取类操作，再执行写入操作。
4. 对于写入操作或任何被标记为需确认的操作，请先调用 clawlink_preview_tool。
5. 使用 clawlink_call_tool 执行最终调用；仅当预览结果与用户意图完全一致时，才传入确认参数。
6. 若工具调用失败，请如实反馈原始错误信息。不得虚构结果，也不得将失败简单归因为“功能缺失”，除非实时工具目录明确支持该结论。

注意事项

• 本技能要求具备 Google Workspace 管理员权限。个人 Gmail 账号无法访问 Admin SDK。
• 用户与群组的邮箱地址必须属于已验证的 Google Workspace 域。
• 部分管理员操作（例如删除用户、移动组织单位）可能受管理员策略限制。
• 用户查询中的 customer 参数可设为 my_customer 或具体的客户 ID。

错误处理

排查：工具不可见

1. 检查 ClawLink 插件是否已安装：

   openclaw plugins list
   

2. 若插件已安装但工具缺失，请提示用户单独发送 /new 消息以重新加载工具目录。
3. 若新建会话仍无改善，请运行：

   openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
   openclaw gateway restart
   

4. 重启完成后，请提示用户再次发送 /new 并重试。

排查：无效的工具调用

1. 确保集成标识（slug）严格为 google-admin。
2. 调用前请使用 clawlink_describe_tool 核实参数名称与类型。
3. 对于写入操作，请始终先调用 clawlink_preview_tool。

参考资料

• Google Admin SDK 文档
• Directory API 参考文档
• ClawLink
• ClawLink 文档
• ClawLink 验证

相关技能

• Google Calendar — 用于日历管理
• Gmail — 用于邮件管理

由 ClawLink 提供支持 — OpenClaw 的集成中心