A powerful geolocation tool that identifies the physical location and network provider of any public IP address.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ip-locator-skill
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 ip-locator-skill 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 IP Locator?
The IP Locator skill is a specialized utility designed for Openclaw Skills users who need to bridge the gap between digital addresses and physical locations. By leveraging the ip-api.com service, this skill enables AI agents to retrieve detailed geographical data—including country, city, coordinates, and timezone—without requiring complex API keys or authentication.
Beyond basic location tracking, this skill provides critical network metadata such as Internet Service Provider (ISP), Organization (Org), and Autonomous System Number (ASN). This makes it an essential tool for developers, security analysts, and researchers who need to contextualize network logs or verify user origins in real-time.
IP Locator Use Cases
- Identifying the geographic origin of a specific IP address for security audits.
- Retrieving the current public IP address and location of the host machine.
- Analyzing network logs to determine ISP and ASN data for troubleshooting.
- Contextualizing traffic by mapping IP addresses to specific regions or timezones.
How IP Locator Works
- The user or agent triggers the skill with a specific IPv4/IPv6 address or a request for the current public IP.
- The skill sends a structured request to the ip-api.com endpoint using the curl utility.
- The service processes the request and returns a comprehensive JSON payload containing location and provider data.
- The skill parses the JSON response to extract relevant fields like countryCode, lat/lon, and isp.
- The formatted data is returned to the user or passed to the next step in the AI agent's workflow.
IP Locator Setup
To integrate this tool into your environment, use the following commands within your Openclaw Skills workspace:
# Query a specific IP address (e.g., Google DNS)
curl -s "ip-api.com/json/8.8.8.8?fields=61439"
# Query your current public IP address
curl -s "ip-api.com/json/?fields=61439"
# Using the provided helper script for multiple IPs
./scripts/ip-lookup.sh 8.8.8.8 1.1.1.1
IP Locator Data Schema & Taxonomy
The skill returns a standardized JSON object. Below are the primary fields included in a full response:
| Field | Description | Example |
|---|---|---|
| status | Success or failure of the query | success |
| country | Full name of the country | United States |
| regionName | Full name of the state/province | California |
| city | Name of the city | Mountain View |
| lat / lon | Latitude and Longitude coordinates | 37.386, -122.0838 |
| isp | Internet Service Provider | Google LLC |
| query | The IP address that was searched | 8.8.8.8 |
IP Locator Advanced Features
- Bulk Query Support: Process multiple IP addresses simultaneously via the ip-lookup.sh script.
- Field Filtering: Optimize performance and bandwidth by requesting only specific fields (e.g., ?fields=country,city).
- Zero-Config Integration: No API keys required for standard usage, allowing for immediate deployment in Openclaw Skills environments.
- IPv4 and IPv6 Compatibility: Fully supports both address standards for global reach.
SKILL.md
Loading
Related Openclaw Skills
SuperCoolPeep Generator
A specialized CLI tool for generating unique SuperCoolPeep characters using deterministic 68-digit seeds and trait mapping logic.
Alibaba Cloud Qwen ASR (Non-Realtime)
A high-performance transcription skill leveraging Alibaba Cloud Qwen models for converting recorded audio into accurate text and structured transcripts.
Design Pick
A specialized automation tool for generating themed food collages featuring circular-masked images and dynamic selection titles.
Pattern Miner
Pattern Miner is a privacy-first data analysis tool that identifies recurring patterns, associations, and anomalies in local structured files.
Terms of Service Generator
An automated generator for professional Terms of Service, User Agreements, and update notifications optimized for SaaS, Apps, and eCommerce platforms.
X-TechCon Hot News Skill
A streamlined utility for Openclaw Skills that retrieves real-time technology news headlines and summaries from X-TechCon.
Featured*
