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.pptx
Done. 一行命令，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) → PPTX
Default 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.