A powerful geocoding skill that enables AI agents to perform forward and reverse geocoding via the OpenCage API using the Membrane framework.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install 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 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 Geocoding Integration?
The OpenCage geocoding skill for Openclaw Skills provides a seamless way for AI agents to interact with geographic data. By leveraging the OpenCage API, this skill allows for the conversion of geographic coordinates into human-readable places (reverse geocoding) and addresses into latitude and longitude (forward geocoding). It is designed to empower developers to add location awareness to their applications without the overhead of complex mapping logic.
Built on top of the Membrane protocol, this skill abstracts away the complexities of authentication and credential management. Whether you are building a logistics bot, a weather assistant, or a local search tool, this integration ensures that your agent can fetch high-precision location data securely and efficiently.
OpenCage Geocoding Integration Use Cases
- Converting GPS coordinates from mobile devices into specific street addresses for logistics tracking.
- Transforming user-provided address strings into map coordinates for data visualization.
- Enhancing CRM data by automatically filling in geographic details based on company names or locations.
- Providing local context to AI agents by identifying the city or neighborhood based on current user coordinates.
How OpenCage Geocoding Integration Works
- The AI agent initiates a connection to OpenCage through the Membrane CLI, which handles the secure OAuth or API key handshake.
- Once authenticated, the agent uses natural language intent to search for specific geocoding or reverse geocoding actions.
- The agent executes the selected action, passing parameters like address strings or lat/long pairs as JSON.
- Membrane processes the request, injects the necessary credentials, and communicates with the OpenCage API.
- The geocoding results are returned to the agent in a structured format for immediate use in the application workflow.
OpenCage Geocoding Integration Setup
To get started with OpenCage and Openclaw Skills, install the Membrane CLI and authenticate your environment:
npm install -g @membranehq/cli@latest
membrane login --tenant --clientName=openclaw
Ensure a connection to the OpenCage service:
membrane connection ensure "https://opencagedata.com" --json
If the connection state is BUILDING, wait for it to become READY:
npx @membranehq/cli connection get <id> --wait --json
OpenCage Geocoding Integration Data Schema & Taxonomy
The skill returns structured geographic data organized into Results and Geocoding objects. Below is the general structure of the data returned from an OpenCage query:
| Field | Description |
|---|---|
formatted |
The full human-readable address string |
geometry |
Object containing lat and lng coordinates |
components |
Breakdown of the address (city, country, postcode, etc.) |
confidence |
A numeric score (1-10) representing the accuracy of the match |
annotations |
Metadata such as timezone, currency, and what3words address |
OpenCage Geocoding Integration Advanced Features
- Direct Proxy Requests: Use
membrane requestto call any specific OpenCage endpoint not covered by standard actions. - Automated Credential Refresh: Transparent handling of API tokens without manual intervention or local secret storage.
- Natural Language Action Discovery: Find the exact geocoding tool you need by describing your intent to the Membrane CLI.
- Multi-Agent Support: Tailor the geocoding tooling for different environments like Claude, Windsurf, or Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
MedCrypt
A security-focused skill providing end-to-end encryption for medical data and clinical communications across messaging platforms.
MiniMax Quota Query
A specialized monitoring tool to track MiniMax API usage, remaining quotas, and reset intervals across multiple model types.
Baidu Scholar Search
A specialized research skill for searching Chinese and English academic literature, journals, and dissertations via Baidu Scholar.
Blast L2 — Ethereum L2 Chain Reference
A comprehensive technical reference skill for navigating the Blast L2 ecosystem, focusing on native yield mechanics and developer infrastructure.
BlueCart API Skill
A comprehensive integration for the BlueCart API that enables AI agents to automate inventory, order management, and supplier workflows for the hospitality industry.
Scheduled Job Trigger vs Execution Failure Diagnoser
A diagnostic framework to pinpoint whether scheduled tasks failed to trigger or encountered errors during execution.
Featured*
