---
summary: "Resolves client IP addresses to a coarse city using a locally cached IP-geolocation database."
read_when:
  - You are installing, configuring, or auditing the geolocation plugin
title: "Geolocation plugin reference"
---

<!-- Generated file. Do not edit by hand.
Run `pnpm plugins:inventory:gen` to rebuild it. Hand-written text survives only
between the openclaw-plugin-reference:manual-start and
openclaw-plugin-reference:manual-end comment markers. -->

Resolves client IP addresses to a coarse city using a locally cached IP-geolocation database.

## Distribution

- Package: `@openclaw/geolocation-plugin`
- Install route: included in OpenClaw

## Surface

This plugin declares no channels, providers, commands, or contracts.

## Related docs

- [geolocation](/plugins/geolocation)