Map Grabber

Get site base maps from OpenStreetMap: provide an address, receive street network and optional building footprints as vector data (SVG, GeoPackage, or DXF) for use in CAD or Rhino.

Dependencies

• - osmnx (OSM data and graph; requires geopandas, networkx)
• INLINECODE3 (optional; for DXF export)

Setup: OpenClaw does not install Python packages automatically. After installing this skill, run once: pip install -r requirements.txt (from the skill folder). If a script fails with ModuleNotFoundError, install the missing package (osmnx pulls geopandas; for DXF add ezdxf).

Usage

Grab map by address

Parameters:

• - address: Address or place name (e.g. "SoHo, New York" or "123 Main St, Los Angeles").
• INLINECODE7: Radius in meters around the point (default 500).
• INLINECODE8: Also download building footprints.
• INLINECODE9: Output path for SVG (street network plot).
• INLINECODE10: Output path for PNG (same map as image; use for Telegram or preview).
• INLINECODE11: Output path for GeoPackage (streets and optionally buildings as layers).
• INLINECODE12: Output path for DXF (requires ezdxf; for CAD/Rhino).

At least one of --svg, --png, --gpkg, or --dxf is required.

CODEBLOCK0

Output: street network (and optionally buildings) in the requested formats.

Sending images to Telegram

Used from the OpenClaw Telegram conversation. To show the user the map: run the script with --png <path>.png (e.g. --png site.png), then send that PNG to the conversation via the OpenClaw message/media tool. Use --png (not only --svg) when the user expects an image in chat.

OpenClaw allowed paths: The message tool only sends files from allowed dirs (~/.openclaw/media/, ~/.openclaw/agents/, or /tmp). Use e.g. --png ~/.openclaw/media/site.png or --png /tmp/site.png; do not use the skill install directory or sending will fail.

Agent behavior: When the user asks for a site map, base map, or OSM map (by address or place name), run the script directly using exec: call grab_map.py with the given address, --png <path>.png with <path> under an allowed dir (and optional --dist, --buildings), then send the generated PNG to the user. Do not ask for confirmation; execute and return the image and a short confirmation.

Examples

User: "Get me a site base map for 123 Main St" or "抓一张这个地址的场地底图."
Action: Run grab_map.py "123 Main St" --png /tmp/site.png (or similar path), then send the PNG to the user and confirm.

User: "Get me a site base map for 123 Main St as SVG and DXF."
Action: Run grab_map.py with that address, --svg, --dxf, and optionally --png for chat; return the file paths and confirmation.

User: "I need OSM data for this address with building footprints for Rhino."
Action: Run with --buildings, --gpkg and optionally --dxf; if they want an image in chat, also use --png and send it.