核心用法
Google Contacts 技能基于 ClawLink 托管的 OAuth 认证流程，将 Google People API 封装为 OpenClaw 可调用的工具集。用户无需自行申请 Google Cloud 项目或管理 API 密钥，仅需三步：安装 ClawLink 插件 → 配对账户 → 在仪表板连接 Google Contacts。
技能提供完整的联系人生命周期管理：
- 读取操作：列出、搜索、获取联系人详情、获取头像、查看分组
- 写入操作：创建/更新/删除单个或批量联系人、管理分组、更新头像
- 目录功能：搜索域内用户、获取自身 Google 资料
工具调用统一通过 clawlink_call_tool 执行，参数遵循 Google People API 的字段命名（如 resource_name、emailAddresses、phoneNumbers）。所有写操作强制要求用户显式确认，并在执行前通过 clawlink_preview_tool 预览变更。
---
显著优点
1. 零配置接入：ClawLink 托管 OAuth 流程，屏蔽了 Google Cloud Console 项目创建、域名验证、凭据下载等繁琐步骤。
2. 细粒度权限：访问范围限定于联系人和分组，不涉及 Gmail、Drive 等其他数据；写操作需二次确认，降低误触风险。
3. 批量操作支持：提供 batch_create/update/delete_contacts，适合通讯录迁移或大规模整理场景。
4. 实时工具发现：通过 clawlink_list_tools 和 clawlink_search_tools 动态获取当前可用工具，避免硬编码工具列表。
---
潜在缺点与局限性
- 第三方依赖：认证层完全依赖 ClawLink 服务可用性，若 ClawLink 故障或停止运营，技能将不可用。
- 网络延迟：代理架构（OpenClaw → ClawLink → Google）引入额外跳转，高并发场景可能感知延迟。
- API 限制继承：受 Google People API 配额限制（如每秒请求数、每日修改次数），大规模批量操作可能触发限流。
- 功能边界：部分目录/资料功能需额外 OAuth 范围，可能因权限不足而受限；无法管理 Google Workspace 组织级通讯录策略。
---
适合人群
- 需要快速集成 Google Contacts 的 OpenClaw 用户，无运维背景亦可使用
- 频繁整理个人或小型团队通讯录的行政/运营人员
- 需自动化联系人同步（如 CRM 数据回写）的轻量级自动化场景
---
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| OAuth 令牌泄露 | ClawLink 服务端存储用户令牌，若其被攻破可能导致联系人数据泄露 | 依赖 ClawLink 安全实践；用户可定期在 Google 账户中撤销第三方访问权限 |
| 误操作数据丢失 | 批量删除或覆盖操作不可逆 | 强制 `clawlink_preview_tool` 确认；写操作前显式描述影响范围 |
| 供应商锁定 | 深度绑定 ClawLink 生态，迁移需重新对接 Google API | 保留原始 API 迁移路径作为备选方案 |