- name
- pdf-report
- version
- 1.0.1
- description
- Generate clean A4 PDF reports from structured JSON using Jinja2 and WeasyPrint. Use when the user needs a formatted PDF document — analytical summary, data report, or chart-based export — from workspace data.
- metadata
- { "openclaw": { "emoji": "PDF", "requires": { "bins": ["python3"] } } }
PDF Report
Generate a clean A4 PDF from structured JSON data.
Setup
Install system dependencies (WeasyPrint requires these):
# Ubuntu/Debian
sudo apt-get install -y libpango-1.0-0 libpangocairo-1.0-0 libgdk-pixbuf2.0-0 libffi-dev libcairo2Create a virtual environment and install Python dependencies (one-time):
python3 -m venv ~/.openclaw/workspace/.venv_pdf
~/.openclaw/workspace/.venv_pdf/bin/pip install weasyprint jinja2Quick start
~/.openclaw/workspace/.venv_pdf/bin/python skills/pdf-report/scripts/render_pdf.py \
--input exports/report-data.json \
--output exports/pdfs/report.pdfInputs
--inputpath to a JSON file inside the workspace--outputpath to the PDF output inside the workspace- Optional:
--template-filecustom Jinja2 template path inside the workspace - Optional:
--html-outwrite the rendered HTML for debugging
Expected JSON shape
{
"title": "Monthly Report",
"subtitle": "Summary by region",
"generated_at": "2026-03-23 10:00",
"summary": ["Key point 1", "Key point 2"],
"sections": [
{
"title": "Sales by category",
"lead": "National overview",
"items": ["Observation 1", "Observation 2"],
"table": {
"headers": ["Category", "Amount", "Share"],
"rows": [["Electronics", "12 450", "45%"]]
},
"charts": [
{
"title": "Distribution by category",
"src": "exports/charts/category.png",
"caption": "Source: sales database"
}
],
"note": "Data as of 31/12/2025"
}
],
"footer": "Company Name — Department"
}Notes
- All file paths (CLI arguments and
charts[].srcin JSON) must stay inside the workspace. Paths outside the workspace are rejected. - Missing chart images produce a warning to stderr but do not block PDF generation.
- Use
chart-mplfirst when a section needs chart images, then reference those image paths incharts[].src. - Output directories are created automatically.
- Default template:
skills/pdf-report/templates/report.html - Dedicated venv:
~/.openclaw/workspace/.venv_pdf/(weasyprint + jinja2) - Pages are numbered automatically (bottom-right: "1 / 3").
Custom templates
Use --template-file to provide your own Jinja2 HTML template. Note that relative asset paths inside custom templates (images, CSS) resolve from the workspace root, not the template's directory. Use workspace-root-relative paths for any referenced assets.