goplaces: 适用于 AI 智能体的 Google Places API CLI - Openclaw 技能

什么是 goplaces？

goplaces 是一款专门设计的 CLI 工具，用于与 Google Places API (New) 生态系统进行交互。它允许开发人员和自动化代理执行复杂的地点搜索、解析地址以及检索有关企业和景点的详细元数据。通过将此工具集成到您的 Openclaw 技能集合中，您可以赋予 AI 智能体以高精度数据导航物理世界的能力。

该实用程序专注于在原始 Google API 响应与可操作情报之间架起桥梁。它支持现代 API 功能，如文本搜索、地点详情和地址解析，使其成为 Openclaw 技能中任何需要地理上下文的工作流的重要组件。无论您是需要在终端中获得快速的人性化摘要，还是为流水线提供结构化的 JSON，goplaces 都能处理 API 通信和数据格式化的重任。

下载入口:https://github.com/openclaw/skills/tree/main/skills/steipete/goplaces

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install goplaces

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 goplaces。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

goplaces 应用场景

• 查找具有最低评分和距离过滤条件的特定类型商家（例如咖啡店或寿司店）。
• 将模糊的地点字符串解析为特定的地点 ID 和地理坐标。
• 检索详细的商家信息，包括用户评论、价格等级和营业时间，用于市场调研。
• 构建通过 Openclaw 技能需要实时位置数据的自动化旅行或物流助手。

goplaces 工作原理

1. 该工具使用用户提供的 GOOGLE_PLACES_API_KEY 环境变量向 Google Places API 进行身份验证。
2. 用户执行 search、resolve 或 details 等命令，并使用特定的过滤标志（例如 --open-now、--min-rating）。
3. CLI 向 Google Places API (New) 端点发送请求，处理纬度、经度和半径等参数。
4. 结果被解析并输出到终端，既可以是供人类阅读的格式化文本，也可以是供 Openclaw 技能中程序化使用的原始 JSON。

goplaces 配置指南

要设置 goplaces 技能，您必须安装二进制文件并配置 API 凭据：

# 通过 Homebrew 安装 CLI
brew install steipete/tap/goplaces

# 配置您的 API 密钥
export GOOGLE_PLACES_API_KEY="your_google_api_key"

确保 GOOGLE_PLACES_API_KEY 在触发这些命令的任何 Openclaw 技能的环境中均可用。

goplaces 数据架构与分类体系

该技能返回符合 Google Places API (New) 规范的结构化数据。当使用 --json 标志时，输出遵循一致的架构：

属性	类型	描述
id	字符串	唯一的 Google 地点 ID
displayName	对象	包含语言代码的地点名称
formattedAddress	字符串	完整的人类可读地址
rating	数字	0.0 到 5.0 的用户评分
priceLevel	整数	价格类别（0=免费，4=非常昂贵）
reviews	数组	最近的用户评论列表（可选）
location	对象	纬度和经度坐标

name: goplaces
description: Query Google Places API (New) via the goplaces CLI for text search, place details, resolve, and reviews. Use for human-friendly place lookup or JSON output for scripts.
homepage: https://github.com/steipete/goplaces
metadata: {"clawdbot":{"emoji":"??","requires":{"bins":["goplaces"],"env":["GOOGLE_PLACES_API_KEY"]},"primaryEnv":"GOOGLE_PLACES_API_KEY","install":[{"id":"brew","kind":"brew","formula":"steipete/tap/goplaces","bins":["goplaces"],"label":"Install goplaces (brew)"}]}}

goplaces

Modern Google Places API (New) CLI. Human output by default, --json for scripts.

Install

• Homebrew: brew install steipete/tap/goplaces

Config

• GOOGLE_PLACES_API_KEY required.
• Optional: GOOGLE_PLACES_BASE_URL for testing/proxying.

Common commands

• Search: goplaces search "coffee" --open-now --min-rating 4 --limit 5
• Bias: goplaces search "pizza" --lat 40.8 --lng -73.9 --radius-m 3000
• Pagination: goplaces search "pizza" --page-token "NEXT_PAGE_TOKEN"
• Resolve: goplaces resolve "Soho, London" --limit 5
• Details: goplaces details --reviews
• JSON: goplaces search "sushi" --json

Notes

• --no-color or NO_COLOR disables ANSI color.
• Price levels: 0..4 (free → very expensive).
• Type filter sends only the first --type value (API accepts one).