Google Maps

核心用法

Google Maps Places Skill 是一款基于 ClawLink 集成平台的地图服务增强工具，用户无需自行申请 Google API 密钥，通过 ClawLink 托管的 OAuth 流程即可调用完整的 Google Maps Platform 能力。

主要功能模块

• 地点搜索与发现：文本搜索、附近搜索、地点详情、自动补全
• 地理编码服务：地址转坐标（正向）、坐标转地址（反向）
• 路线与导航：多模式方向查询、距离矩阵、路线矩阵
• 辅助数据：海拔查询、时区获取、道路吸附、静态地图生成

使用流程

1. 安装 ClawLink 插件：openclaw plugins install clawhub:clawlink-plugin
2. 配对设备并连接 Google Maps 账户
3. 通过 clawlink_call_tool 调用具体工具（如 googlemaps_search_places、googlemaps_directions）

显著优点

• 零配置上手：ClawLink 托管凭证，免除 API 密钥申请与计费配置
• 完整功能覆盖：涵盖 Places、Directions、Geocoding、Elevation、Roads、Time Zone 等 15+ 个 API
• 安全代理模式：所有请求经 ClawLink 代理，支持读写分离的权限控制
• 实时数据：路线规划支持实时交通数据

潜在缺点与局限性

• 依赖第三方服务：ClawLink 作为中间层，若其服务故障将导致完全不可用
• API 配额限制：仍受 Google Cloud 项目配额约束，超额需付费
• 隐私顾虑：位置数据需流经 ClawLink 服务器，敏感场景需谨慎
• 网络依赖：所有操作需在线完成，无离线能力
• 地域限制：部分功能（如 Roads API）需额外启用，且存在区域覆盖差异

适合人群

• 需要快速集成地图能力但不愿处理 Google Cloud 配置的开发者
• 使用 OpenClaw 平台的终端用户，希望对话中直接获取位置信息
• 需要批量地理编码、路线优化的物流、出行类应用用户
• 对 API 密钥管理有合规顾虑的企业团队

常规风险

• 凭证泄露风险：虽由 ClawLink 托管，但仍需信任其中间人安全架构
• 账单不可控：Google Maps API 按调用计费，高频使用可能产生意外费用
• 数据留存：ClawLink 可能日志化请求数据，敏感位置信息存在留存风险
• 服务连续性：ClawLink 或 Google 任一方的策略变更可能影响服务可用性

核心用法

Google Maps Places Skill 是一套基于 ClawLink 平台的文档型集成方案，专为大语言模型对话场景设计。用户通过三步完成配置：安装 ClawLink 插件、设备配对、在 dashboard 中连接 Google Maps。此后即可调用 20+ 个工具函数，涵盖六大功能域：

1. 地点搜索与发现：文本搜索、附近搜索、自动补全、地点详情；
2. 地理编码：地址转坐标、坐标转地址；
3. 路线规划：驾驶/步行/骑行/公交多模式导航、距离矩阵、批量路径计算；
4. 高程与地形：单点及路径高程查询；
5. 时区与道路：时区获取、GPS 轨迹吸附到道路；
6. 静态地图：生成带标记的地图图片。

显著优点

• 零凭证负担：OAuth 与 API Key 全部由 ClawLink 托管，用户端无密钥泄露风险；
• 即装即用：纯 Markdown 文档型 Skill，无可执行代码，无依赖冲突；
• 官方数据背书：底层调用 Google Maps Platform 官方 API，数据实时、覆盖全球；
• 权限粒度清晰：所有工具均为 Read 模式，写操作需二次确认，降低误操作风险；
• 企业级安全传输：ClawLink 使用 TLS 1.3 加密通信。

潜在缺点与局限性

• 第三方依赖：认证链路完全依赖 ClawLink，若其服务中断或遭受攻击，将阻断 API 访问；
• 隐私合规门槛：涉及精确地理位置、WiFi/蜂窝定位，需用户明确授权并符合 GDPR/CCPA；
• 来源可信度 T3：由个人开发者维护，无企业级 SLA 背书，长期维护能力存疑；
• 配额与成本不透明：Google Maps API 按调用量计费，ClawLink 未在文档中说明费用分摊或配额告警机制；
• 功能无本地缓存：每次查询均实时请求 Google 服务器，高并发场景可能触发速率限制。

适合人群

• 快速原型开发者：需要在对话式 AI 中快速验证地图相关功能；
• 中小团队：缺乏运维能力管理 Google Cloud 项目与 API Key；
• 隐私敏感型应用：希望避免在本地持久化存储用户坐标；
• 多语言场景：利用 Google Maps 全球 POI 数据支持跨国业务。

常规风险

• 供应链风险：ClawLink 平台作为单点认证枢纽，一旦被攻破可能导致大量用户凭证泄露；
• 数据出境：位置信息发送至 Google 服务器，涉及跨境数据传输合规问题；
• 过度授权：OAuth 流程若未严格限制 scope，可能获取超出必要的 Google 账户权限；
• 日志残留：尽管 Skill 本身不存储数据，但 ClawLink 后端日志可能保留敏感位置轨迹，需审查其数据保留策略。

综上，该 Skill 适合追求快速集成、低运维成本的场景，但在高可用、强合规、企业级 SLA 要求的环境中，建议评估直接对接 Google Cloud 的方案。