演示文稿生成

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install presentation-generation
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 presentation-generation。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Presentation Generation 是一项 Openclaw Skills 工作流，可将简报、TXT、Markdown、DOCX、PDF、CSV 和 XLSX 文件转换为可审阅的 6–15 页演示大纲，随后导出可编辑的 PPTX、PDF 和逐页 PNG。它会保留位置来源引用，因此可以根据固定的章节 ID 追溯各项主张。
此技能结合 AI Skills platform API 与本地 PptxGenJS 4.0.1、LibreOffice 和 Poppler 处理流程。它不会在互联网上搜索图像、调用图像生成服务，也不要求用户配置第三方付款凭证，因此适用于受控且以来源为依据的演示文稿制作。

应用场景

将业务简报、报告或文档转换为精简的高管演示文稿。
将 CSV 或 XLSX 数据转换为指标卡、表格、图表和时间线幻灯片。
根据已批准的来源材料，创建可编辑的客户、项目、战略、培训或内部评审演示文稿。
创建带有可追溯引用的演示文稿，用于支持数值结论和事实主张。
在最终生成文件前审阅并修改大纲。
生成可供编辑的 PPTX 文件，同时提供 PDF 和逐页 PNG 预览。
处理私密来源材料，同时避免工作流编造 URL、路径、HTML、脚本、数据或远程图像。

工作原理

检查所提供的简报或受支持的来源文件，并在起草前报告可读取内容的覆盖范围。
从 TXT、Markdown、DOCX、PDF、CSV 或 XLSX 输入中提取来源内容和位置引用。
仅使用受支持的布局创建 6–15 页大纲：title、section、bullets、two-column、quote、metric-cards、table、chart、timeline 和 summary。
应用一种受支持的主题：clear、midnight 或 warm。
提交大纲供用户审阅，并允许用户修改标题、顺序、正文、项目符号、备注和布局，但不得更改来源引用。
要求每项数值结论都引用一个固定的章节 ID；不得添加缺乏来源支持的事实、URL、路径、HTML、脚本、模板或远程图像。
只有在用户明确请求生成文件后，才将已批准的大纲提交给演示文稿生成操作。
轮询任务直至其达到终止状态；如果网络结果不确定，则保留原始 Idempotency-Key 并使用完全相同的输入。
使用 PptxGenJS 在本地生成可编辑的 PPTX，然后使用 LibreOffice 和 Poppler 创建 PDF 和逐页 PNG 输出。
交付前报告页数、主题、用户修改、来源引用和质量检查结果；区分 partial 结果与完整成功，并在对外发布或发送文件前另行取得授权。

配置指南

在 AI Skills platform 创建或登录帐户，启用 Presentation Generation 产品，并在 API key 管理中创建 API 密钥。
在 OpenClaw 中安装此技能。
确认所需的 curl 二进制文件可用。配置所需的 API 密钥并重启 OpenClaw Gateway：
openclaw config set env.PRESENTATION_GENERATION_API_KEY "your-platform-api-key"
openclaw gateway restart
如需使用非默认 API 根地址，可选配置 AI_SKILLS_API_URL。
将 API 密钥保存在环境变量中，不要将其嵌入源文件或提示中。
使用此技能前，请确认可以访问来源文件，并确保用户了解检查 → 大纲 → 批准生成的流程。只有在审阅大纲并获得用户明确批准后，才能执行最终生成步骤。

数据架构

受支持的来源输入
输入 用途
简报、TXT、Markdown 叙述性内容和演示文稿背景
DOCX、PDF 文档文本和位置来源引用
CSV、XLSX 用于表格、指标和图表的结构化数据
大纲分类
布局： title、section、bullets、two-column、quote、metric-cards、table、chart、timeline、summary
主题： clear、midnight、warm
引用模型： 事实和数值主张引用固定来源的 section ID 值；编辑可以更改演示内容，但不得更改来源引用。
可编辑字段： 标题、幻灯片顺序、正文、项目符号、备注和布局。
生成的文件和元数据
可编辑的 PPTX 演示文稿。
PDF 导出文件。
逐页 PNG 预览。
交付元数据，包括页数、所选主题、用户修改、来源引用和质量检查结果。
任务状态，包括终止完成状态，以及在 PPTX 可交付但预览或质量检查尚未完成时的 partial 结果。
请求连续性元数据，例如原始 Idempotency-Key；网络响应不确定时，必须保留该值以便核对。
工作流通过当前用户的私人下载入口交付文件，并且在编辑过程中不会修改来源引用。

高级特性

基于来源生成，并使用固定章节 ID 使数值结论可供审计。
在进行成本较高或最终文件生成前，由人工参与并批准大纲。
导出为多种格式：可编辑的 PPTX、PDF 和逐张幻灯片的 PNG 预览。
通过 PptxGenJS 4.0.1、LibreOffice 和 Poppler 在本地渲染。
使用受限的布局和主题分类，确保演示文稿结构一致且可预测。
在网络响应不确定时，保留
Idempotency-Key
并使用完全相同的输入，以幂等方式处理任务。
轮询直至终止状态，并明确处理完整结果与
partial
结果。
注重隐私的运行方式：不进行远程图像搜索、不调用图像生成服务，也不编造外部资源。
对发布、发送或将生成文件写入外部系统设置单独的授权界限。
按需选择性读取参考资料，让代理根据当前任务加载相关的 API、操作、HTTP 或行为文档，而不必预先阅读所有文档。

name: presentation-generation description: "使用场景: 用户要求把简报、文档或表格整理为带来源引用的可编辑演示文稿时。" license: MIT-0