← Back to Skills Marketplace
Openstreet Map
by
PoxenStudio
· GitHub ↗
· v1.0.0
· MIT-0
149
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install openstreet-map
Description
Use when you need OpenStreetMap geocoding or annotated map generation for a set of places.
Usage Guidance
This skill appears to do what it says: geocode with Nominatim and stitch OSM tiles into an annotated PNG. Before installing, note: (1) it requires Internet access to contact nominatim.openstreetmap.org and tile.openstreetmap.org — make sure outbound network access is acceptable and you respect OSM/Nominatim usage and rate limits; (2) it intentionally can emit image data as base64 to stdout — avoid using --base64 unless necessary because large base64 payloads will bloat agent messages; (3) the OPENSTREET_MAP_HOST override is documented but the implementation likely contains a bug, so custom-host behavior may not work as expected; (4) the script will try to load system or bundled CJK fonts (reads common font paths) — this is normal for rendering multilingual labels but be aware it probes filesystem font locations; (5) installation is simply pip install -r requirements.txt (Pillow, requests). No credentials are requested and there are no hidden network endpoints in the code. If you need the host-override behavior, ask the author to fix the _resolve_service_endpoints replacement logic or inspect the code before use.
Capability Analysis
Type: OpenClaw Skill
Name: openstreet-map
Version: 1.0.0
The skill provides legitimate geocoding and map rendering functionality using OpenStreetMap's Nominatim and tile services. The Python script `tools/openstreet_skill.py` uses standard libraries (`requests`, `Pillow`) to process data and generate images, with no evidence of malicious behavior, data exfiltration, or unauthorized execution. A minor bug exists in the environment variable override logic where it attempts to replace the wrong domain string, but this is an unintentional flaw and does not pose a security risk.
Capability Assessment
Purpose & Capability
Name/description align with the provided code and CLI: the tool geocodes single queries and renders annotated maps from point lists. Required packages (Pillow, requests) and Python runtime are appropriate for image rendering and HTTP calls.
Instruction Scope
SKILL.md instructions and the code mostly match: both describe 'locate' and 'render' CLI actions, file or base64 inputs, and file output. One functional inconsistency: SKILL.md documents an OPENSTREET_MAP_HOST override, and the code reads that env var, but the host-replacement logic appears buggy (it attempts to replace the string 'openstreetmap.de', which does not exist in the default constants), so setting OPENSTREET_MAP_HOST may not produce the expected custom endpoints. Otherwise, instructions only access declared inputs/files and the optional OPENSTREET_MAP_HOST; the skill performs network requests only to OSM/Nominatim tile and search endpoints.
Install Mechanism
No install script is embedded; requirements.txt lists only Pillow and requests (standard, traceable PyPI packages). The SKILL.md suggests 'pip install -r requirements.txt' which is proportional to the functionality.
Credentials
No required environment variables or credentials are requested. The only optional env var is OPENSTREET_MAP_HOST to override endpoints (see the note above about a likely implementation bug). No secrets or unrelated credentials are needed.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system configuration. It reads input files and writes output images only to paths you provide; it does not persist privileged tokens or enable itself automatically.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openstreet-map - After installation, invoke the skill by name or use
/openstreet-map - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
OpenStreet Map Skill v1.0.0
- Initial release providing OpenStreetMap integration for geocoding and map generation.
- Supports querying location data for a single place using Nominatim.
- Enables rendering annotated maps with multiple places, numbered markers, and a legend.
- Allows map output as a PNG file or as a base64-encoded string in JSON.
- Provides environment variable override for OpenStreetMap host endpoints.
- Detailed CLI usage and integration notes for use with OpenClaw.
Metadata
Frequently Asked Questions
What is Openstreet Map?
Use when you need OpenStreetMap geocoding or annotated map generation for a set of places. It is an AI Agent Skill for Claude Code / OpenClaw, with 149 downloads so far.
How do I install Openstreet Map?
Run "/install openstreet-map" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Openstreet Map free?
Yes, Openstreet Map is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Openstreet Map support?
Openstreet Map is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Openstreet Map?
It is built and maintained by PoxenStudio (@poxenstudio); the current version is v1.0.0.
More Skills