An OpenCage geocoding skill that enables AI agents to perform forward, reverse, and GeoJSON-formatted coordinate lookup through the OOMOL-connected oo CLI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oo-opencage
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 oo-opencage 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 OpenCage?
The OpenCage geocoding skill provides a seamless, secure connection to OpenCage's powerful geocoding engine directly from your local terminal or within automated AI agent environments. By leveraging Openclaw Skills alongside the OOMOL-connected oo CLI, developers and AI agents can execute complex spatial and geographic requests without managing raw API tokens locally.
This integration dramatically simplifies workflows requiring geographic lookups by offloading credential injection to OOMOL's secure servers. Whether your project demands converting physical addresses to precise GPS coordinates, obtaining reverse-geocoded local details, or pulling maps data formatted in strict GeoJSON, this skill delivers structured, dependable data schemas optimized for agentic execution.
OpenCage Use Cases
- Converting user-entered addresses into latitude and longitude coordinates (forward geocoding) for mapping applications.
- Resolving GPS coordinates from mobile devices or IoT sensors into human-readable locations (reverse geocoding).
- Generating GeoJSON FeatureCollection outputs to visualize geographic data on mapping interfaces.
- Integrating location-based context directly into larger automated agent workflows using Openclaw Skills.
How OpenCage Works
- Contract Inspection: The AI agent queries the OpenCage connector's live schema using the
oo connector schemacommand to identify authoritative parameter names. - Action Invocation: The agent constructs a JSON payload containing the required parameters (e.g., query addresses or coordinate pairs) and runs the command.
- Secure Resolution: The OOMOL-connected CLI forwards the request to the backend where credentials are automatically injected server-side.
- Structured Delivery: The CLI returns a standardized JSON response containing the geocoding results and execution metadata, ready to be utilized by other tools in the Openclaw Skills workflow.
OpenCage Setup
1. Install the oo CLI
Run the appropriate script to install the CLI on your host system if it is not already installed.
For macOS or Linux:
curl -fsSL https://cli.oomol.com/install.sh | bash
For Windows PowerShell:
irm https://cli.oomol.com/install.ps1 | iex
2. Sign In to OOMOL
Authenticate your local CLI environment:
oo auth login
3. Connect your OpenCage Account
Navigate to your OOMOL App Connections page to link your OpenCage API Key:
https://console.oomol.com/app-connections?provider=opencage
OpenCage Data Schema & Taxonomy
Schema Verification
Before sending a request, query the contract payload to ensure dynamic fields match:
oo connector schema "opencage" --action "<action_name>"
Execution Output
All actions executed via this connector return a unified payload containing the execution identifier and data:
| Key | Type | Description |
|---|---|---|
data |
Object | The raw payload returned from the OpenCage API matching the requested action. |
meta |
Object | Standard metadata block. |
meta.executionId |
String | A unique ID identifying the transaction execution. |
Actions Taxonomy
geocode_forward: Geocodes an address. Input includes standard query parameters (e.g., address string). [write]geocode_geojson: Returns standard GeoJSON-formatted objects containing geocoded features.geocode_reverse: Converts latitude and longitude coordinates into localized place names.
OpenCage Advanced Features
- Secure Key Management: Eliminates raw API key leaks by routing calls through OOMOL's server-side credential injector.
- Dynamic Schema Inspection: Real-time contract query capability prevents formatting drift and payload validation errors within multi-agent networks.
- GeoJSON Native Support: Seamlessly structure data output to interface cleanly with geographic mapping libraries and geo-visualization pipelines utilizing Openclaw Skills.
- Write State Safety: Built-in verification triggers for modifying operations to ensure zero destructive geocoding events occur without validation.
SKILL.md
Loading
Related Openclaw Skills
Postman (oo-postman)
An advanced API development and testing skill that lets AI agents seamlessly manage Postman collections, workspaces, specifications, and mock servers without manual token handling.
Linux DO Integration
A CLI-powered AI agent skill designed to query, search, and monitor forum topics, posts, and user activity from Linux DO without raw credential handling.
ParseHub Integration
An automated integration enabling AI agents and developers to safely run ParseHub web scraping projects and retrieve structured web data without writing custom scrapers.
MailerLite Integration
Securely read, create, update, and delete MailerLite subscribers and groups via an AI-ready CLI connector.
NASA
A powerful NASA science and astronomy data exploration skill for AI coding agents to search near-Earth objects, fetch space weather alerts, and retrieve deep space imagery without handling raw API credentials.
oo-launch-darkly
An AI-ready CLI tool for reading, creating, updating, and deleting LaunchDarkly configurations safely and without managing raw API tokens.
Featured*
