SVG to Image

通过 Python 脚本将 SVG 文件渲染为 PNG 或 JPG 位图，支持指定输出路径、格式、宽度/高度和 DPI；转换依赖 cairosvg，JPG 输出还需 Pillow，Linux 上需先安装 Cairo 库。转换完成后由宿主消息工具把图片发送给用户。

qrost

热度 89.29

最近更新 2026-05-17 12:26:24

分类：效率依赖：代码执行 / 读写文件应用场景：文件转换

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add svg-to-image

Metadata

name: svg-to-image
version: 1.1.1
description: Convert SVG to PNG or JPG for quick sharing (e.g. Telegram) or print.
author: qrost
permissions: ["shell:exec"]

SVG to Image

Convert SVG files to PNG or JPG. Useful when you have vector graphics (e.g. from map-grabber, diagrams, or design tools) and need a raster image to send in chat or use in documents.

Dependencies

cairosvg (SVG rendering)
Pillow (only for JPG output)

Setup: OpenClaw does not install Python packages automatically. After installing this skill, run once: pip install -r requirements.txt (from the skill folder). On Linux (e.g. Ubuntu/Debian), install the Cairo library first: sudo apt install libcairo2. If a script fails with ModuleNotFoundError or a cairo library error, install the missing package or system library.

Usage

Convert SVG to PNG or JPG

Parameters:

input: Path to the SVG file.
-o, --output: Output file path (default: same name as input with .png or .jpg).
-f, --format: png (default) or jpg.
--width, --height: Optional output size in pixels (keeps aspect ratio if only one is set).
--dpi: Scale for rasterization (default 96).

# SVG to PNG (default)
python3 scripts/convert_svg.py drawing.svg -o drawing.png

# SVG to JPG
python3 scripts/convert_svg.py drawing.svg -f jpg -o drawing.jpg

# Fixed width 800px (height auto)
python3 scripts/convert_svg.py map.svg -o map.png --width 800

Sending images to Telegram

Used from the OpenClaw Telegram conversation. Run the script with -o <path>.png or -o <path>.jpg, then send that file to the user via the OpenClaw message/media tool.

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

Agent behavior: When the user asks to convert an SVG to PNG or JPG (or "send as image"), run the script directly with exec: use convert_svg.py <svg_path> -o <output>.png (or -f jpg) with output path under an allowed dir, then send the generated image. Do not ask for confirmation; execute and return the image.

Examples

User: "Convert this SVG to PNG so I can send it in Telegram."
Action: Run convert_svg.py <path> -o /tmp/out.png, then send the PNG to the user.

User: "Turn map.svg into a JPG, 1200px wide."
Action: Run with -f jpg -o /tmp/map.jpg --width 1200, then send the JPG.