Xpersona
agentCLAWHUBUnverified

Zopia Skills

Zopia AI 视频创作技能 - 通过 Zopia 平台的 AI Agent 进行视频/图片创作。覆盖场景包括：AI 视频生成（文生视频、图生视频）、AI 图片生成（角色设定图、分镜关键帧）、剧本创作（对话/旁白/场景描述）、角色设计、分镜设计、多集连续剧制作。当用户提到 zopia、视频创作、短剧制作、分镜、... Skill: Zopia Skills Owner: lambdua Summary: Zopia AI 视频创作技能 - 通过 Zopia 平台的 AI Agent 进行视频/图片创作。覆盖场景包括：AI 视频生成（文生视频、图生视频）、AI 图片生成（角色设定图、分镜关键帧）、剧本创作（对话/旁白/场景描述）、角色设计、分镜设计、多集连续剧制作。当用户提到 zopia、视频创作、短剧制作、分镜、... Tags: latest:1.1.0 Version history: v1.1.0 | 2026-04-25T06:10:40.625Z | user 新增分镜/角色场景图模型配置，支持 GPT Image 2 v1.0.2 | 2026-04-08T08:59:21.688Z | user 新增 Seedance 2.0 Fast 和 PixVerse C1 模型，更新 Seedance 2.0 名称 v1.0.1 | 2

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

3.8k

Updated

Oct 9, 2026

Version

1.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 3.8K downloads reported by the source. Last updated 10/9/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 9, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 9, 2026
Adoption signal
3.8K downloadsadoption · observed Oct 9, 2026
Latest release
1.1.0release · observed Apr 25, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s178f21p50r99865h2g2798kzh83md9g:zopia-skill
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. 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-lambdua-zopia-skill/snapshot"

Documentation

CLAWHUB

51,042 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: zopia-skill
description: Zopia AI 视频创作技能 - 通过 Zopia 平台的 AI Agent 进行视频/图片创作。覆盖场景包括：AI 视频生成（文生视频、图生视频）、AI 图片生成（角色设定图、分镜关键帧）、剧本创作（对话/旁白/场景描述）、角色设计、分镜设计、多集连续剧制作。当用户提到 zopia、视频创作、短剧制作、分镜、角色设计、AI 视频生成时应触发。关键判断：只要用户的请求涉及通过 AI 进行系统化的视频创作流程（剧本→角色→分镜→视频），都必须触发此技能。
user-invocable: true
metadata:
  {
    "openclaw":
      {
        "emoji": "🎬",
        "requires":
          {
            "bins": ["python3"],
            "env": ["ZOPIA_ACCESS_KEY"]
          },
        "primaryEnv": "ZOPIA_ACCESS_KEY"
      }
  }
---

# Zopia AI 视频创作

Zopia 是一个项目制的 AI 视频创作平台。每个项目包含完整的创作流水线：**剧本 → 角色 → 分镜 → 视频**，由后端 AI Agent 自动驱动。你通过脚本管理项目、传达用户意图、追踪进度、获取成果。

## 环境配置

```bash
export ZOPIA_ACCESS_KEY="zopia-xxxxxxxxxxxx"   # 必需，30天有效
export ZOPIA_BASE_URL="https://zopia.ai"  # 可选
```

仅使用 Python 标准库，无需额外安装。

## 核心概念

| 概念 | 说明 |
|------|------|
| **Project (Base)** | 创作项目，包含设置、剧集、所有资产。创建时自动生成首集 |
| **Episode** | 剧集，同一项目下可创建多集，每集有独立的剧本/角色/分镜 |
| **Session** | 一次 Agent 对话。异步执行，通过轮询获取进展 |
| **Workspace** | 项目的实时工作区快照，包含角色(entities)、分镜(storyboard)、各媒体的生成状态 |

## 脚本速查

| 脚本 | 用途 | 关键参数 |
|------|------|---------|
| `create_project.py` | 创建项目 | `[名称]` |
| `save_settings.py` | 项目设置 | `--base-id` `--style` `--aspect-ratio` `--video-model` `--storyboard-image-model` `--entity-image-model` ... |
| `send_message.py` | 发送创作指令（异步） | `--base-id` `--episode-id` `消息` |
| `query_session.py` | 查询进展 | `SESSION_ID` `--poll` `--after-seq N` |
| `download_results.py` | 下载媒体资源 | `SESSION_ID` `--output-dir` `--type image\|video` |
| `get_balance.py` | 余额查询 | — |
| `list_projects.py` | 列出项目 | `--page` `--page-size` |
| `manage_episodes.py` | 剧集管理 | `list\|create\|delete` |
| `render_episode.py` | 合成最终视频 | `trigger\|status` `--base-id` `--episode-id` `--poll` |

## 项目设置参考

创建项目后，必须配置基础设置（locale / aspect_ratio / style）才能开始创作。

```bash
python3 {baseDir}/scripts/save_settings.py --base-id BASE_ID \
  --locale zh-CN --aspect-ratio 16:9 --style realistic_3d_cg
```

### 风格

| ID | 说明 |
|----|------|
| `anime_japanese_korean` | 日韩动漫 |
| `realistic_3d_cg` | 3D CG 写实 🔥 |
| `pixar_3d_cartoon` | Pixar 3D 卡通 |
| `photorealistic_real_human` | 真人写实 |
| `3D_CG_Animation` | 3D CG 动画 🔥 |
| `anime_chibi` | Q版可爱 |
| `anime_shinkai` | 新海诚 |
| `anime_ghibli` | 吉卜力 |
| `stylized_pixel` | 像素艺术 |

别名支持：`realistic` → `realistic_3d_cg`，`ghibli` → `anime_ghibli`，`shinkai` → `anime_shinkai`，`pixel` → `stylized_pixel`

### 视频模型 × 生成方式

不同模型支持不同的生成方式（generation_method），不匹配会报错。

| 模型 ID | 名称 | 支持的方式 | 默认 |
|---------|------|-----------|------|
| `generate_video_by_seedance_20` | Seedance 2.0 Pro ⭐ | n_grid, video_ref, multi_ref, multi_ref_v2 | video_ref |
| `generate_video_by_seedance_20_fast` | Seedance 2.0 Fast | n_grid, video_ref, multi_ref, multi_ref_v2 | video_ref |
| `generate_video_by_kling_o3` | Kling O3 | start_frame, n_grid, multi_ref, multi_ref_v2 | n_grid |
| `generate_video_by_kling_v3_0` | Kling V3.0 | start_frame, n_grid | n_grid |
| `generate_video_by_pixverse_c1` | PixVerse C1 | start_frame, multi_ref |

README.md

# Zopia Skills

Zopia AI 视频创作技能 — 通过 [Zopia](https://zopia.ai) 平台的 AI Agent 进行视频/图片创作。

覆盖场景：AI 视频生成（文生视频、图生视频）、AI 图片生成（角色设定图、分镜关键帧）、剧本创作、角色设计、分镜设计、多集连续剧制作。

## 安装

### 通过 npx 安装（推荐）

```bash
npx skills add 11cafe/zopia-skills
```

> [`skills`](https://github.com/vercel-labs/skills) 是 Vercel Labs 开发的跨平台技能安装 CLI，支持 Claude Code、Gemini CLI、Codex、Cursor 等 40+ 个 Agent。

安装到指定 Agent：

```bash
npx skills add 11cafe/zopia-skills -a claude-code
```

### 通过 OpenClaw 安装

在 [OpenClaw](https://openclaw.ai) 技能市场搜索 `zopia-skill`，或使用命令行：

```bash
npx clawhub install zopia-skill
```

### 手动安装

```bash
git clone https://github.com/11cafe/zopia-skills.git
```

将 `SKILL.md` 和 `scripts/` 目录复制到对应的技能目录：

| 范围 | 路径 |
|------|------|
| 个人全局 | `~/.claude/skills/zopia-skill/` |
| 项目级别 | `.claude/skills/zopia-skill/` |

## 配置

使用前需设置环境变量：

```bash
export ZOPIA_ACCESS_KEY="zopia-xxxxxxxxxxxx"   # 必需，30天有效
export ZOPIA_BASE_URL="https://zopia.ai"  # 可选，默认值即可
```

仅依赖 Python 标准库，无需安装第三方包。需要 `python3` 可用。

## 使用

安装技能后，在 Claude Code 中直接描述你的创作需求即可：

```
帮我做一个赛博朋克风格的短剧，讲一个机器人在废墟中寻找最后一朵花
```

技能会自动完成：创建项目 → 配置设置 → 发送创作指令 → 轮询进度 → 下载结果。

### 支持的风格

| ID | 说明 |
|----|------|
| `anime_japanese_korean` | 日韩动漫 |
| `realistic_3d_cg` | 3D CG 写实 |
| `pixar_3d_cartoon` | Pixar 3D 卡通 |
| `photorealistic_real_human` | 真人写实 |
| `3D_CG_Animation` | 3D CG 动画 |
| `anime_chibi` | Q版可爱 |
| `anime_shinkai` | 新海诚 |
| `anime_ghibli` | 吉卜力 |
| `stylized_pixel` | 像素艺术 |

### 支持的图片模型

分镜图（storyboard）与角色/场景图（entity）可分别配置，两者共享同一组可选值：

| 模型 | 名称 |
|------|------|
| `generate_image_by_nano_banana_2` | Nano Banana 2（storyboard 默认）|
| `generate_image_by_doubao_seedream_4` | Doubao Seedream 4（entity 默认）|
| `generate_image_by_nano_banana` | Nano Banana |
| `generate_image_by_gpt_image_2` | GPT Image 2 |

### 支持的视频模型

| 模型 | 名称 |
|------|------|
| `generate_video_by_kling_o3` | Kling O3 |
| `generate_video_by_kling_v3_0` | Kling V3.0 |
| `generate_video_by_hailuo_02` | Hailuo 2.3 |
| `generate_video_by_wan26_i2v` | Wan 2.6 |
| `generate_video_by_wan26_i2v_flash` | Wan 2.6 Flash |
| `generate_video_by_viduq2_pro` | Vidu Q2 Pro |
| `generate_video_by_viduq3_pro` | Vidu Q3 Pro |
| `generate_video_by_viduq3` | Vidu Q3 |
| `generate_video_by_seedance_15` | Seedance 1.5 Pro |

### 脚本列表

| 脚本 | 用途 |
|------|------|
| `create_project.py` | 创建项目 |
| `save_settings.py` | 配置项目设置 |
| `send_message.py` | 发送创作指令 |
| `query_session.py` | 查询创作进度 |
| `download_results.py` | 下载媒体资源 |
| `get_balance.py` | 查询余额 |
| `list_projects.py` | 列出所有项目 |
| `manage_episodes.py` | 管理剧集 |
| `render_episode.py` | 合成最终视频（MP4） |

## License

[MIT](LICENSE)

_meta.json

{
  "ownerId": "kn7d76nd4k7hjp2tdaybzem70x83mynm",
  "slug": "zopia-skill",
  "version": "1.1.0",
  "publishedAt": 1777097440625
}

CLAUDE.md

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## 项目定位

本仓库是 **Zopia AI 视频创作 Skill 包**，被 Claude Code / Gemini CLI / Codex / Cursor 等 Agent 通过 `npx skills add` 或 `npx clawhub install` 安装后调用。它本身不是后端服务，而是一组 Python 脚本 + 一份 `SKILL.md` 行为指引，封装对 Zopia 平台 HTTP API 的调用。

后端实现在姐妹仓库 `C:\code\jobCode\zipia\jaaz-cloud`（同 host 下的 `https://zopia.ai`），本仓库的脚本通过 HTTP 调用其接口。修改本项目时，若涉及接口字段、新模型 ID、新风格枚举等，对应能力须在 `jaaz-cloud` 已上线，否则脚本调用会报 400/404。

## 核心架构

```
SKILL.md            ← 行为契约：Agent 什么时候触发、如何组合脚本、典型场景、错误处理
README.md           ← 用户向：安装/配置/枚举值速查
scripts/_common.py  ← 唯一的共享层：urllib HTTP + Bearer 鉴权 + 业务级封装函数
scripts/*.py        ← 一脚本一动作，全是 argparse + _common 函数 + print_json 的薄壳
docs/               ← 维护者文档（如 publish-to-clawhub.md）
```

**只允许 Python 标准库**。`_common.py` 用 `urllib.request` 实现 HTTP，是有意为之——Skill 安装到用户机器后不能要求 `pip install`。新增脚本必须沿用这个约定，**不要引入 requests / httpx / pydantic 等第三方包**。

每个脚本的写法是固定的薄壳模式：

1. `sys.path.insert(0, os.path.dirname(__file__))` 后从 `_common` 导入
2. `argparse` 解析参数
3. 调用 `_common` 里的业务函数
4. `print_json(result)` 输出，由调用方（Agent）解析

新增 API 调用时，**先在 `_common.py` 加业务级封装函数**（参考 `create_project` / `send_message`），再写脚本壳。不要让脚本自己拼 URL 和 header。

## SKILL.md 是行为源

`SKILL.md` 是 Agent 的运行手册——它规定了 Agent 应该如何串联这些脚本（场景 1–5）、如何读 workspace 进度、什么时候该展示项目链接、不要替用户扩写需求等。**修改脚本参数或新增脚本时，必须同步更新 `SKILL.md` 的脚本速查表与场景示例**，否则 Agent 行为会与实际能力脱节。`README.md` 的枚举值表（风格、模型）也要同步。

## 常用命令

仓库无 lint、无测试、无构建。日常只有这些：

```bash
# 配置环境变量（脚本运行前提）
export ZOPIA_ACCESS_KEY="zopia-xxxxxxxxxxxx"
export ZOPIA_BASE_URL="https://zopia.ai"   # 可选，默认即此

# 直接跑脚本调试
python3 scripts/get_balance.py
python3 scripts/create_project.py "测试项目"
python3 scripts/query_session.py SESSION_ID --poll
```

调试本地 `jaaz-cloud` 时，把 `ZOPIA_BASE_URL` 改到本地端口（如 `http://localhost:3000`）即可。

## 发布流程

发布到 ClawHub 技能市场，详细步骤见 `docs/publish-to-clawhub.md`：

```bash
git push                              # 先推 GitHub
npx clawhub publish . --slug zopia-skill --version x.y.z --changelog "..."
npx clawhub inspect zopia-skill       # 验证 Latest 字段
```

版本号 semver：新增模型/功能 → minor +1；修 bug / 文档更新 → patch +1。

## 项目约定

- **Git commit message 用中文**，控制在 20 字以内（参考最近提交：`feat: 新增 Seedance 2.0 Fast 和 PixVerse C1 模型`）
- **不要 `git commit`**，除非用户明确要求
- 重构时不考虑兼容性，直接删除旧逻辑（除非用户明确要求保留）
- npm/npx 命令在 Windows 下用 cmd 执行

docs/publish-to-clawhub.md

# 发布 zopia-skill 到 ClawHub

## 前提条件

- Node.js 已安装（`npx` 可用）
- 已登录 ClawHub（见下文）

## 1. 登录

首次使用需登录：

```bash
npx clawhub login
```

验证登录状态：

```bash
npx clawhub whoami
# ✔ Lambdua
```

登录态会持久化，后续无需重复登录。

## 2. 修改内容并推送 GitHub

修改 `SKILL.md`、脚本等文件后，先 commit & push 到 GitHub：

```bash
git add .
git commit -m "描述本次变更"
git push
```

## 3. 发布新版本到 ClawHub

```bash
npx clawhub publish /path/to/zopia-skills \
  --slug zopia-skill \
  --version <新版本号> \
  --changelog "本次变更说明"
```

**示例：**

```bash
npx clawhub publish /c/code/jobCode/zipia/zopia-skills \
  --slug zopia-skill \
  --version 1.0.3 \
  --changelog "新增 xxx 模型"
```

版本号遵循 semver：
- 新增模型 / 功能 → 次版本号 +1（如 1.0.1 → 1.1.0）
- Bug 修复 / 文档更新 → 补丁号 +1（如 1.0.1 → 1.0.2）

## 4. 验证发布结果

```bash
npx clawhub inspect zopia-skill
```

确认 `Latest` 字段已更新为新版本号。

## 常用命令速查

| 命令 | 说明 |
|------|------|
| `npx clawhub whoami` | 查看当前登录用户 |
| `npx clawhub inspect zopia-skill` | 查看已发布版本信息 |
| `npx clawhub publish <path> --slug zopia-skill --version x.y.z` | 发布新版本 |
| `npx clawhub skill --help` | 管理已发布技能 |

Related agents

Same protocol, similar job.

Github ReposUpdated 5h 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.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/lambdua/skills/zopia-skill",
      "sourceUrl": "https://clawhub.ai/lambdua/skills/zopia-skill",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T06:57:42.724Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-lambdua-zopia-skill/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-lambdua-zopia-skill/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-09T06:57:42.724Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "3.8K downloads",
      "href": "https://clawhub.ai/lambdua/zopia-skill",
      "sourceUrl": "https://clawhub.ai/lambdua/zopia-skill",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T06:57:42.724Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.1.0",
      "href": "https://clawhub.ai/lambdua/zopia-skill",
      "sourceUrl": "https://clawhub.ai/lambdua/zopia-skill",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-04-25T06:10:40.625Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-lambdua-zopia-skill/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-lambdua-zopia-skill/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.1.0",
      "description": "新增分镜/角色场景图模型配置，支持 GPT Image 2",
      "href": "https://clawhub.ai/lambdua/zopia-skill",
      "sourceUrl": "https://clawhub.ai/lambdua/zopia-skill",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-04-25T06:10:40.625Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to Zopia Skills and adjacent AI workflows.