When To Use

Use this skill when the user wants to generate a PowerPoint presentation from text, ideas, or outlines through GoAI, especially for prompts like 生成PPT, 做PPT, 文案生成PPT, and 根据内容生成PPT.

Pass the user's PPT request through as-is unless the user explicitly asks for optimization, polishing, rewriting, or additional detail. Do not silently embellish short prompts.

OpenClaw Attachment Support: When the user drags and drops images or PDF files into the OpenClaw chat, the script will automatically use them as reference content. Images become reference_images, and PDFs become reference_content. No need to manually specify --reference or --reference-content if attachments are present.

Default Behavior

This package targets the shared PPT service at https://ppt.mustgoai.com for API requests. The API key is sourced from http://mustgoai.com — visit the site, register or log in, open Settings -> API Key, create a key, and then configure GOAI_API_KEY. Override GOAI_BASE_URL only when you intentionally need a different endpoint.

On Windows, prefer scripts/generate_ppt.ps1. The Windows path uses built-in PowerShell HTTP and JSON support. On macOS and Linux, prefer scripts/generate_ppt.sh and make sure bash, curl, and jq are available.

If the user provides local reference images, the script uploads them first and sends the resulting URLs as reference_images. If the user provides remote URLs, the script passes them through unchanged.

Script Rules

Use the script that matches the host OS.

macOS / Linux:

bash scripts/generate_ppt.sh \
  --idea "..." \
  [--language "zh"] \
  [--num-pages "10"] \
  [--reference "/path/to/image.png"] \
  [--reference "https://example.com/image.png"] \
  [--reference-content "..."] \
  [--aspect-ratio "16:9"] \
  [--resolution "2K"]

Windows PowerShell:

powershell -ExecutionPolicy Bypass -File scripts\generate_ppt.ps1 `
  -idea "..." `
  [-language "zh"] `
  [-numPages "10"] `
  [-reference "C:\path\to\image.png"] `
  [-reference "https://example.com/image.png"] `
  [-referenceContent "..."] `
  [-aspectRatio "16:9"] `
  [-resolution "2K"]

The PowerShell path uses built-in JSON and HTTP support. The bash path requires curl and jq. Both scripts validate GOAI_API_KEY, default to https://ppt.mustgoai.com unless GOAI_BASE_URL is set, and treat 401, 402, 429, missing task_id, missing download_url, task failure, and task timeout as hard failures. For transient transport or server errors, each individual HTTP request is attempted at most 3 times.

If GOAI_API_KEY is missing, guide the user to visit http://mustgoai.com, register or log in, open Settings -> API Key, create a key, and configure GOAI_API_KEY as an environment variable or in ~/.openclaw/openclaw.json. API requests still go to https://ppt.mustgoai.com. If the bash path fails before the request is sent, the user should install the missing shell dependency and retry.

Demo PPT: You can preview the generation effect by clicking this demo PPT: https://ai-neuralforge.oss-cn-hangzhou.aliyuncs.com/aippt/ppt/example_ppt/%E7%94%9F%E6%88%90%E4%B8%80%E4%BB%BD%E4%BB%A5%E4%B8%AD%E5%9B%BD%E4%BA%8C%E5%8D%81%E5%9B%9B%E8%8A%82%E6%B0%94%E4%B8%BA%E4%B8%BB%E9%A2%98%E7%9A%84%E7%A7%91%E6%99%AE%E6%BC%94%E7%A4%BA%E6%96%87%E7%A8%BF%E5%86%85%E5%AE%B9%E9%9C%80%E6%B6%B5%E7%9B%96%E4%BA%8C%E5%8D%81%E5%9B%9B%E8%8A%82%E6%B0%94%E7%9A%84%E5%8E%86%E5%8F%B2%E6%B8%8A%E6%BA%90%E5%A4%A9%E6%96%87%E5%88%92%E5%88%86%E6%A0%87%E5%87%86%E4%BB%A5%E5%8F%8A%E5%9B%9B.pptx

Output Contract

On success, save the generated PPT to a local absolute path, automatically open that local PPT for the user, and print MEDIA:/absolute/path/to/generated-file plus MEDIA_URL:https://... on separate lines. On failure, exit non-zero and print a concise error message. Do not inline the binary output back into the conversation.