- name
- doc2slides
- version
- 3.8.2
- description
- One-click PDF/Word/Markdown to designer-grade PPT. AI auto-layout + 18 slide types + built-in charts. Local-first, free. Use when: user wants to create slides from a document or convert content to PPT.
- license
- MIT-0
- author
- lifei68801
- metadata
- openclaw
- requires
- bins
- ["python3", "pip3"]
- env
- optional
- permissions
- behavior
- modifiesLocalFiles
- true
- network
- optional
- telemetry
- none
- credentials
- optional
Doc2Slides
把 PDF、Word、Markdown 一键变成设计师级 PPT。10 秒出稿，无需设计能力。
📄 论文答辩 / 📊 周报月报 / 📋 技术文档培训 / 💡 创业路演
# Install & setup
clawhub install doc2slides
bash ~/.openclaw/workspace/skills/doc2slides/setup.sh
# Go
python3 workflow.py --input report.pdf --output report.pptxDone. 一行命令，PPT 生成在本地。
Why doc2slides?
| | doc2slides | 模板方案 | AI 在线服务 | |--|-----------|---------|-----------| | 排版 | 18 种布局 AI 自动匹配 | 固定 2-3 种 | 有限 | | 图表 | 内置 SVG 饼图/柱状/进度环 | 手动插入 | 依赖模板 | | 隐私 | 默认本地，可选 LLM | 本地 | 上传云端 | | 费用 | 免费 | 免费 | 按次收费 | | 画质 | 3x 高清 (3840×2160) | 标清 | 取决于套餐 | | AI | GPT-4o / 智谱 / DeepSeek 可选 | 无 | 固定模型 |
Use Cases
- 论文答辩 — 把论文 PDF 变成答辩 PPT，自动提炼要点
- 周报月报 — Markdown 周报一键幻灯片，数据自动配图表
- 技术分享 — 技术文档转培训材料，代码块自动排版
- 创业路演 — 商业计划书变路演 PPT，金字塔/矩阵布局
- 读书笔记 — 长文拆解成结构化幻灯片
Agent Trigger
User says any of → activate:
- "把这个文档做成PPT" / "做个演示文稿"
- "Convert this PDF to slides"
- "Generate a presentation from..."
Workflow:
- First time?
bash setup.sh --verify - Missing deps? tell user
bash setup.sh - Ask: "有特殊要求吗？页数、风格、重点？没有我按默认来。"
- Locate input (path or URL)
- Generate:
cd ~/.openclaw/workspace/skills/doc2slides/scripts
python3 workflow.py --input <file> --output <file.pptx> [options]- Verify output, send to user
CLI Options
| Flag | Example |
|---|---|
--input | Required. PDF / DOCX / MD path |
--output | Required. Output .pptx path |
--pages N | Limit slide count |
--instruction "..." | Custom guidance |
--style corporate | Color: corporate / tech / nature / warm / minimal / dark_purple / finance |
--theme AI | Auto color by topic |
--model gpt-4o | LLM for analysis |
--preview | Also generate PNG screenshots |
# Example: business style, 8 pages, data focused
python3 workflow.py --input report.pdf --output report.pptx \
--instruction "商务风格，重点突出数据，控制在8页，每页配图表"Layouts (18+)
| Category | Layouts |
|---|---|
| Data | Dashboard, Big Number, KPI Cards, Chart |
| Structure | Pyramid, Comparison, 2x2 Matrix, Flow |
| Narrative | Timeline, Action Plan, Quote, Full-image |
| Content | Two-column, Three-column, Icon Grid, Vertical List |
| Visual | Progress Ring, Horizontal Bar, Stacked Cards |
Each section of your document gets auto-matched to the best layout.
Troubleshooting
| Problem | Fix |
|---|---|
ModuleNotFoundError: pptx | pip3 install python-pptx |
| No browser for screenshots | playwright install chromium |
| Chromium download timeout | apt install google-chrome-stable |
| Output blank/broken | Add --preview to debug HTML |
| Too slow for long docs | --pages N to limit |
Pipeline
Document → Analyze → Match Layouts → Build HTML → Render (3x) → PPTXDefault mode runs fully local — no CDN, no cloud. Optionally connect LLM providers (GPT-4o / 智谱 / DeepSeek) for smarter analysis when you configure API keys.
MIT-0 license.