What makes WorkRally notable?

2K downloads. Trust evidence available

How should WorkRally 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

WorkRally

WorkRally CLI (workrally) — 面向 AI Agent 的 AIGC 漫剧视频创作全流程工具集。支持 AI 生图、AI 生视频、视频提示词优化、画布生音频/音乐、混元 3D 模型生成、AI 生音频、项目/剧集/场次/分镜的完整 CRUD、资产库、媒资管理、无限画布、文件上传下载等。Use when user asks to generate images, generate videos, generate audio, generate music, generate 3d, optimize video prompts, manage projects, series, shots, upload files, download assets, manage materials, or interact with WorkRally platform via command line. Skill: WorkRally Owner: tencent-adm Summary: WorkRally CLI (workrally) — 面向 AI Agent 的 AIGC 漫剧视频创作全流程工具集。支持 AI 生图、AI 生视频、视频提示词优化、画布生音频/音乐、混元 3D 模型生成、AI 生音频、项目/剧集/场次/分镜的完整 CRUD、资产库、媒资管理、无限画布、文件上传下载等。Use when user asks to generate images, generate videos, generate audio, generate music, generate 3d, optimize video prompts, manage projects, series, shots, upload files, download assets, manage materials, or interact with

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

2.0k

Updated

Oct 9, 2026

Version

2.10.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2K 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: 2K downloadsadoption · observed Oct 9, 2026
Latest release: 2.10.1release · observed Sep 29, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s171cxjdnjyqjxa91pj2bfmr6x83gyg1:workrally

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.
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-tencent-adm-workrally/snapshot"

Documentation

CLAWHUB

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

Extracted files

5 files captured from the source.

SKILL.md

---
name: workrally
slug: workrally
displayName: WorkRally
display_name: WorkRally
display_name_en: WorkRally
description: WorkRally CLI (workrally) — 面向 AI Agent 的 AIGC 漫剧视频创作全流程工具集。支持 AI 生图、AI 生视频、视频提示词优化、画布生音频/音乐、混元 3D 模型生成、AI 生音频、项目/剧集/场次/分镜的完整 CRUD、资产库、媒资管理、无限画布、文件上传下载等。Use when user asks to generate images, generate videos, generate audio, generate music, generate 3d, optimize video prompts, manage projects, series, shots, upload files, download assets, manage materials, or interact with WorkRally platform via command line.
description_zh: 面向 AI Agent 的 AIGC 漫剧视频创作全流程工具集，支持 AI 生图/生视频/生音频、项目剧集场次管理、资产库与无限画布。
description_en: End-to-end AIGC comic-drama creation toolkit for AI Agents—image/video/audio generation, project/series/shot management, asset library, and infinite canvas.
tags: [AIGC, CLI, 漫剧, 生图, 生视频, 生音频, 项目, 剧集, 场次, 画布, 资产库]
version: 2.10.1
license: MIT-0
author: WorkRally Team
homepage: https://workrally.qq.com
user-invocable: true
metadata: {"openclaw":{"emoji":"🎬","requires":{"bins":["workrally"],"env":["WORKRALLY_API_KEY","WORKRALLY_ENDPOINT","WORKRALLY_CONFIG_DIR","WORKRALLY_NO_UPDATE_CHECK"]},"primaryEnv":"WORKRALLY_API_KEY","credentials":{"storage":"~/.workrally/config.json","configDirEnv":"WORKRALLY_CONFIG_DIR","description":"workrally auth login 写入的登录态：API Key，或 OAuth access/refresh token，以及 endpoint。非持久化容器中可通过 WORKRALLY_CONFIG_DIR 环境变量指定配置目录"},"install":[{"id":"npm","kind":"node","package":"workrally","bins":["workrally"],"label":"Install WorkRally CLI (npm)"}],"category":"AIGC","tags":["workrally","aigc","cli","video-generation","image-generation","ai-tools","story","shot","series"]}}
---

# WorkRally CLI (workrally)

面向 AI Agent 的 AIGC 漫剧视频创作全流程命令行工具，封装 WorkRally 平台 30+ 核心能力，支持项目/剧集/场次的完整 CRUD、AI 生图/生视频、画布、资产库、媒资管理、文件上传等。

## 安装 & 配置

```bash
npm install -g workrally

# 配置登录。Agent / CI 只用 API Key，不要自己实现 OAuth，也不要请求 127.0.0.1 回调。
workrally auth login --token <YOUR_API_KEY>   # Agent / CI
export WORKRALLY_API_KEY=<YOUR_API_KEY>       # 环境变量优先于配置文件
workrally auth login                          # 仅人在本机终端使用，CLI 自己打开浏览器
# ↑ auth login 自动将 Token 写入配置文件：
#   若 WORKRALLY_CONFIG_DIR 已设置 → $WORKRALLY_CONFIG_DIR/config.json
#   否则 → ~/.workrally/config.json

workrally auth status                         # 验证登录状态
```

API Key 申请：[龙虾配置](https://workrally.qq.com/open-api)

## 命令速查

```bash
# === 项目（project）— list / get / create / update / delete ===
workrally project list [--search "关键词"]    # 列出/搜索项目
workrally project get <id>                    # 项目详情
workrally project create "项目名"             # 创建项目
workrally project update <id> --name "新名称" # 更新项目
workrally project delete <ids...>             # 软删除（→回收站；恢复请到 Web）

# === 剧集（series）— 全新命令组（CRUD 完整） ===
workrally series list --project-id <id>                                 # 剧集列表
workrally series get <series_id> --project-id <id>                      # 剧集详情
workrally series create --project-id <id> --name "第一集"                # 创建剧集
workrally series update <series_id> --project-id <i

README.md

# WorkRally CLI — Agent Skill

🎬 面向 AI Agent 的 AIGC 漫剧视频创作全流程工具集。

本目录是 WorkRally CLI 的 Agent Skill 定义。

## 目录结构

```
skill/
├── SKILL.md                ← Skill 入口（元数据 + 指令），ClawHub 解析此文件
├── LICENSE.txt             ← 许可证
└── references/             ← 深度参考文档，AI Agent 按需加载
    ├── ai-generation-guide.md      AI 生成指南
    ├── canvas-guide.md             无限画布操作指南
    ├── common-pitfalls.md          常见易错点
    ├── shotlist-guide.md           场次批量制作（对齐 Web /shot）
    └── upload-and-assets-guide.md  上传与素材管理指南
```

## 核心能力

- **AI 生图** — Kontext 模型，支持多参考图、可选推理质量
- **AI 生视频** — 4 种驱动模式（文本/首尾帧/参考主体/视频编辑）
- **提示词优化** — gen_content 文本任务，产物为 `output_text`
- **无限画布** — Yjs 协同编辑，8 种节点类型，实时同步
- **项目 & 媒资管理** — 项目 CRUD、素材上传入库、资产库树形管理
- **通用透传** — 可调用 WorkRally MCP Server 全部工具

## 第三方商店

- [SkillHub](https://skillhub.cn/skills/workrally)
- [ClawHub](https://clawhub.ai/tencent-adm/workrally)
- [Skills](https://skills.sh/tencent/workrally/workrally)

## 快速开始

```bash
npm install -g workrally
workrally auth login
workrally auth status
```

详细用法、命令速查、工作流指南请参阅 **[SKILL.md](./SKILL.md)**。

_meta.json

{
  "ownerId": "kn77cw5hbmapf54rv89jdqwp7x835m4k",
  "slug": "workrally",
  "version": "2.10.1",
  "publishedAt": 1790694286488
}

references/ai-generation-guide.md

# AI 生成指南（图片 / 视频 / 音频 / 音乐 / 3D）

本文档帮助 AI Agent 正确使用 WorkRally 的 AI 图片、视频、音频、音乐与混元 3D 模型生成能力。

---

## 1. 核心规则

> ⚠️ **模型 ID 必须动态获取，严禁猜测或硬编码！**
> 模型列表是动态下发的，不同环境（开发/预发/正式）的可用模型可能完全不同。

> 🔒 所有 URL 类参数仅接受 WorkRally 官方媒资 URL，详见 SKILL.md 规则 9。

```bash
# 生图前必须先获取模型列表
workrally generate image-models -o json

# 生视频前必须先获取模型配置
workrally generate video-models -o json

# 提示词优化前必须先获取 gen_content 模型列表
workrally generate content-models -o json

# 画布生音频/音乐前必须先获取模型
workrally generate audio-models -o json
```

---

## 2. 图片生成 (Kontext)

### 2.1 获取可用模型

```bash
workrally generate image-models -o json
```

返回包含：
- `models[]` — 每个模型的 `model_id`、`name`、`resolution_options`、`kontext_config`、`infer_quality_options`
- `aspect_ratios[]` — 全局可用宽高比列表（如 "1:1", "16:9", "9:16" 等）
- `resolution_options[]` — 所有模型支持的 protobuf 分辨率并集（**推荐**，传给 `--resolution`）
- `resolutions[]` — 旧档位 0/1/2 并集（兼容）
- `count_options[]` — 可选的生成数量

**关键字段**：
- `model_id` → 传给 `--model` 参数
- `kontext_config.max_input_images` → 该模型允许的最大参考图数量（不同模型不同，不要写死）
- `resolution_options[]` → `{value, label}`，value 为 protobuf 枚举（常见 4=1080P、5=1440P、6=2160P）。**`generate image --resolution` 用这里的 value**
- `kontext_config.support_resolutions` → 旧档位 0=1K / 1=2K / 2=4K（兼容已有脚本，新调用不要再用）
- `infer_quality_options[]` → 推理质量选项（可能为空）。非空时才可传 `--quality=<value>`（如 `high`/`medium`/`low`）；空列表时不要传 `--quality`

### 2.2 纯文生图

```bash
workrally generate image \
  --prompt "一只橘猫坐在樱花树下" \
  --model <model_id> \
  --aspect-ratio 16:9 \
  --poll
```

### 2.3 参考图生图

通过 `--input-images` 传入参考主体图片 URL，在 prompt 中用 "第一张图片"、"第二张图片" 引用：

```bash
workrally generate image \
  --prompt "第一张图片趴在第二张图片路中间" \
  --model <model_id> \
  --input-images "https://cat.png,https://shrine.png" \
  --poll
```

> 📌 `--input-images` 的最大数量取决于模型配置中的 `kontext_config.max_input_images`，不要写死。
> 📌 **只允许图片类型的素材**作为参考图。

### 2.4 在画布中生图

```bash
workrally generate image \
  --prompt "描述" \
  --model <model_id> \
  --project-id <画布ID> \
  --poll
```

传入 `--project-id`（画布 ID）后：
- 系统会**自动**在画布中创建 running 状态的占位节点（橙色边框 + 进度条）
- **无需**再手动调用 `build-draft` 放置生成器节点
- 生成完成后，前端自动更新节点状态

> ⚠️ `--project-id` 此处是**画布 ID**（通过 `canvas list` 获取），**不是项目 ID**！

### 2.5 参数说明

| 参数 | 必填 | 默认值 | 说明 |
|------|------|--------|------|
| `--prompt` | ✅ | — | 图片描述 |
| `--model` | ✅ | — | 模型 ID（从 `image-models` 获取） |
| `--aspect-ratio` | — | `16:9` | 宽高比 |
| `--resolution` | — | 模型首个可用 | **推荐** protobuf 枚举，取值来自 `image-models` 的 `resolution_options[].value`（常见 4=1080P、5=1440P、6=2160P）。兼容旧档位 0=1K、1=2K、2=4K。⚠️ 生图的 1/2 仍是 2K/4K，不是视频的 480P/540P |
| `--quality` | — | 不下发 | 推理质量。取值必须来自该模型 `infer_quality_options[].value`；列表为空时不要传 |
| `--count` | — | `1` | 生成数量 1-4（后端一个任务生成 1 张，count>1 会并发发起 N 个独立任务并返回 task_ids 数组） |
| `--input-images` | — | — | 参考图 URL（逗号分隔） |
| `--project-id` | — | — | 画布 ID（传入后自动创建占位节点） |
| `--short-series-project-id` | — | — | 项目 ID |
| `--name` | — | — | 素材名称 |
| `--extra-params` | — | — | JSON 对象。CLI 传 MCP `extraParams`；服务端写入 `graph_input.extra_params` 且将每个 value 序列化为字符串。例如 MJ：`'{"midj

references/canvas-guide.md

# 无限画布操作指南

本文档帮助 AI Agent 正确操作 WorkRally 无限画布（Infinite Canvas）。画布基于 Yjs 协同编辑引擎，CLI 写入的内容会**实时同步**给所有在线用户，无需刷新页面。

---

## 1. 核心概念

### 两种"项目"（容易混淆，务必区分）

| 概念 | 管理命令 | 用途 | 必要性 |
|------|---------|------|--------|
| **项目** (project) | `workrally project list/create/get` | 所有素材都必须归属一个项目，范围更大 | **必须** — 素材不关联项目则在 web 端不可见 |
| **画布** (canvas) | `workrally canvas list/create/get` | 无限画布空间，可在其中排布节点 | **可选** — 仅当用户要在画布中操作时才需要 |

> ⚠️ **两者的 ID 不能互相替代！**
> - `workrally project list` 返回的是项目 ID
> - `workrally canvas list` 返回的是画布 ID
> - 在画布场景下，素材需要**同时关联两者**

### 判断用户意图

| 用户说 | 含义 | 使用命令 |
|--------|------|---------|
| "我的项目"、"项目列表" | 项目 | `workrally project list` |
| "我的画布"、"画布列表" | 无限画布 | `workrally canvas list` |
| "在画布上生成图片" | 画布 + AI 生成 | `workrally generate image --project-id <画布ID>` |
| "上传到项目" | 仅入媒资库 | `upload` → `asset create` |
| "在画布上展示素材" | 需要 build-draft | `upload` → `asset create` → `canvas build-draft` |

---

## 2. 画布节点类型 (8 种)

### 类型一览

| type | 说明 | 必填 data 字段 | 可放入画板 |
|------|------|---------------|-----------|
| `image` | 图片素材 | `data.asset.id` (已有素材) 或 `data.task` (生成中占位) | ✅ |
| `video` | 视频素材 | `data.asset.id` 或 `data.task` | ✅ |
| `audio` | 音频素材 | `data.asset.id` (**必须**，音频无生成器) | ✅ |
| `imageGenerator` | 图片生成器 | 无必填（params 可选） | ❌ |
| `videoGenerator` | 视频生成器 | 无必填（params 可选） | ❌ |
| `artboard` | 画板容器 | 无（建议设置 `style.width/height`） | ❌ (画板不可嵌套) |
| `text` | 文本 | `data.text.content` (字符串，最大90000字符) | ❌ |
| `freehand` | 画笔涂鸦 | `data.freehand.points` + `data.freehand.initialSize` | ❌ |

### 节点通用结构

```json
{
  "id": "node_unique_id",
  "type": "image",
  "position": { "x": 100, "y": 200 },
  "data": { },
  "style": { "width": 512, "height": 512 },
  "parentId": "artboard_id",
  "measured": { "width": 512, "height": 512 }
}
```

**字段说明**：
- `id` — 节点唯一标识，可使用任意唯一字符串
- `position` — 节点左上角坐标（缺失时堆叠在原点 0,0）
- `style` — 节点显示尺寸
- `parentId` — 仅画板内子节点需要，指向父画板的 id
- `measured` — 渲染尺寸，可选，缺失时服务端自动补全

---

## 3. 各节点类型详细说明

### 3.1 图片/视频节点 (image / video)

两种来源：
1. **已有素材** — 必须有 `data.asset.id`
2. **生成中占位** — 必须有 `data.task`（由 AI 生成命令自动创建，通常不需要手动构造）

```json
{
  "id": "img_001",
  "type": "image",
  "position": { "x": 0, "y": 0 },
  "data": {
    "asset": { "id": "asset_abc123" }
  },
  "style": { "width": 512, "height": 512 }
}
```

**带生成任务标记的节点**（用于"再次编辑"功能）：
```json
{
  "id": "gen_img_001",
  "type": "image",
  "position": { "x": 0, "y": 0 },
  "data": {
    "asset": { "id": "asset_abc123" },
    "task": { "taskId": "task_xyz789", "status": "success" }
  },
  "style": { "width": 512, "height": 512 }
}
```

> 💡 `data.task` 字段决定前端是否显示"再次编辑"按钮。AI 生成的图片/视频应包含此字段。

### 3.2 音频节点 (audio)

音频**没有生成器**，不支持 task 占位，必须有 `data.asset.id`。

```json
{
  "id": "audio_001",
  "type": "audio",
  "position": { "x": 0, "y": 0 },
  "data": {
    "asset": { "id": "asset_audio_456" }
  },
  "style": { "width": 260, "height": 80 }
}
```

> 建议尺寸 **260×80**（与前端默认一致）。

### 3.3 画板节点 (artboard)

画板是**容器**，子节点通过 `parentId` 关联到画板。

```json
{
  "id": "board_001",
  "type"

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