Geolocation Plugin: Map IPs to Cities with Local Cache

This page describes the OpenClaw geolocation plugin, which resolves client IP addresses to a coarse city using a locally cached database. It is intended for developers integrating location features into their applications.

Read this when

  • You are installing, configuring, or auditing the geolocation plugin

Geolocation plugin

Takes a client IP address and maps it to a general city location, relying on a geolocation database stored locally in cache.

Distribution

  • Package: @openclaw/geolocation-plugin
  • Installation path: bundled with OpenClaw

Surface

plugin

44 words · updated Aug 25, 2026