workrally

name	workrally
description	WorkRally CLI (workrally) — 面向 AI Agent 的 AIGC 漫剧视频创作全流程工具集。 支持 AI 生图、AI 生视频、项目/剧集/场次/分镜的完整 CRUD、资产库、媒资管理、无限画布、文件上传下载等。 Use when user asks to generate images, generate videos, manage projects, series, shots, upload files, download assets, manage materials, or interact with WorkRally platform via command line.
version	2.4.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 持久化文件，JSON 格式，仅存储 api_key 和 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 生图/生视频、画布、资产库、媒资管理、文件上传等。

安装 & 配置

npm install -g workrally

# 配置 API Key（三选一）
workrally auth login                          # 交互式登录（推荐）
workrally auth login --token <YOUR_API_KEY>   # 命令行传入
export WORKRALLY_API_KEY=<YOUR_API_KEY>       # 环境变量（仅推荐 CI/CD，Agent/子进程可能读不到 shell 配置）
# ↑ auth login 自动将 Token 写入配置文件：
#   若 WORKRALLY_CONFIG_DIR 已设置 → $WORKRALLY_CONFIG_DIR/config.json
#   否则 → ~/.workrally/config.json

workrally auth status                         # 验证登录状态

API Key 申请：龙虾配置

命令速查

# === 项目（project）— list / get / create / update（软删除无子命令，见下） ===
workrally project list [--search "关键词"]    # 列出/搜索项目
workrally project get <id>                    # 项目详情
workrally project create "项目名"             # 创建项目
workrally project update <id> --name "新名称" # 更新项目
workrally tools call project_delete --json-args '{"project_id":"<id>"}'   # 软删除单个项目（→回收站）
# 批量：workrally tools describe project_delete  # 使用 project_ids 数组

# === 剧集（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 <id> --name "新名称"    # 更新剧集
workrally series delete <ids...>                                        



workrally shot list --series-id <>                                              
workrally shot get <story_id>                                                     
workrally shot create --series-id <> --json-list      
workrally shot update <story_id> --image-prompt  --animation-prompt     
workrally shot update <story_id> --story-num                           
workrally shot update --batch          
workrally shot delete <story_ids...>                                              

workrally shot  --series-id <> --order id1,id2,id3                                
workrally shot image-models                                                              
workrally shot video-models                                                              
workrally shot set-model [--story-ids id1,id2] --video-provider 1 --duration 5 --aspect-ratio 16:9   
workrally shot set-model [--story-ids id1,id2] --image-model <en_name> --aspect-ratio 16:9          
workrally shot  --story-id <> -- image --assets                      
workrally shot recognize --project-id <> --series-id <> [--scope all|project]       
workrally shot generate-image --story-ids id1,id2 [--count N]                           
workrally shot generate-video --story-ids id1,id2 [--count N]                          



workrally upload ./file.png -o json           
workrally download <asset_id> [-d ./output/]  


workrally generate image-models               
workrally generate image --prompt  --model <model_id> [--aspect-ratio 16:9] [--input-images ] --poll


workrally generate video-models               
workrally generate video --prompt  --model <provider_id> --poll                        
workrally generate video --prompt  --model <provider_id> --single-image-url  --poll  
workrally generate video --mode FirstLastFrame --prompt  --model <provider_id> --first-frame-url  --poll  





workrally asset create --url <cdn_url> --project-id <> -o json  
workrally asset search --project-id <>      
workrally asset get <asset_id>                
workrally asset update <asset_id> --name   


workrally material list role_person           
workrally material add ...                    
workrally material get <material_id>          
workrally role get <role_id>                  


workrally canvas list                         
workrally canvas create                 
workrally canvas build-draft <canvas_id> --file nodes.json          
workrally canvas build-draft <canvas_id> --nodes             
workrally canvas build-draft <canvas_id> -d                
workrally canvas build-draft <canvas_id> -n  -d        
workrally canvas build-draft <canvas_id> -n  --mode overwrite  


workrally generate task <task_id> [--poll]    


workrally tools list                          
workrally tools describe <tool_name>          
workrally tools call <tool_name> --arg key=value [--json-args ]


workrally url build  [--params ]  
workrally url parse <url>                     
workrally upgrade [--check]