ClawHub

AiPPT-skill

Data & APIs

通过 AiPPT.cn 开放平台 API 智能生成专业 PPT 演示文稿，支持标题生成、联网智能生成、文件导入、URL导入、模板选择、导出大纲、回收站管理、自动导出下载

Install

openclaw skills install aipptskill

AiPPT Skill

通过 AiPPT.cn 开放平台 API，在对话中协作式生成 PPT。v4.0.1 强调安全鉴权、场景分流、过程感知、大纲修改、模板选择，不做黑盒一键到底。

触发条件

当用户提出以下任一需求时使用本 Skill：

  • 做 PPT、生成 PPT、创建演示文稿、制作幻灯片。
  • 根据主题、文档、PPT、链接生成 PPT。
  • 生成单页 PPT 或某一页幻灯片。
  • 修改生成前的大纲、选择模板、控制 PPT 页数/受众/语气/语言/模型。

前置条件

环境依赖：curl、python3、openssl。

凭证通过 clawhub.ai / OpenClaw 的技能设置或安全凭证入口配置，不要让用户在聊天里粘贴 AK / SK。

变量名必填说明
AIPPT_APP_KEY是AiPPT 开放平台 App Key
AIPPT_SECRET_KEY是AiPPT 开放平台 Secret Key
AIPPT_UID否用户标识，多用户隔离用，默认 openclaw_default

安全要求：

  • 不要要求用户在聊天中输入 AK / SK。
  • 如果用户把 AK / SK 发到聊天里，立刻提醒按泄露处理，并建议去 AiPPT 控制台重置 Secret Key。
  • 不要把真实 AK / SK 写入输出、日志说明、README、截图说明或生成文件。
  • Skill 只使用环境变量或平台安全凭证读取密钥。

每次执行前先判断场景

用户发来 PPT 需求后，先按输入判断 5 类场景：

有明确“单页/一页/生成某一页”诉求
  → AI 单页生成
有 PPT / PPTX 附件
  → 导入 PPT 生成
有 Word / PDF / TXT / Markdown / WPS 等文档附件
  → 文档上传 / Word 导入
有 URL 链接
  → 链接生成 PPT
只有主题 / 标题 / 需求描述
  → 智能生成

如果用户同时上传文件又给主题，先问清楚文件用途：

您希望怎么使用这份文件？
1. 直接按文件内容生成 PPT
2. 把文件作为参考资料，围绕您给的主题重新生成 PPT

首次配置

首次使用或用户要求调整默认设置时，先收集配置：

  • 是否需要编辑大纲：默认是。
  • 是否逐节点确认大纲：默认否。
  • 每次返回模板数量：默认 6，可选 3 / 6 / 9 / 12。
  • 是否使用企业模板：如接口返回企业模板，优先询问用户。

高阶配置硬规则

不要凭常识、用户画像或主题自行编造高阶配置选项。高阶配置必须先调用接口拉取真实枚举，再基于返回的 id / name / is_default 询问用户。

先执行：

bash scripts/aippt.sh senior_options_pretty

或需要原始 JSON 时执行：

bash scripts/aippt.sh senior_options

执行规则：

  • 只展示接口返回的真实配置组和枚举项。
  • 传参给任务创建接口时，必须按配置组 key 组装 JSON 对象字符串，不是数组。
  • 正确结构：{"page":3,"group":6,"scene":18,"tone":40,"language":47}。
  • 其中 page / group / scene / tone / language 来自 senior_options 返回的父级 key，值来自用户选择的子项 id。
  • 推荐传参写法：--options '{"page":3,"group":6,"scene":18,"tone":40,"language":47}'，可以放在标题后，也可以放在位置参数后。
  • 不要把“LOL 玩家”“大众泛用户”等自行推断的受众写成选项；除非它们真实出现在 senior_options 返回中。
  • 不知道枚举 ID 时，先拉接口，不要追问用户自由输入。
  • 如果接口返回失败，使用默认配置或询问是否跳过高阶配置，不要伪造枚举。

只有以下场景展示高阶配置，且配置项以接口返回为准：

场景高阶配置
智能生成页数、受众、场景、语气、语言、切换模型、是否打开联网搜索、内容是否是参考文档
文档上传 / Word 导入保持原文、适当扩写、润色美化、切换模型；其中可由 AiPPT senior_options 支撑的项必须使用真实枚举

以下场景没有高阶配置，不要展示不存在的配置项：

  • 导入 PPT 生成
  • 链接生成 PPT
  • AI 单页生成

统一执行原则

v4.0.1 不允许黑盒到底。所有场景都要让用户看到关键阶段：

鉴权检查中
任务创建中
解析输入中
生成大纲中
等待大纲确认
保存大纲修改中
生成内容中
获取属性结构中
加载模板中
合成 PPT 中
生成完成
生成失败 / 可重试

大纲或结构确认要求：

场景确认方式
智能生成先生成大纲，再获取 PPT 树形结构，用户修改 / 确认后选择模板，最后用修改后的大纲生成内容并合成作品
文档上传 / Word 导入接口返回大纲+内容，随后获取 PPT 树形结构，用户修改 / 确认大纲和内容后选择模板并生成作品
导入 PPT 生成修改大纲，再选择模板
链接生成 PPT修改大纲，再选择模板
AI 单页生成确认 / 修改单页结构，不按完整多页大纲处理

获取 PPT 属性结构是大纲编辑的关键步骤：它用于把生成结果转为可编辑树形结构，保留页面顺序、父子关系、正文内容和页面类型，并为编辑大纲接口提供完整回写数据。不要只改标题文本后直接合成。

禁止自动降级

当某个场景接口返回未开通、无权限或 40008 时，必须停止当前流程并告知用户需要开通对应能力。

禁止在未获得用户明确确认时自动切换场景，例如：

  • Word / 文档导入未开通时，不要自动改成智能生成。
  • 导入 PPT 生成失败时，不要自动改成文档上传。
  • 链接生成失败时，不要自动复制网页文本改成智能生成。

正确做法：

当前失败阶段：文档导入
原因：该凭证未开通 Word / 文档导入能力
下一步：请联系管理员开通；或者由用户明确确认后，改用“提取文档文本 + 智能生成”的 fallback

场景一：智能生成

触发条件：用户只提供主题、标题或 PPT 需求描述。

流程：

1. 调用 senior_options_pretty 拉取真实高阶配置枚举
2. 基于真实枚举收集智能生成高阶配置
3. 将高阶配置组装成 senior_options JSON 对象，并在任务创建时传入
4. 创建任务
5. 生成大纲
6. 获取 PPT 树形结构 /api/generate/data
7. 展示完整大纲给用户
8. 用户修改 / 确认大纲
9. 加载模板，按用户配置返回指定数量
10. 用户选择模板
11. 提交编辑后大纲 /api/ai/chat/v2/outline/save
12. 用大纲生成内容 /api/ai/chat/v2/content
13. 等待内容完成
14. 合成作品 /api/design/v2/save
15. 导出并返回文件路径

高阶配置：

  • 页数
  • 受众
  • 场景
  • 语气
  • 语言
  • 切换模型
  • 是否打开联网搜索
  • 内容是否是参考文档

常用命令：

bash scripts/aippt.sh senior_options_pretty
bash scripts/aippt.sh generate "标题" --outline-only
bash scripts/aippt.sh generate "标题" --options '{"page":3,"group":6,"scene":18,"tone":40,"language":47}'
bash scripts/aippt.sh generate "标题" --model "deepSeek-v3" --web-search --options '{"page":3,"group":6,"scene":18,"tone":40,"language":47}'
bash scripts/aippt.sh generate_continue "<task_id>" "<title>"

执行规则：

  • v4.0.1 默认必须先用 generate ... --outline-only 生成大纲，不要默认使用一键完整 generate。
  • 只有用户明确说“不需要修改大纲 / 直接生成成品”时，才允许使用不带 --outline-only 的一键完整 generate。
  • 大纲生成后必须先展示给用户。
  • 如果用户开启“逐节点确认”，按章节逐个确认。
  • 用户未确认前，不进入内容生成和 PPT 合成。
  • 智能生成的模板选择必须发生在请求内容前；/api/ai/chat/v2/content 会带模板并基于确认后的大纲生成内容。
  • 不要在用户修改大纲前调用 /api/ai/chat/v2/content，否则会导致“改大纲”失效。

场景二：文档上传 / Word 导入

触发条件：用户上传 Word、PDF、TXT、Markdown、WPS 等文档，并希望基于文档生成 PPT。

流程：

1. 调用 senior_options_pretty 拉取真实高阶配置枚举
2. 基于真实枚举收集文档上传可支持的高阶配置
3. 将可支持的配置组装成 senior_options JSON 对象，并在任务创建时传入
4. 上传 / 解析文档
5. 获取大纲 + 内容 /api/ai/chat/v2/word
6. 获取 PPT 树形结构 /api/generate/data
7. 展示大纲和内容给用户
8. 用户修改 / 确认大纲和内容
9. 加载模板，按用户配置返回指定数量
10. 用户选择模板
11. 提交编辑后大纲和内容 /api/ai/chat/v2/outline/save
12. 合成作品 /api/design/v2/save
13. 导出并返回文件路径

高阶配置：

  • 保持原文
  • 适当扩写
  • 润色美化
  • 切换模型

常用命令：

bash scripts/aippt.sh senior_options_pretty
bash scripts/aippt.sh generate_from_file "文件绝对路径" --outline-only
bash scripts/aippt.sh generate_from_file "文件绝对路径" --options '{"page":3,"group":6,"scene":18,"tone":40,"language":47}'
bash scripts/aippt.sh generate_save "<task_id>" "<title>"

执行规则：

  • 文档上传接口返回大纲+内容后，必须进入 /api/generate/data 获取树形结构。
  • 用户确认或修改大纲和内容前，不直接合成 PPT。
  • 如果返回“功能未开通 / 40008”，停止并提示开通文档导入能力；不要自动切换到智能生成模式。

场景三：导入 PPT 生成

触发条件：用户上传 PPT / PPTX，并希望基于已有 PPT 再生成。

流程：

1. 上传 / 解析 PPT
2. 生成大纲或页面结构
3. 展示大纲给用户
4. 用户修改 / 确认大纲
5. 获取 PPT 属性结构
6. 加载模板，按用户配置返回指定数量
7. 用户选择模板
8. 合成 PPT
9. 导出并返回文件路径

执行规则：

  • 无高阶配置，不要展示高阶配置项。
  • 必须支持修改大纲和选择模板。

场景四：链接生成 PPT

触发条件：用户提供 URL，并要求根据链接内容生成 PPT。

流程：

1. 创建 URL 任务
2. 解析链接内容
3. 生成大纲
4. 展示大纲给用户
5. 用户修改 / 确认大纲
6. 获取 PPT 属性结构
7. 加载模板，按用户配置返回指定数量
8. 用户选择模板
9. 合成 PPT
10. 导出并返回文件路径

常用命令：

bash scripts/aippt.sh create_from_url "https://..."
bash scripts/aippt.sh link "<task_id>"
bash scripts/aippt.sh generate_save "<task_id>" "<title>"

执行规则：

  • 无高阶配置。
  • 不展示联网搜索开关。
  • 链接解析本身就是输入处理能力，不等同于智能生成的联网搜索。

场景五：AI 单页生成

触发条件：用户明确要求生成一页、单页、封面页、目录页、总结页或某个指定页面。

流程：

1. 理解单页需求
2. 生成单页结构
3. 展示单页结构给用户
4. 用户确认 / 修改单页结构
5. 生成单页 PPT
6. 导出并返回文件路径

执行规则：

  • 无高阶配置。
  • 不按完整多页大纲处理。
  • 展示“单页结构确认”，例如：页面标题、核心信息、布局方向、视觉风格、关键元素。

企业模板

生成前可检查企业模板：

bash scripts/aippt.sh enterprise_templates

处理规则：

返回结果处理方式
无企业模板使用普通模板列表
有企业模板优先询问用户是否使用企业模板

模板列表展示数量必须受首次配置控制，默认返回 6 个。

输出格式

生成完成后，返回：

  • PPTX 文件路径。
  • 如有导出 PDF / Word / PNG，也返回对应文件路径。
  • 简短说明使用的场景、模板、是否修改过大纲。

不要返回真实 AK / SK、token、签名、内部请求 header。

失败处理

任一阶段失败时，必须说明失败阶段和下一步动作：

当前失败阶段：生成大纲
可能原因：内容审核未通过 / 模型生成失败 / 任务不存在 / 鉴权失败
建议动作：修改主题后重试 / 检查凭证 / 重新创建任务

常见错误处理：

问题处理
鉴权失败检查技能设置中的 AK / SK，不要让用户在聊天里贴密钥
余额不足提示充值后重试
内容审核失败请用户修改主题或内容
模板不可用换模板或使用普通模板
任务过期重新创建任务

v4.0.1 验收标准

  • 五个场景都能被正确识别并进入对应流程。
  • 智能生成、文档上传展示高阶配置。
  • 导入 PPT、链接生成 PPT、AI 单页生成不展示高阶配置。
  • 智能生成先生成大纲，获取 PPT 树形结构，用户确认 / 修改大纲并选择模板后，再调用内容生成。
  • 文档上传 / Word 导入获取大纲+内容后，必须进入树形结构编辑和 outline/save，再生成作品。
  • 导入 PPT 生成支持修改大纲和选择模板。
  • 链接生成 PPT 支持修改大纲和选择模板，不展示联网搜索开关。
  • AI 单页生成展示单页结构确认。
  • 模板返回数量受配置控制。
  • AK / SK 不进入聊天上下文。
  • 用户修改大纲后，必须回写后再继续合成。
  • 失败时展示失败阶段和可重试动作。
More in Data & APIs