A local API proxy that enables AI agents to search for venues and resolve geographic locations via the Google Places API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install local-places
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install local-places using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Local Places?
The Local Places skill is a specialized tool designed to empower AI agents with real-time geographic awareness. By serving as a local proxy for the Google Places API, it allows developers to integrate venue discovery and location resolution directly into their workflows. This skill is a core component for building location-aware applications within the Openclaw Skills ecosystem, providing structured access to business data, ratings, and physical addresses.
Developers can leverage this tool to build conversational interfaces that understand "near me" queries or specific neighborhood searches. Because it runs locally, it provides a secure way to manage API keys while offering high-speed responses for agents navigating complex spatial data.
Local Places Use Cases
- Resolving natural language location descriptions like "Soho, London" into precise coordinates.
- Searching for specific venue types such as cafes or gyms with minimum rating requirements.
- Filtering local businesses by price level and current open now status.
- Generating paginated lists of nearby points of interest for travel planning.
How Local Places Works
- The agent initiates a request to resolve a text-based location into latitude and longitude coordinates.
- The skill performs a search using these coordinates as a location bias, incorporating user-defined filters like radius and price.
- Search results are returned in a structured format, which the agent can then use to fetch deep-link details or paginate using a next-page token.
Local Places Setup
To integrate this skill into your environment, ensure you have a valid Google Places API key. Follow these steps:
cd {baseDir}
echo "GOOGLE_PLACES_API_KEY=your-key" > .env
uv venv && uv pip install -e ".[dev]"
uv run --env-file .env uvicorn local_places.main:app --host 127.0.0.1 --port 8000
Ensure uv is installed as it is the preferred package manager for Openclaw Skills components.
Local Places Data Schema & Taxonomy
The skill returns data in a structured format optimized for AI consumption:
| Field | Description |
|---|---|
| place_id | Unique identifier for the Google Places entry |
| location | Object containing lat and lng |
| rating | Numerical value from 0-5 in 0.5 increments |
| price_level | Integer from 0 (free) to 4 (expensive) |
| next_page_token | Token used to retrieve the next set of search results |
Local Places Advanced Features
- Intelligent location biasing with customizable search radii.
- Strict filter constraints for high-precision venue matching.
- Support for multi-step conversation flows within the Openclaw Skills framework.
- Pagination support via persistent page tokens for exhaustive local searches.
SKILL.md
Loading
Related Openclaw Skills
Instruments Profiling (macOS/iOS)
A comprehensive guide for profiling native Apple platform applications using xctrace and the Instruments suite to eliminate performance bottlenecks.
imsg
A command-line interface for macOS that enables AI agents and developers to interact with iMessage and SMS services programmatically.
goplaces
A modern command-line interface for the Google Places API (New) that provides both human-readable and JSON-structured location data.
gog
A comprehensive command-line interface for managing Google Workspace services including Gmail, Drive, Sheets, and Calendar.
Markdown Converter
A versatile document conversion tool that transforms various file formats into clean Markdown for LLM processing and text analysis.
mcporter
A CLI utility for interacting with Model Context Protocol (MCP) servers, allowing direct tool execution, authentication, and code generation.
Featured*
