AI PPT 生成

该能力使 OpenClaw 智能体能够仅基于用户提供的主题生成 PPT 文件；如需，用户还可提供图片或资源文件，本工具可据此生成高质量的 PPT 文件。

配置要求

1. API Key：请确保已通过环境变量 BAIDU_API_KEY 设置有效的 API 密钥。
2. 运行环境：该 API 密钥需在运行时环境中可用。

API 接口列表

工作流程

1. PPTThemeQuery 接口执行位于 scripts/ppt_theme_list.py 的 Python 脚本
2. PPTOutlineGenerate 接口执行位于 scripts/ppt_outline_generate.py 的 Python 脚本
3. PPTGenerate 接口执行位于 scripts/ppt_generate.py 的 Python 脚本
4. 第一步：用户调用 PPT 样式查询接口（PPTThemeQuery）获取样式 ID 和模板 ID
5. 第二步：将第一步中查询到的样式 ID 和模板 ID 作为参数，调用 PPT 大纲生成接口（PPTOutlineGenerate）生成大纲（该接口采用 SSE 流式响应；此步骤依赖于第一步，若第一步失败，可中止后续请求）
6. 第三步：基于第二步生成的大纲，调用 PPT 智能生成接口（PPTGenerate），最终生成 PPT 文件（请求参数 outline 来源于大纲生成接口的返回结果，需将 SSE 流式响应聚合为完整 Markdown 格式输入；用户可对大纲进行编辑修改，但修改后的内容必须为标准 Markdown 格式，否则可能导致失败。此步骤严格依赖第二步，若第二步失败，则应中止请求）

API 详情

PPTThemeQuery API

参数

无参数

使用示例

BAIDU_API_KEY=xxx python3 scripts/ppt_theme_list.py

PPTOutlineGenerate API

参数

• query：PPT 标题或用户查询内容（必填）
• resource_url：资源文件 URL，例如 PDF、Word、TXT 等格式文件
• page_range：PPT 页数范围，仅支持以下枚举值：1-10、11-20、21-30、31-40、40+
• layout：PPT 布局方式，可选值：1、2（1：极简模式，2：专业模式）
• language_option：PPT 语言选项，可选值：zh、en（zh：中文，en：英文）
• gen_mode：PPT 生成模式，可选值：1、2（1：智能润色模式，2：创意模式）

使用示例

BAIDU_API_KEY=xxx python3 scripts/ppt_outline_generate.py --query "generate a ppt about the future of AI"

PPTGenerate API

参数

• query_id：来自 PPTOutlineGenerate 接口返回的 query_id（必填）
• chat_id：来自 PPTOutlineGenerate 接口返回的 chat_id（必填）
• outline：来自 PPTOutlineGenerate 接口返回的 PPT 大纲，必须为 Markdown 格式；用户可对内容进行适当编辑，包括增删改部分内容（必填）
• query：用户的原始查询内容（必填）
• title：来自 PPTOutlineGenerate 接口返回的 PPT 标题（必填）
• style_id：来自 PPTThemeQuery 接口返回的 PPT 样式 ID（必填）
• tpl_id：来自 PPTThemeQuery 接口返回的 PPT 模板 ID（必填）
• resource_url：资源文件 URL，例如 PDF、Word、TXT 等格式文件
• custom_tpl_url：用户自定义 PPT 模板的路径，必须可被下载
• gen_mode：PPT 生成模式，可选值：1、2（1：智能润色模式，2：创意模式）
• ai_info：是否在生成的 PPT 最后一页添加 AI 生成标识信息

使用示例

BAIDU_API_KEY=xxx python3 scripts/ppt_generate.py --query_id "xxx" --chat_id "xxx" ...