# Send Map Grabber to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "map-grabber",
    "name": "Map Grabber",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/QROST/map-grabber",
    "canonicalUrl": "https://clawhub.ai/QROST/map-grabber",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/map-grabber",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=map-grabber",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "clawhub.json",
      "requirements.txt",
      "scripts/grab_map.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "map-grabber",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T07:31:31.351Z",
      "expiresAt": "2026-05-12T07:31:31.351Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=map-grabber",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=map-grabber",
        "contentDisposition": "attachment; filename=\"map-grabber-1.1.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "map-grabber"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/map-grabber"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/map-grabber",
    "downloadUrl": "https://openagent3.xyz/downloads/map-grabber",
    "agentUrl": "https://openagent3.xyz/skills/map-grabber/agent",
    "manifestUrl": "https://openagent3.xyz/skills/map-grabber/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/map-grabber/agent.md"
  }
}
```
## Documentation

### 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)
ezdxf (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).

### Grab map by address

Parameters:

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

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

# PNG for Telegram + GeoPackage
python3 scripts/grab_map.py "Times Square, New York" --dist 400 --png site.png --gpkg site.gpkg

# With buildings and DXF
python3 scripts/grab_map.py "Shanghai Tower, Shanghai" --dist 500 --buildings --png site.png --gpkg site.gpkg --dxf site.dxf

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.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: QROST
- Version: 1.1.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T07:31:31.351Z
- Expires at: 2026-05-12T07:31:31.351Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/map-grabber)
- [Send to Agent page](https://openagent3.xyz/skills/map-grabber/agent)
- [JSON manifest](https://openagent3.xyz/skills/map-grabber/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/map-grabber/agent.md)
- [Download page](https://openagent3.xyz/downloads/map-grabber)