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 KeyAIPPT_SECRET_KEY是AiPPT 开放平台 Secret KeyAIPPT_UID否用户标识，多用户隔离用，默认 openclaw_default

安全要求：

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

每次执行前先判断场景#

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

text

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

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

text

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

首次配置#

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

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

高阶配置硬规则#

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

先执行：

bash

bash scripts/aippt.sh senior_options_pretty

或需要原始 JSON 时执行：

bash

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 不允许黑盒到底。所有场景都要让用户看到关键阶段：

text

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

大纲或结构确认要求：

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

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

禁止自动降级#

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

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

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

正确做法：

text

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

场景一：智能生成#

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

流程：

text

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

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。

流程：

text

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

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 再生成。

流程：

text

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

执行规则：

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

场景四：链接生成 PPT#

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

流程：

text

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

常用命令：

bash

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 单页生成#

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

流程：

text

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

执行规则：

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

企业模板#

生成前可检查企业模板：

bash

bash scripts/aippt.sh enterprise_templates

处理规则：

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

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

输出格式#

生成完成后，返回：

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

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

失败处理#

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

text

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

常见错误处理：

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

v4.0.1 验收标准#

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