运行时依赖
安装命令
点击复制本土化适配说明
Aippt.Skip — AIppt.Skip 安装说明: 安装命令:["openclaw skills install aippt-skip"]
技能文档
AIPPT 技能 — AI 智能 PPT 生成 通过智绘高迪 Design Agent API,根据用户的文字描述自动生成专业 PPT。
使用方式 Windows 用户:所有 bash 命令请替换为对应的 powershell -ExecutionPolicy Bypass -File 版本,详见下方双版本示例。 Windows 下使用 python 而非 python3。
调用前必须输出提示(MANDATORY) 在执行脚本之前,必须先向用户输出以下温馨提示: > 温馨提示 > PPT 后台生成过程会持续消耗积分;如需终止任务,请点击下方链接进入智绘高迪平台操作。每张PPT平均消耗约0.5积分。
生成 PPT macOS / Linux: # 用法 — 只需 prompt PROMPT="制作一个关于人工智能发展趋势的商业演示" bash __SKILL_DIR__/scripts/generate.sh
Windows (PowerShell): # 用法 — 只需 prompt $env:PROMPT="制作一个关于人工智能发展趋势的商业演示"; chcp 65001 >nul; powershell -ExecutionPolicy Bypass -File "__SKILL_DIR__/scripts/generate.ps1"
参数说明 环境变量 必填 说明 PROMPT PPT 内容描述,越详细越好
输出格式 脚本调用 Gateway 代理,Gateway 等待智绘 API 返回 started 事件后立即返回 JSON 结果: 开始生成 PPT... 任务已启动,PPT 正在后台生成中 PPT 生成任务已提交! 结果: { "projectId": "69def187a7e1519b00d4708e", "workspaceUrl": "https://goatdee.qq.com/ppt/69def187a7e1519b00d4708e", "message": "PPT 任务已启动,正在后台生成中。你可以通过以下链接查看和编辑:..." } 编辑地址: https://goatdee.qq.com/ppt/69def187a7e1519b00d4708e
结果展示 将生成结果以 Markdown 格式展示给用户: PPT 生成任务已提交! PPT 正在后台生成中,预计需要 5-15 分钟。 在线编辑地址: 点击打开智绘高迪 你可以点击链接查看生成进度,完成后直接在编辑器中修改。如需终止任务,也请在该页面中操作。
工作原理 Skill 脚本发送 POST 请求到 Auth Gateway 的 /proxy/aippt/agent/run Gateway 注入模型凭证,转发到智绘高迪 Design Agent API(SSE 协议) Gateway 等待上游返回 started 事件,提取 projectId 拼接编辑地址 Gateway 立即返回 JSON 结果给脚本,不等待 PPT 生成完成 PPT 在后台异步生成,用户通过编辑地址查看进度和结果
编码要求(MANDATORY) 所有传递给接口的数据必须确保是 UTF-8 编码。 这是强制要求,违反将导致服务端收到乱码。 PROMPT 环境变量中的中文内容必须是 UTF-8 编码 Windows 下必须在脚本执行前通过 chcp 65001 切换控制台代码页为 UTF-8 HTTP 请求 body 必须以 UTF-8 编码发送,Content-Type 必须声明 charset=utf-8 禁止使用系统默认编码(如 GBK/GB2312)传递任何包含非 ASCII 字符的数据
关于页数的严格规则(MANDATORY) 除非用户在描述中明确指定了页数(如"生成10页PPT"、"做一个5页的演示"),否则绝对不要在 PROMPT 中自行添加、编造或暗示任何页数相关的内容。 错误做法:用户说"帮我做个关于AI的PPT",你在 PROMPT 里写"生成一个15页的AI主题PPT" 正确做法:用户说"帮我做个关于AI的PPT",PROMPT 直接写"制作一个关于AI的演示文稿",不提及页数 正确做法:用户说"帮我做一个8页的AI PPT",PROMPT 写"制作一个8页的关于AI的演示文稿" 页数由智绘高迪平台根据内容自动决定,不需要你来指定。擅自添加页数要求可能导致生成效果不符合预期。
注意事项 该 skill 调用远程 API,需要网络连接 Gateway 只等待 started 事件(通常几秒),不会因 PPT 生成耗时而超时 PPT 生成过程在后台进行,可能需要 5-15 分钟 如果用户需要编辑已有的 .pptx 文件,请使用 pptx skill 而非本 skill 如果 API 返回错误,检查网络连接并提示用户稍后重试
依赖 依赖 macOS / Linux Windows HTTP 请求 curl(系统自带) PowerShell Invoke-RestMethod(内置) JSON 解析 python3(系统自带) PowerShell ConvertFrom-Json(内置)