Google Chat

通过 Google Chat API（使用 OAuth 认证）访问 Google Chat。可管理空间、成员、消息、附件及线程化对话。

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

三步完成设置

工作原理

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│  Google Chat API │
│   (用户聊天)    │     │   (OAuth)    │     │   (REST)         │
└─────────────────┘     └──────────────┘     └──────────────────┘
         │                       │                       │
         │  1. 安装插件          │                       │
         │  2. 配对设备           │                       │
         │  3. 连接 Google Chat                        │
         │                       │  4. 获取安全令牌       │
         │                       │  5. 代理请求           │
         │                       │                       │
         ▼                       ▼                       ▼
   ┌──────────┐           ┌──────────┐           ┌──────────┐
   │  SKILL   │           │ 控制台   │           │ Google   │
   │  文件    │           │ 认证     │           │ Chat     │
   └──────────┘           └──────────┘           └──────────┘

安装

从 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 Chat。”

快速入门

# 列出用户所属的所有空间
clawlink_call_tool --tool "google_chat_list_spaces" --params '{}'

# 列出某空间中的所有成员
clawlink_call_tool --tool "google_chat_list_members" --params '{"parent": "spaces/space-id"}'

# 向某空间发送消息
clawlink_call_tool --tool "google_chat_create_message" --params '{"parent": "spaces/space-id", "text": "Hello from OpenClaw!"}'

认证

所有 Google Chat 工具调用均由 ClawLink 自动完成认证，使用的是用户已连接的 Google 账户。

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

建立连接

1. 安装 ClawLink 插件（参见上方“安装”章节）。
2. 若尚未配置，运行 clawlink_begin_pairing 命令完成插件配对。
3. 访问 https://claw-link.dev/dashboard?add=google-chat 并连接 Google Chat。
4. 调用 clawlink_list_integrations 验证连接是否已生效。

连接管理

列出所有连接

clawlink_list_integrations

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

验证连接状态

clawlink_list_tools --integration google-chat

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

重新连接

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

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

安全与权限

• 访问范围限定于已连接 Google 账户有权访问的 Google Chat 空间与消息。
• 所有写入操作均需显式用户确认。 在执行任何消息发送、空间创建或成员变更操作前，须向用户明确说明预期效果并获得确认。
• 破坏性操作（如删除空间、移除成员）被标记为高影响操作，必须经用户确认后方可执行。
• 单条消息大小上限为 32,000 字节；卡片式消息需使用 Bot 认证。

工具参考

空间

成员

消息

反应（Reactions）

附件与自定义表情符号

分区（Sections）

代码示例

列出空间

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

向某空间发送消息

clawlink_call_tool --tool "google_chat_create_message" 
  --params '{
    "parent": "spaces/space-id",
    "text": "Hello team! Just wanted to share an update on the project status."
  }'

在线程中回复

clawlink_call_tool --tool "google_chat_create_message" 
  --params '{
    "parent": "spaces/space-id",
    "text": "Thanks for the update!",
    "thread": {
      "thread_key": "original-message-id"
    }
  }'

为消息添加反应

clawlink_call_tool --tool "google_chat_create_reaction" 
  --params '{
    "parent": "spaces/space-id/messages/message-id",
    "emoji_unicode": "👍"
  }'

发现工作流（Discovery Workflow）

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

执行工作流（Execution Workflow）

┌─────────────────────────────────────────────────────────────┐
│  读取操作（安全）                                           │
│  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. 若工具调用失败，请如实反馈原始错误。不得虚构结果，亦不可将失败简单归因为“功能缺失”，除非实时工具目录明确不支持该能力。

注意事项

• API 调用中空间名称格式为 spaces/space-id。
• 消息线程使用 thread_key 实现对已有线程的回复。
• 自定义表情符号仅适用于 Google Workspace 账户，且需管理员启用。
• 使用用户身份认证时，仅支持纯文本消息；卡片式消息需 Bot 认证。
• 单条消息大小限制为 32,000 字节。

错误处理

故障排查：工具不可见

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

   openclaw plugins list
   

2. 若插件已安装但工具缺失，请告知用户单独发送 /new 消息以重新加载工具目录。
3. 若新开会话仍未解决，请执行：

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

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

故障排查：无效的工具调用

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

资源

• Google Chat API 参考文档
• Google Chat API 概览
• ClawLink
• ClawLink 文档
• ClawLink 验证

相关技能

• Slack — 作为团队消息的替代方案
• Gmail — 与聊天协同使用的电子邮件服务

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