What makes chatppt-agent notable?

1K downloads. Trust evidence available

How should chatppt-agent be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

chatppt-agent

使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。 Skill: chatppt-agent Owner: kahn520 Summary: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-04-24T09:33:17.015Z | user No functional or documentation changes detected in this version. - Version updated to 1.0.4 with no file or SKILL.md changes. - Behavior and documentation remain the sam

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.0k

Updated

Oct 11, 2026

Version

1.0.4

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.4release · observed Apr 24, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s178cb2g33fbhtnmpv2n13qca584536g:chatppt-agent

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-kahn520-chatppt-agent/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

46,801 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: chatppt-cli
description: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。
---

# ChatPPT CLI Skill

## 环境准备

### CLI 安装
运行npm命令进行安装，安装前先检查是否已存在chatppt命令。

```bash
npm install -g @yooai/cli
```

安装后可运行chatppt命令进行调用，比如：
```bash
chatppt --help
```

### 全局 Flag

| Flag | 说明 |
|------|------|
| `--config string` | 配置文件路径（默认 `$HOME/.chatppt/config.yaml`） |
| `-d, --debug` | 启用调试模式 |
| `-f, --format string` | 输出格式：`json`（默认）/ `table` / `pretty` |
| `-h, --help` | 帮助 |
| `-v, --version` | 版本 |

---

## 标准工作流

```
1. 检查登录状态（auth status
2. 未登录 → 执行登录（auth login）
3. 生成 PPT（ppt generate 或 ppt import_file）
4. 自动轮询等待结果（直到 `2` 或 `3`）
5. 询问用户要直接下载pptx文件还是跳转到线上编辑器
```

### Agent 执行强约束（必须遵守）

1. **严格流程顺序**：始终按“检查登录 -> 登录（如需要） -> 生成 PPT -> 轮询结果”执行，不得跳步。
2. **路径二选一**：在生成前必须询问用户选择：
   - 普通生成路径
   - 绘图生成路径
3. **自动提取参数**：先从用户输入中自动提取可识别参数值；仅对缺失且必要的信息追问用户。
4. **用户不想配置参数**：若用户明确表示不关心参数或不想填写，全部使用默认值发起请求。
5. **轮询展示图片**：轮询期间如果返回 `images.urls`，可直接把图片链接展示给用户。
6. **成功即停止**：当任务状态为 `2`或`3` 后，仅返回成功结果与关键信息，不执行任何后续操作（后续接口未就绪）。
7. **Web Search 收费确认**：`--web-search` 涉及额外收费，启用前必须先告知用户并获得明确确认；未确认则按关闭处理（传 `--web-search=false`）。
8. **如果已经进入到了自动轮询流程中，要一直等待轮询成功或失败，不能在轮询过程中又进行生成。如果是Agent手动轮询，也需要轮询到成功或失败，不能中途停止对话等待用户继续输入。**
9. **如果轮询接口返回了失败，不要再次生成，要询问用户是否要再次生成。**
10. **如果用户权益用完了，提示用户去clawppt官网 <https://chat-ppt.com/openclaw> 进行充值点数。**

### 参数提取与追问规则（Agent）

1. **先提取后追问**：先从用户自然语言中提取参数（主题、路径选择、样式参数等），再补问缺失信息。
2. **最小追问原则**：仅追问生成任务必需信息（如 `主题` 或导入时的 `文件路径`）。
3. **路径参数边界**：
   - 普通生成路径只处理：`font-name`、`theme-color`、`ai-picture`、`image-style`、`template-id`、`custom-template-id`、`custom-page-count`
   - 绘图生成路径只处理：`banana-style-id`、`banana-doc-type`、`banana-reference-image`
4. **默认值策略**：若用户明确“不想设置参数/你看着办/默认就行”，则所有未指定参数使用默认值，不再反复追问。
5. **收费项单独确认**：`web-search` 为额外收费项，不能并入“默认就行”；必须单独征得用户同意后才启用。

### 确认普通生成与绘图生成路径后的参数提取与追问规则（Agent）
1. **模板风格确认**：在普通生成和绘图生成中，都需要询问用户是否需要预览模板风格并指定模板生成。
   - 普通生成路径参数：`template-id`
   - 绘图生成路径参数：`banana-style-id`
2. **普通生成路径中的图片风格确认**：在普通生成中询问用户是否需要指定AI图片风格，如果指定了，则参数--ai-picture必须等于true。参考--image-style参数获取方式。
3. **绘图生成排版风格确认**：在绘图模式中还需要确认用户是否需要指定排版样式，如果需要，参考--banana-doc-type参数获取方式。

---

## 命令速查

| 目标 | 命令 |
|------|------|
| 查看登录状态 | `auth status` |
| 登录 | `auth login` |
| 登出 | `auth logout` |
| 刷新令牌 | `auth refresh` |
| 生成 PPT（主题文字） | `ppt generate "主题"` |
| 生成绘图PPT（主题文字） | `ppt generate_banana "主题"` |
| 生成 PPT（文件导入） | `ppt import_file "/path/to/file"` |
| 生成绘图PPT（文件导入） | `ppt import_file_banana "/path/to/file"` |
| 查询 PPT 结果 | `ppt result <ppt_id>` |
| 查看配置 | `config show` |
| 重载配置 | `config reload` |
| 查看版本 | `version` |

---

## chatppt auth — 认证管理

所有 PPT 生成命令都需要先登录。

```bash
# 查看当前登录状态
chatppt auth status

# 登录（默认自动打开浏览器）
chatppt auth login

# 登录但不自动打开浏览器
chatppt auth login --no-browser

# 刷新令牌（令牌即将过期时使用）
chatppt auth refresh

# 登出
chatppt auth logout
```

**典型返回（status）**
```json
{
  "success": true,
  "code": 200,
  "data": {
    "is_logged_in": true,
    "user": { "id": "string

_meta.json

{
  "ownerId": "kn7akw0m5rtgarw268vaxsqap182sxw9",
  "slug": "chatppt-agent",
  "version": "1.0.4",
  "publishedAt": 1777023197015
}

skill-card.md

## Description:

Uses the ChatPPT CLI to generate PowerPoint presentations from a topic or from Word, PDF, Markdown, or text files, including login, generation, import, polling, download, and editor-link workflows.

This skill is ready for commercial/non-commercial use.

## Publisher:

[kahn520](https://clawhub.ai/user/kahn520)

### License/Terms of Use:

MIT-0

## Use Case:

External users and developers use this skill to drive ChatPPT CLI workflows that turn prompts or existing documents into PPT presentations and retrieve finished results.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Global npm installation and CLI execution can affect the local environment.

Mitigation: Install and run the CLI in a restricted or disposable environment and avoid elevated npm installs unless explicitly required.

Risk: Document-import workflows upload local content to the ChatPPT/Baidu BOS-backed service.

Mitigation: Do not upload confidential documents unless the user is comfortable sending their contents to that service.

Risk: Authentication and storage configuration can expose AK/SK values, passwords, tokens, or raw auth config if logged or pasted.

Mitigation: Avoid displaying or storing raw credential material in chat logs, command output, or shared artifacts.

## Reference(s):


## Skill Output:

**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]

**Output Format:** [Markdown guidance with shell commands and JSON response examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Single-stream agent guidance; generated PPT files and links are produced by the ChatPPT service.]

## Skill Version(s):

1.0.4 (source: evidence.release.version)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.