goai-ppt-gen

Generate PowerPoint presentations via GoAI API. Use when the user asks to create, generate, make, or build PPT, slides, presentations, including Chinese requests like 生成PPT, 生成PPT, 做PPT, 做演示文稿, 生成幻灯片, and 文案生成PPT.

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

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

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.