0. Primer Contacto
Cuando el usuario abra esta skill o envíe su primer mensaje, salúdalo de inmediato:
⚡ ¡Listo para el generador de videos qwen ai! Solo envíame un video o describe tu proyecto.
Intenta decir:
- "ayúdame a crear un video corto"
- "añade efectos a este clip"
- "edita mi video"
IMPORTANTE: Siempre saluda al usuario de manera proactiva en el primer contacto. Hazle saber que estás configurando mientras te conectas. Siempre saluda al usuario de manera proactiva en el primer contacto.
Configuración Automática
Cuando el usuario interactúe por primera vez, configura la conexión:
- Verificar token: Si la variable de entorno
NEMO_TOKENestá configurada, úsala. De lo contrario: - Leer o generar un Client-ID:
- Lee
~/.config/nemovideo/client_idsi existe - De lo contrario, genera un UUID, guárdalo en
~/.config/nemovideo/client_id
- Lee
- Adquirir token anónimo:
Almacena elcurl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokendevuelto comoNEMO_TOKENpara esta sesión. Obtienes 100 créditos gratuitos. - Crear una sesión (§3.0) para estar listo para trabajar de inmediato.
Indica brevemente al usuario: "Configurando… ¡listo!" y luego procede con su solicitud.
Creación de Video Conversacional Potenciada por la Inteligencia de Qwen
La skill qwen-ai-video-generator conecta el marco de agentes OpenClaw de ClawHub con el modelo multimodal de Qwen, permitiendo un enfoque fundamentalmente diferente para la creación de videos. En lugar de arrastrar clips en una línea de tiempo, describes lo que deseas — escenas, transiciones, ritmo, tono de narración — y el agente interpreta tu intención y estructura la salida en consecuencia. Esto significa menos tiempo lidiando con software de edición y más tiempo refinando tu mensaje real.
El agente OpenClaw actúa como la capa de orquestación, traduciendo tus indicaciones conversacionales en tareas de generación estructuradas que Qwen procesa fotograma a fotograma. Ya sea que estés creando un recorrido de producto, un video educativo explicativo o un clip corto para redes sociales, el agente mantiene el contexto a lo largo de tu sesión para que las instrucciones de seguimiento como 'haz la intro más corta' o 'añade una superposición de texto en el segundo 10' se manejen sin tener que empezar de nuevo.
Internamente, la skill maneja la codificación y negociación de formato automáticamente, por lo que tu resultado final se entrega en el formato contenedor que se adapte a tu plataforma: mp4 para compatibilidad general, mov para flujos de trabajo profesionales, webm para entrega web, o avi y mkv para flujos de archivo y edición. Sin transcodificación manual necesaria.
Variables de Entorno
| Variable | Requerida | Valor por Defecto |
|---|---|---|
NEMO_TOKEN | No | Generado automáticamente (100 créditos gratuitos, expira en 7 días, revocable en Configuración → Tokens de API) |
NEMO_API_URL | No | https://mega-api-prod.nemovideo.ai |
NEMO_WEB_URL | No | https://nemovideo.com |
NEMO_CLIENT_ID | No | UUID generado automáticamente, persistido en ~/.config/nemovideo/client_id (solo UUID, sin secretos) |
SKILL_SOURCE | No | Detectado automáticamente desde la ruta de instalación, valor alternativo unknown |
Si NEMO_TOKEN no está configurado, obtén uno (requiere el encabezado X-Client-Id):
# Generar o leer el Client-Id persistido
CLIENT_ID="${NEMO_CLIENT_ID:-$(cat ~/.config/nemovideo/client_id 2>/dev/null)}"
if [ -z "$CLIENT_ID" ]; then
CLIENT_ID=$(uuidgen 2>/dev/null || echo "client-$(date +%s)-$RANDOM")
mkdir -p ~/.config/nemovideo && echo "$CLIENT_ID" > ~/.config/nemovideo/client_id
fi
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}
Guarda token como NEMO_TOKEN, CLIENT_ID como NEMO_CLIENT_ID. Anónimo: 1 token por cliente cada 7 días; el token expira en 7 días y se puede revocar en cualquier momento a través de Configuración → Tokens de API en nemovideo.com. Si tu token expira, solicita uno nuevo con el mismo X-Client-Id.
Persistencia local: Esta skill escribe ~/.config/nemovideo/client_id para persistir el Client-Id entre sesiones. Esto evita generar un nuevo ID en cada solicitud, lo que alcanzaría rápidamente el límite de velocidad por IP (por defecto 10 tokens cada 7 días por IP). El archivo contiene solo un UUID — no se almacenan credenciales localmente.
2. Enrutamiento de Solicitudes Entrantes al Endpoint Correcto
Usa la siguiente tabla para determinar qué endpoint de API debe manejar cada tipo de solicitud del usuario.
| El usuario dice... | Acción | Omitir SSE |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 Exportar | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Créditos | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 Estado | ✅ |
| "upload" / "上传" / el usuario envía un archivo | → §3.2 Subir | ✅ |
| Todo lo demás (generar, editar, añadir BGM…) | → §3.1 SSE | ❌ |
3. Secuencias de Flujo de Trabajo Principales
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
Variables de atribución de la skill — NO codificar:
$SKILL_NAME= el nombrenamedel frontmatter YAML de este archivo$SKILL_VERSION= la versiónversiondel frontmatter YAML de este archivo$SKILL_SOURCE= detectar en tiempo de ejecución usando la primera coincidencia:- Variable de entorno
SKILL_SOURCEsi está configurada - Si la ruta de este archivo contiene un directorio de plataforma conocido (ej.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Valor alternativo:
unknown
- Variable de entorno
CRÍTICO: TODAS las solicitudes API (incluyendo render/exportar/subir/estado/créditos) DEBEN incluir estos encabezados. Omitirlos causará que la exportación falle con 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Inicializar una Nueva Sesión
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" \
-d '{"task_name":"project","language":"<lang>"}'
# → {"code":0,"data":{"task_id":"...","session_id":"..."}}
Antes de que pueda comenzar cualquier interacción, se debe establecer una sesión con el backend. Almacena el identificador de sesión devuelto, ya que cada solicitud subsiguiente dentro de esa conversación depende de él.
Abrir en navegador: Después de crear una sesión, proporciona al usuario un enlace para ver/editar la tarea en NemoVideo:
$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Entregar Mensajes a Través de una Conexión SSE
curl -s -X POST "https://mega-api-prod.nemovideo.ai/run_sse" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "Accept: text/event-stream" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" --max-time 900 \
-d '{"app_name":"nemo_agent","user_id":"me","session_id":"<sid>","new_message":{"parts":[{"text":"<msg>"}]}}'
Todos los mensajes conversacionales se transmiten al backend y las respuestas se reciben a través de un flujo persistente de Server-Sent Events.
Manejo de SSE
| Evento | Acción |
|---|---|
| Respuesta de texto | Aplicar traducción de GUI (§4), presentar al usuario |
| Llamada/resultado de herramienta | Esperar en silencio, no reenviar |
heartbeat / data: vacío | Seguir esperando. Cada 2 min: "⏳ Todavía trabajando..." |
| El flujo se cierra | Procesar la respuesta final |
Duraciones típicas: texto 5-15s, generación de video 100-300s, edición 10-30s.
Tiempo de espera: 10 minutos solo con heartbeats → asumir tiempo de espera. Nunca reenviar durante la generación (duplicados + doble cobro).
Ignora el mensaje final "Encontré un problema temporal" si las respuestas anteriores fueron normales.
Alternativa de Respuesta Silenciosa (CRÍTICO)
Aproximadamente el 30% de las operaciones de edición devuelven un resultado completado sin ningún texto de acompañamiento en el flujo SSE. Cuando no se detecte contenido de texto en la respuesta, no lo trates como un error ni le pidas al usuario que reintente. En su lugar: (1) verifica el endpoint de estado de la tarea para confirmar la finalización, (2) recupera el activo de salida directamente y (3) presenta el resultado finalizado al usuario como de costumbre.
Generación en dos etapas: Cuando se produce un video en bruto, el backend inicia automáticamente una segunda etapa de procesamiento que superpone música de fondo y una superposición de título. Tu integración debe considerar ambas etapas: primero muestra el video en bruto al usuario, luego escucha el evento de finalización de la segunda etapa y actualiza el resultado mostrado una vez que la versión mejorada esté lista.
3.2 Manejo de Subidas de Archivos
Subida de archivo: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -F "files=@/path/to/file"
Subida de URL: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"urls":["<url>"],"source_type":"url"}'
Usa me en la ruta; el backend resuelve el usuario a partir del token.
Formatos compatibles: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
La API acepta archivos multimedia proporcionados por el usuario, que deben subirse a través del endpoint de subida designado antes de ser referenciados en cualquier solicitud de generación o edición.
3.3 Verificar Créditos Disponibles
curl -s "https://mega-api-prod.nemovideo.ai/api/credits/balance/simple" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
# → {"code":0,"data":{"available":XXX,"frozen":XX,"total":XXX}}
Consulta el endpoint de créditos antes de iniciar cualquier tarea de generación para confirmar que el usuario tiene un saldo suficiente para cubrir la operación.
3.4 Consultar el Estado de la Tarea
curl -s "https://mega-api-prod.nemovideo.ai/api/state/nemo_agent/me/<sid>/latest" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Usa me para el usuario en la ruta; el backend resuelve a partir del token.
Campos clave: data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Mapeo de campos del borrador: t=pistas, tt=tipo de pista (0=video, 1=audio, 7=texto), sg=segmentos, d=duración(ms), m=metadatos.
Borrador listo para exportar cuando draft.t existe con al menos una pista que tenga sg no vacío.
Formato de resumen de pistas:
Línea de tiempo (3 pistas): 1. Video: time-lapse ciudad (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Sueños Urbanos" (0-3s)
3.5 Exportar y Entregar el Activo Final
Exportar NO cuesta créditos. Solo la generación/edición consume créditos.
Activar una exportación no descuenta ningún crédito del saldo del usuario. La secuencia de exportación procede de la siguiente manera: (a) llama al endpoint de exportación con el identificador del activo objetivo, (b) recibe el ID del trabajo de exportación en la respuesta, (c) consulta el estado del trabajo hasta que el estado alcance la finalización, (d) extrae la URL de descarga del payload del trabajo completado y (e) presenta la URL o descarga el archivo para el usuario.
b) Enviar: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"id":"render_<ts>","sessionId":"<sid>","draft":<json>,"output":{"format":"mp4","quality":"high"}}'
Nota: sessionId está en camelCase (excepción). En caso de error → nuevo id, reintentar una vez.
c) Consultar (cada 30s, máximo 10 consultas): curl -s "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda/<id>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Estado en el nivel superior status: pending → processing → completed / failed. URL de descarga en output.url.
d) Descargar desde output.url → enviar al usuario. Alternativa: https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) Al entregar el video, siempre proporciona también el enlace de detalle de la tarea: $WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
Mensajes de progreso: inicio "⏳ Renderizando ~30s" → "⏳ 50%" → "✅ ¡Video listo!" + archivo + enlace de detalle de la tarea.
3.6 Reconexión Después de una Pérdida de SSE
Si la conexión SSE se cae inesperadamente, sigue estos cinco pasos para recuperarse correctamente: (1) Espera un mínimo de dos segundos antes de intentar reconectarte, para evitar sobrecargar el servidor. (2) Vuelve a abrir el flujo SSE usando el identificador de sesión original — no crees una nueva sesión. (3) Una vez reconectado, consulta inmediatamente el endpoint de estado de la tarea para determinar si el procesamiento se completó durante la interrupción. (4) Si la tarea ha finalizado, recupera el activo de salida y preséntalo al usuario como si el flujo nunca se hubiera caído. (5) Si la tarea aún está en progreso, reanuda la escucha en el flujo restaurado hasta que llegue el evento de finalización.
4. Traducción de Conceptos de GUI para el Backend
El backend opera bajo el supuesto de que todas las interacciones se originan desde una interfaz gráfica, por lo que tu integración nunca debe reenviar etiquetas específicas de GUI, nombres de botones o instrucciones de interfaz directamente a la API.
| El backend dice | Tú haces |
|---|---|
| "click [button]" / "点击" | Ejecutar mediante API |
| "open [panel]" / "打开" | Mostrar estado mediante §3.4 |
| "drag/drop" / "拖拽" | Enviar edición mediante SSE |
| "preview in timeline" | Mostrar resumen de pistas |
| "Export button" / "导出" | Ejecutar §3.5 |
| "check account/billing" | Verificar §3.3 |
Conservar descripciones de contenido. Eliminar acciones de GUI.
5. Patrones de Interacción Recomendados
• Siempre confirma la intención del usuario antes de enviar una solicitud de generación que consumirá créditos. • Proporciona actualizaciones incrementales de progreso mostrando los eventos del flujo SSE a medida que ocurren. • Cuando el usuario suba un archivo, confirma el formato y la duración antes de proceder. • Si el usuario solicita un formato de salida específico, intenta coincidir; de lo contrario, usa mp4 como valor por defecto para máxima compatibilidad. • Después de que el video esté listo, ofrece ediciones de seguimiento como "ajustar duración", "cambiar música de fondo" o "añadir más escenas".