前言¶

做汇报或培训时，常见做法是在幻灯片里从零排版：先列大纲，再逐页填标题和要点。交给通用对话模型写稿，往往还要自己整理成可演示的 .pptx，结构和版式仍要手工收尾。

下面介绍 SkillHub 上的 openclaw-new（坐标 @user_c3f30014/openclaw-new）。它把「主题 → 结构化演示文稿」写成 Agent 可执行的 Skill 约定：先对主题做语义压缩，再按固定命令触发生成，面向商务、技术与培训等需要成稿演示的场景。

这是什么¶

openclaw-new 是社区来源（community）的办公效率类 Skill，当前版本 1.0.0，由 SkillHub 用户 user_c3f30014 发布，分类为 office-efficiency。官方简介为：

Generate professional, structured PowerPoint presentations from optimized topic keywords.

（从优化后的主题关键词生成专业、结构化的 PowerPoint 演示文稿。）

Skill 元数据指向讯飞星火 PPT 相关文档（https://www.xfyun.cn/doc/spark/PPTv2.html），执行前需配置 XF_PPT_APP_ID、XF_PPT_API_SECRET 等环境变量；SkillHub 标签标明 requires_api_key=true。在 SkillHub 页面可见评分 100000、下载 738、安装 0（统计以页面/接口展示为准）。

Skill 包内 frontmatter 中的内部名称为 ppt-generator，与商店展示名 openclaw-new 并存；安装与搜索时以坐标 @user_c3f30014/openclaw-new 为准。

核心功能¶

依据 Skill 包中的 SKILL.md，已写明的能力包括：

1. 自动幻灯片大纲：根据优化后的主题生成完整 deck 的结构层次。
2. 逻辑层级：强调清晰的章节与页面组织，便于汇报使用。
3. 商务向版式：输出描述为「presentation-ready」、多层级页面与商务标准排版（具体版式以讯飞 PPT 服务实际返回为准）。
4. 单次确定性生成：一次调用生成一份完整 PPT，不鼓励把原始口语需求直接丢给脚本。

Skill 还要求调用方在触发前对主题做 语义压缩优化（见下文「典型用法」），而不是把用户的原话未经整理传入。

安装与启用¶

安装 SkillHub CLI¶

若本机尚未安装 skillhub，可先按官方安装说明检查或安装：

command -v skillhub && skillhub --version

未安装时，可使用官方推荐的一键脚本（完整安装含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装 openclaw-new¶

安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被当前客户端识别。官方页面给出的安装提示为：参考 https://skillhub.cn/install/skillhub.md，安装 @user_c3f30014/openclaw-new。

命令行安装示例（命名空间与 SkillHub 搜索结果一致）：

skillhub install openclaw-new --namespace user_c3f30014 --dir <你的 Agent skills 目录>

常见客户端 skills 路径（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后，按所用客户端要求重启或刷新 Skill 列表，使 Agent 能加载新 Skill。

环境与 API¶

SKILL.md 要求：

• 系统 PATH 中可用 Python；
• 配置环境变量：

export XF_PPT_APP_ID=your_app_id
export XF_PPT_API_SECRET=your_api_secret

密钥需自行在讯飞开放平台申请并与星火 PPT 能力对应；Skill 文档未替代官方账号与计费说明，开通与配额以讯飞文档为准。

典型用法¶

1、先优化主题，再调用¶

Skill 对「最终主题」有硬性约定：

• 约 5–10 个词（英文场景为词；中文场景按 Skill 示例使用简短报告式标题）；
• 正式报告式标题，领域明确；
• 不要口语化、不要完整长句。

文档中的对照示例：

Agent 在启用本 Skill 后，应先把用户意图收敛为上表这类短语，再进入生成步骤。

2、执行生成命令¶

SKILL.md 规定的调用方式为（{baseDir} 为 Skill 安装目录）：

python {baseDir}/scripts/index.py generate_ppt "<optimized-topic>"

英文示例：

python {baseDir}/scripts/index.py generate_ppt "Artificial Intelligence Industry Trends"

经过上面的步骤，一次调用对应一份完整 PPT 文件；文档列出的输出特征包括结构化页面、多级组织与可直接用于演示的内容布局。

3、在对话里怎么用¶

向已加载该 Skill 的 Agent 说明演示场景与受众，并确认主题已按 Skill 约定压缩。例如：「请按 openclaw-new 规则，把主题定为『公司年度技术规划』，生成汇报用 PPT。」Agent 应检查环境变量与 Python，再执行文档中的 generate_ppt 流程。

适用场景与注意¶

适合谁

• 需要快速从「已定主题」落到 .pptx 的业务汇报、战略规划、技术分享、内部培训或学术摘要等场景；
• 已在用 Cursor、Claude Code、Codex 等支持 Skill 的客户端，并愿意配置讯飞 PPT 相关密钥的团队或个人。

限制与注意

1. API 依赖：无 XF_PPT_APP_ID / XF_PPT_API_SECRET 无法按文档执行；SkillHub 标记需要 API Key。
2. 主题契约：禁止把用户原始长句直接传给生成脚本，否则与 Skill 设计不符，结构质量也无法保证。
3. 单次输出：一次调用只生成一份 deck；文档提到的页数、语言、主题皮肤等扩展能力标注为后续可能增强，当前版本以 SKILL.md 正文为准。
4. 安装包内容：通过 skillhub install 拉取的 1.0.0 包在本地仅包含 SKILL.md 时，需自行确认是否另有 scripts/index.py 或需从发布者更新包；执行前应在 Skill 目录下检查 scripts/ 是否存在，避免命令路径落空。

结尾¶

openclaw-new 把「主题优化 + 命令式生成」写进 Skill，让 Agent 在办公场景里按同一套契约产出结构化 PowerPoint，而不是只输出大纲文本。安装、路径与环境变量按 SkillHub 与 SKILL.md 配置即可接入。

官方入口：

• SkillHub 页面：https://www.skillhub.cn/skills/user_c3f30014/openclaw-new
• API 坐标页：https://api.skillhub.cn/user_c3f30014/openclaw-new