google-search

核心用法

google-search Skill 是一个轻量级的网络搜索工具，专为 OpenClaw Agent 设计，用于在需要实时信息、文档查询或研究场景时执行 Google 搜索。用户需先在 Google Cloud Console 创建项目并启用 Custom Search API，获取 API Key 和 Search Engine ID (CX)，通过环境变量 GOOGLE_API_KEY 和 GOOGLE_CSE_ID 配置凭证后即可使用。核心脚本 search.py 接收搜索关键词，向 Google Custom Search API 发送 GET 请求，返回结构化的 JSON 搜索结果，支持自定义返回结果数量（默认 5 条）。

显著优点

该 Skill 的最大优势在于其简洁性和安全性设计。代码结构清晰，仅依赖 Python 标准库和 requests，无冗余功能。安全方面，敏感凭证完全通过环境变量管理，避免了硬编码风险；网络请求固定指向 Google 官方 API 端点，无 SSRF 漏洞；无任何文件操作、子进程执行或动态代码执行等危险操作。此外，作为 Google 官方 API 的封装，搜索结果质量有保障，响应速度快，适合需要权威实时信息的场景。

潜在缺点与局限性

首先，该 Skill 依赖外部 API 服务，用户需自行申请 Google Cloud 账号并配置 API，存在一定的使用门槛。其次，Google Custom Search API 有免费配额限制（每日 100 次查询），高频使用可能产生费用。功能层面，脚本较为基础，缺少输入参数的范围校验（如 num_results 未限制上限）、HTTP 请求超时设置以及详细的错误日志输出，在异常场景下的用户体验有待提升。此外，搜索查询内容会发送至 Google 服务器，对隐私敏感场景需谨慎。

适合的目标群体

该 Skill 适合需要为 AI Agent 集成实时网络搜索能力的开发者、研究人员和内容创作者。具体包括：构建知识问答系统的工程师、需要实时验证信息的科研工作者、以及开发自动化研究工具的产品团队。对于已在使用 Google Cloud 生态或愿意配置 API 凭证的技术用户尤为合适。

使用风险

主要风险集中在 API 凭证管理和外部依赖两方面。用户需妥善保管 .env 文件，避免意外提交至版本控制导致密钥泄露。网络层面，虽然请求目标固定安全，但缺乏超时机制可能导致请求挂起。此外，Google API 的服务可用性和定价策略变化会直接影响 Skill 的稳定性，建议生产环境监控 API 配额使用情况并做好降级方案。