核心用法
Google Maps 技能通过 ClawLink 托管连接层,为 OpenClaw 用户提供完整的 Places、Routes、Geocoding 等 API 能力。用户无需自行申请 Google Cloud 项目或管理 API 密钥,仅需安装 ClawLink 插件、完成 OAuth 授权,即可在对话中调用 20+ 种工具,涵盖地点搜索(googlemaps_search_places)、地址解析(googlemaps_geocode)、路线规划(googlemaps_directions)、距离矩阵(googlemaps_distance_matrix)等场景。
显著优点
1. 零配置接入:ClawLink 统一托管凭证,省去 Google Cloud 项目创建、账单绑定与密钥轮换的繁琐流程。
2. 工具覆盖全面:支持 Places、Routes、Geocoding、Elevation、Roads、Time Zone 六大类 API,满足从简单查址到复杂物流计算的多样需求。
3. 安全代理机制:所有请求经 ClawLink 代理,token 不暴露于客户端,降低密钥泄露风险。
4. 读写分离的权限设计:读操作(搜索、解析、路线)自动执行;写操作强制要求用户显式确认,符合最小权限原则。
潜在局限
- 第三方依赖:实际可用性受 ClawLink 服务稳定性与 Google API 配额双重制约,若 ClawLink 或 Google 端发生故障,技能将中断。
- 数据隐私路径:用户查询的地理位置数据需经过 ClawLink 服务器中转,对敏感位置信息有合规顾虑的场景需谨慎评估。
- 成本不透明:Google Maps API 按调用量计费,ClawLink 的定价与配额策略未在文档中明示,长期高频使用可能产生不可预期的费用。
- 功能边界:静态地图(
googlemaps_static_maps)与 Roads API 需额外启用项目权限,并非开箱即用。
适合人群
- 需要快速原型验证或内部工具的开发者与产品团队;
- 无 Google Cloud 运维经验,希望降低地图服务集成门槛的用户;
- 在 AI 对话场景中频繁需要位置查询、路线推荐或地址标准化的业务场景。
常规风险
| 风险类别 | 说明 |
|---------|------|
| 凭证泄露 | 虽由 ClawLink 托管,但 OAuth 授权流程仍需用户在第三方页面输入 Google 账号,存在钓鱼页面仿冒风险。 |
| 配额超限 | Google Maps API 有每日/每秒请求上限,高频调用可能触发 `OVER_QUERY_LIMIT`,导致服务中断。 |
| 数据留存 | ClawLink 的日志与缓存策略未公开,地理位置等敏感信息的存储周期与地域合规性不明。 |
| 供应商锁定 | 深度依赖 ClawLink 的代理层,未来迁移至自建 Google Cloud 项目时需重新对接 API 格式与凭证体系。 |