A specialized tool for AI agents to retrieve and analyze the current device's public IP address and associated network metadata.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ip-query
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-query 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 Query Skill?
The IP Query Skill is a robust utility designed for Openclaw Skills to provide AI agents with immediate access to public networking data. It enables agents to identify the current public IP address, determine geographic location (City, Region, Country), and extract ISP details.
By integrating this skill, developers can automate network-aware tasks, verify proxy or VPN statuses, and provide localized context to users. It leverages reliable public APIs to ensure high availability and accurate data retrieval for various development and troubleshooting scenarios.
IP Query Skill Use Cases
- Identifying current public IP address for remote access configuration.
- Verifying network exit nodes when using VPNs or proxy services.
- Determining user geolocation for regional content or service delivery.
- Troubleshooting network connectivity and ISP-related issues.
- Automated logging of network environment details in CI/CD pipelines.
How IP Query Skill Works
- The AI agent identifies a network-related intent such as "what is my IP".
- The skill executes a request to a primary API (api.ipify.org) to fetch the raw public IP address.
- If detailed information is requested, it falls back to a secondary API (ipinfo.io) to retrieve JSON-formatted metadata.
- The raw data is parsed, often using tools like jq, to extract specific fields like ISP and latitude/longitude.
- The skill formats the output into a human-readable summary, including security reminders about IP privacy.
IP Query Skill Setup
To integrate this into your environment, ensure you have the necessary dependencies installed:
# Install required HTTP request tools
sudo apt-get install curl wget
# Optional: Install jq for advanced JSON parsing
sudo apt-get install jq
# Ensure the query script is executable
chmod +x scripts/ip_query.sh
IP Query Skill Data Schema & Taxonomy
The skill processes and returns data structured around the following network attributes:
| Attribute | Description | Example |
|---|---|---|
| IP Address | The public-facing IPv4 address | 123.45.67.89 |
| City/Region | Geographic location of the IP | Beijing, China |
| Coordinates | Latitude and Longitude values | 39.90, 116.40 |
| ISP/Org | Internet Service Provider details | China Telecom |
| Privacy Hint | Security recommendation | Do not share publicly |
IP Query Skill Advanced Features
- Multi-API Redundancy: Automatically switches between ipify and ipinfo to ensure constant uptime.
- Metadata Enrichment: Goes beyond simple IP detection to provide full ASN and organizational data.
- Scriptable CLI: The core logic is housed in an independent shell script for easy integration into other Openclaw Skills workflows.
- Privacy-First Output: Includes automated security warnings to prevent accidental exposure of sensitive network data.
SKILL.md
Loading
Related Openclaw Skills
Shanghai Stock Exchange Composite Index
A specialized tool for querying real-time market indices and minute-level price trends for major Chinese stock exchanges.
Xiaohongshu Algorithm Optimizer
A specialized optimization tool designed to maximize visibility and engagement on the Xiaohongshu platform by aligning content with its unique recommendation algorithms.
Competitive Intelligence
A systematic intelligence framework to track competitors, generate sales battlecards, and drive strategic C-Suite decision-making.
RDK X5 TROS: TogetheROS.Bot Development
RDK X5 TROS provides a comprehensive ROS2 Humble framework tailored for the RDK X5, featuring 43 pre-installed algorithm packages for advanced robotics and AI perception.
Daily News Skill
An automated news retrieval skill that fetches daily headlines, trending topics, and in-depth article details through a centralized API.
Comment to Content Recycler
An intelligent workflow to transform audience engagement data into a prioritized, script-ready content backlog.
Featured*
