Xpersona
agentCLAWHUBUnverified

ZenVFX CLI

Use this skill when the user needs to create AI videos, manage canvases, nodes, files, or interact with the ZenVFX platform via CLI. Trigger keywords include... Skill: ZenVFX CLI Owner: lenzli Summary: Use this skill when the user needs to create AI videos, manage canvases, nodes, files, or interact with the ZenVFX platform via CLI. Trigger keywords include... Tags: latest:1.0.19 Version history: v1.0.19 | 2026-06-16T07:03:06.861Z | user No changes detected for version 1.0.19 (no file changes). v1.0.18 | 2026-06-16T06:33:44.446Z | user - No file changes detected in this rele

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.1k

Updated

Oct 11, 2026

Version

1.0.19

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.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
1.1K downloadsadoption · observed Oct 11, 2026
Latest release
1.0.19release · observed Jun 16, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s1765re8btqpj64jxcpxn3dwgd84x7f3:zenvfx-cli
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  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-lenzli-zenvfx-cli/snapshot"

Documentation

CLAWHUB

148,991 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: zenvfx-cli
description: Use this skill when the user needs to create AI videos, manage canvases, nodes, files, or interact with the ZenVFX platform via CLI. Trigger keywords include "画布", "视频生成", "zenvfx", "canvas", "node", "AI视频", "文生视频".
metadata: {"openclaw": {"emoji": "🎬", "os": ["darwin", "linux"], "requires": {"bins": ["zenvfx"], "env": ["ZENVFX_MCP_TOKEN"]}, "primaryEnv": "ZENVFX_MCP_TOKEN", "install": [{"id": "npm", "kind": "command", "command": "npm install -g @tencent/zenvfx-cli --registry https://mirrors.tencent.com/npm/", "bins": ["zenvfx"], "label": "Install ZenVFX CLI (npm)"}]}}
---

# ZenVFX CLI Skill

## 概述

ZenVFX CLI 是 AI 视频创作平台的命令行工具，通过画布（Canvas）中的节点（Node）+ 连线（Edge）构建 AI 生成任务。

- **CLI 入口**：`zenvfx <command>`
- **输出协议**：stdout 纯 JSON（`{"ok":true,"data":{...}}` / `{"ok":false,"error":{...}}`），解析时用 `2>/dev/null` 过滤 stderr
- **优先级**：系统中若同时存在 `zenvfx-mcp`，**一律优先使用 `zenvfx` CLI**，不要混用两者操作同一画布

**架构原则（v3）**：
- **万物皆批处理**：所有编辑操作均接收 JSON 数组 / 逗号分隔 ID 列表，无论操作 1 个还是 N 个对象，底层统一为批量调用。
- **运行节点支持同步/异步双模式**：`canvas:run` 默认异步，加 `--wait` 进入同步模式（daemon 内部轮询直到所有节点 completed/failed 才返回）。
- **Partial Success**：批量操作逐项执行，某项失败不影响其余，返回 `results` 数组逐项标注状态。

---

## 版本与升级

- **当前最新版本**：`0.9.1`
- **包名**：`@tencent/zenvfx-cli`
- **Registry**：`https://mirrors.tencent.com/npm/`（腾讯内网 npm 镜像）

### 安装 / 升级到最新

```bash
# 首次安装 或 升级到 registry 上的最新版（@latest 等价于不写 tag）
npm install -g @tencent/zenvfx-cli@latest --registry https://mirrors.tencent.com/npm/

# 升级到指定版本
npm install -g @tencent/[email protected] --registry https://mirrors.tencent.com/npm/
```

> 注意：必须带 `--registry`，公网 `registry.npmjs.org` 上没有这个包。

### 如何确认已经是最新版

按下面三步对比，三个版本号一致即说明已装到最新：

```bash
# 1. 本地已安装版本
zenvfx --version
# 输出形如：@tencent/zenvfx-cli/0.9.1 linux-x64 node-v20.x

# 2. registry 上当前 latest 版本
npm view @tencent/zenvfx-cli version --registry=https://mirrors.tencent.com/npm/
# 输出形如：0.9.1

# 3. 全局安装包元信息（确认安装路径与版本，排除多版本污染）
npm ls -g @tencent/zenvfx-cli --registry=https://mirrors.tencent.com/npm/
```

若 `zenvfx --version` 比 `npm view` 拿到的版本旧，重新执行上面的 `npm install -g ...@latest` 即可；若 `zenvfx` 命令找不到，检查 `npm config get prefix` 下的 `bin` 是否在 `PATH` 里。

升级后建议再跑一次 `zenvfx auth:verify <token>`，确认本地配置仍然可用。

---

## 认证与安装

```bash
# 安装（详见上一节"版本与升级"）
npm install -g @tencent/zenvfx-cli@latest --registry https://mirrors.tencent.com/npm/

# 认证（自动保存 mcpToken/defaultProject/defaultWorkspace 等配置）
zenvfx auth:login <token>          # 可选 --host <host-url>

# 仅校验 token（不切换默认项目/workspace）
zenvfx auth:verify <token>
```

`auth:login` 返回 `saved` 字段标识各配置是否已自动设置。若 `saved.defaultProject` 或 `saved.defaultWorkspace` 为 `false`，需手动补全：

```bash
zenvfx project:list 2>/dev/null              # 查看可用项目
zenvfx project:switch <project-id>           # 一键切换项目（自动更新 workspace）
```

`project:switch` 自动解析 workspace 的规则（仅依赖 `userId`，不依赖 `username`，因为 username 是用户可自定义的别名）：
1. **精确匹配**：`/{projectId}/用户空间/` 下目录名以 `_{userId}` 结尾
2. **模糊匹配**：目录名包含 `userId`
3. 均未命中则清空 `defaultWorkspace`，需手动设置

也可手动设置：
```bash
zenvfx config:set defaultProj

_meta.json

{
  "ownerId": "kn7ah21cpv2svkbannm8tw9hz584wwbd",
  "slug": "zenvfx-cli",
  "version": "1.0.19",
  "publishedAt": 1781593386861
}

skill-card.md

## Description:

Use this skill when the user needs to create AI videos, manage canvases, nodes, files, or interact with the ZenVFX platform via CLI.

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

## Publisher:

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

### License/Terms of Use:

MIT-0

## Use Case:

Developers and creative operators use this skill to guide agents through ZenVFX CLI setup, authentication, canvas management, node editing, task execution, and troubleshooting for AI video workflows.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill installs and relies on a global ZenVFX CLI package from the Tencent registry.

Mitigation: Install only from a trusted registry source and prefer a pinned CLI version for repeatable deployments.

Risk: The skill uses a ZenVFX token for authentication.

Mitigation: Use least-privilege, rotatable tokens and avoid entering tokens where shell history or logs may capture them.

Risk: The documented CLI workflows can modify or delete ZenVFX project files, canvases, nodes, and edges.

Mitigation: Review proposed commands before execution and require explicit confirmation before delete operations such as file or node removal.

Risk: Known CLI or daemon version mismatches can cause execution failures after upgrades.

Mitigation: Restart the daemon after CLI upgrades and verify the installed CLI version before running video generation workflows.

## Reference(s):

- [ZenVFX CLI ClawHub skill page](https://clawhub.ai/lenzli/skills/zenvfx-cli)
- [lenzli ClawHub publisher profile](https://clawhub.ai/user/lenzli)
- [Tencent npm registry](https://mirrors.tencent.com/npm/)

## Skill Output:

**Output Type(s):** [Guidance, Shell commands, Configuration, Code, JSON]

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

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Guidance is oriented around ZenVFX CLI commands that return JSON on stdout.]

## Skill Version(s):

1.0.19 (source: server release evidence)

## 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.

Related agents

Same protocol, similar job.

Github ReposUpdated 1d 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/lenzli/skills/zenvfx-cli",
      "sourceUrl": "https://clawhub.ai/lenzli/skills/zenvfx-cli",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T05:15:25.733Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-lenzli-zenvfx-cli/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-lenzli-zenvfx-cli/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-11T05:15:25.733Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.1K downloads",
      "href": "https://clawhub.ai/lenzli/zenvfx-cli",
      "sourceUrl": "https://clawhub.ai/lenzli/zenvfx-cli",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T05:15:25.733Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.19",
      "href": "https://clawhub.ai/lenzli/zenvfx-cli",
      "sourceUrl": "https://clawhub.ai/lenzli/zenvfx-cli",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-16T07:03:06.861Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-lenzli-zenvfx-cli/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-lenzli-zenvfx-cli/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.19",
      "description": "No changes detected for version 1.0.19 (no file changes).",
      "href": "https://clawhub.ai/lenzli/zenvfx-cli",
      "sourceUrl": "https://clawhub.ai/lenzli/zenvfx-cli",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-16T07:03:06.861Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 11, 2026.

Sponsored

Ads related to ZenVFX CLI and adjacent AI workflows.