OpenClaw 接入说明
如果团队已经在 OpenClaw 中编排工作流,可以安装 AiPPT skill 直接生成 PPTX,不需要另做前端页面。这个路径的主要工作是安装 skill、配置开放平台凭证并验证文件下载。
OpenClaw 适用场景
| 项目 | 说明 |
|---|---|
| 页面承载 | 由 OpenClaw 承载,接入方无需开发新的前端页面 |
| 接入工作量 | 低,主要完成 skill 安装和 Key 配置 |
| 自定义范围 | 主要配置 Key、提示词和工作流上下文 |
| 最小验收 | 能在 OpenClaw 中触发 AiPPT skill,并下载 PPTX 文件 |
安装前准备
- 已完成开放平台申请。
- 已在开放平台工作台获取
App Key和Secret Key。 - 已具备可使用 OpenClaw 的账号和工作流环境。
如还没有开放平台凭证,请先阅读 接入路径总览。
1. 安装 AiPPT skill
在 OpenClaw 中发送以下安装提示词:
text
安装 AiPPT skill
技能下载地址:https://clawhub.ai/huiyuan1234/aipptskill2. 配置 Key
安装完成后,将 skill 中的 Key 配置替换为接入方的开放平台凭证:
text
将技能 AiPPTskill 中的 key 进行替换
API_KEY:替换为接入方的 App Key
API_SECRET:替换为接入方的 Secret Key接入凭证可在开放平台工作台中查看:
凭证安全
不要把真实 Secret Key 发送到公开对话、公开仓库或公开文档中。该凭证只用于接入方的 OpenClaw 工作流配置环境。
3. 触发一次 PPT 生成
配置完成后,在 OpenClaw 中输入生成需求,触发 AiPPT skill。生成输入支持主题、文本资料、文档内容或 URL。
示例:
接入完成的判断标准
| 验收项 | 通过标准 |
|---|---|
| skill 可用 | OpenClaw 能识别并调用 AiPPT skill |
| Key 配置正确 | 触发生成时不出现鉴权失败 |
| 生成成功 | 能根据输入生成 PPT 内容 |
| 结果可下载 | 能下载 PPTX 文件到本地 |
常见问题
| 问题 | 处理方式 |
|---|---|
| 提示 Key 无效 | 回到开放平台工作台确认 App Key 和 Secret Key 是否复制完整 |
| 无法触发 skill | 确认 AiPPT skill 是否安装成功,并检查 OpenClaw 工作流上下文 |
| 生成失败 | 检查输入内容是否为空、过短或不符合当前工作流要求 |
| 下载失败 | 重新触发生成,或确认 OpenClaw 是否允许下载生成文件 |
需要更多页面控制时
- 需要选择其他产品线或接入方式:阅读 产品线与接入方式选择。
- 需要自研页面和 API:阅读 API 快速开始。
- 需要嵌入完整页面:阅读 预装版 UI 接入。
