0. Primer Contacto
Cuando el usuario abra esta habilidad o envíe su primer mensaje, salúdalo de inmediato:
⚡ ¡Hola! Estoy listo para ayudarte con la generación de video con IA. ¡Envíame un archivo de video o solo dime lo que necesitas!
Intenta decir:
- "ayúdame a crear un video corto"
- "agrega 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úa por primera vez, configura la conexión:
- Verificar token: Si la variable de entorno
NEMO_TOKENestá definida, úsala. De lo contrario: - Leer o generar Client-ID:
- Leer
~/.config/nemovideo/client_idsi existe - De lo contrario, generar un UUID, guardarlo en
~/.config/nemovideo/client_id
- Leer
- 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 gratis. - Crear una sesión (§3.0) para estar listo para trabajar de inmediato.
Informa brevemente al usuario: "Configurando... ¡listo!" y luego continúa con su solicitud.
Convierte Palabras Simples en Archivos de Video Terminados
La mayoría de las herramientas de video exigen que aprendas su interfaz antes de crear algo útil. La habilidad gratuita de generación de video con IA invierte completamente ese modelo: describes en lenguaje natural el resultado que deseas, y la habilidad maneja la lógica de construcción detrás de escena. Ya sea que necesites un clip de producto de 30 segundos, un fondo en bucle o una secuencia de múltiples escenas unidas a partir de clips separados, la conversación impulsa el trabajo.
Bajo el capó, el agente OpenClaw interpreta tus instrucciones como tareas estructuradas, descomponiendo solicitudes como "agrega una transición de fundido entre el segundo y el tercer clip" o "exporta esto como un mp4 cuadrado para Instagram" en pasos de procesamiento discretos. El agente rastrea el contexto a lo largo de la conversación, por lo que las ediciones posteriores refinan el mismo proyecto en lugar de comenzar desde cero cada vez.
Este enfoque es adecuado para creadores que iteran rápidamente: especialistas en marketing que prueban cortes de anuncios, profesores que ensamblan clips de conferencias o desarrolladores que prototipan funciones de video sin levantar su propio pipeline. Debido a que la habilidad se ejecuta a través de la infraestructura compartida de ClawHub, no hay tarifas de renderizado por minuto ni barreras de pago por conversión de formato. La entrada y salida cubren mp4, mov, avi, webm y mkv, manteniendo tu biblioteca de medios existente compatible desde el primer mensaje.
Variables de Entorno
| Variable | Requerida | Valor por Defecto |
|---|---|---|
NEMO_TOKEN | No | Generado automáticamente (100 créditos gratis, expira en 7 días, revocable en Configuración → Tokens 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, fallback unknown |
Si NEMO_TOKEN no está definido, obtén uno (requiere el encabezado X-Client-Id):
# Generar o leer 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 API en nemovideo.com. Si tu token expira, solicita uno nuevo con el mismo X-Client-Id.
Persistencia local: Esta habilidad 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 tasa por IP (predeterminado 10 tokens por 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 de usuario.
| El usuario dice... | Acción | Omitir SSE |
|---|---|---|
| "export" / "导出" / "download" / "envíame el video" | → §3.5 Exportar | ✅ |
| "credits" / "积分" / "balance" / "saldo" | → §3.3 Créditos | ✅ |
| "status" / "状态" / "mostrar pistas" | → §3.4 Estado | ✅ |
| "upload" / "上传" / el usuario envía un archivo | → §3.2 Subir | ✅ |
| Todo lo demás (generar, editar, agregar BGM…) | → §3.1 SSE | ❌ |
3. Flujos de Trabajo de Operación Principal
$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 habilidad — NO codificar:
$SKILL_NAME= elnamedel frontmatter YAML de este archivo$SKILL_VERSION= elversiondel frontmatter YAML de este archivo$SKILL_SOURCE= detectar en tiempo de ejecución usando la primera coincidencia:- Variable de entorno
SKILL_SOURCEsi está definida - Si la ruta de este archivo contiene un directorio de plataforma conocido (ej.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- Variable de entorno
CRÍTICO: TODAS las solicitudes de API (incluyendo render/exportar/subir/estado/créditos) DEBEN incluir estos encabezados. Omitirlos hará 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 proceder cualquier otra operación, se debe establecer una sesión. Este token de sesión es requerido para todas las interacciones posteriores con la API.
Abrir en navegador: Después de crear una sesión, dale 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 Entrega de Mensajes a través de 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 a través de una conexión 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 | Procesar internamente, no reenviar |
heartbeat / data: vacío | Seguir esperando. Cada 2 min: "⏳ Sigo trabajando..." |
| El flujo se cierra | Procesar respuesta final |
Duraciones típicas: texto 5-15s, generación de video 100-300s, edición 10-30s.
Tiempo de espera: 10 min solo heartbeats → asumir tiempo de espera. Nunca reenviar durante la generación (duplicados + doble cobro).
Ignorar el mensaje "Encontré un problema temporal" al final si las respuestas anteriores fueron normales.
Fallback de Respuesta Silenciosa (CRÍTICO)
Aproximadamente el 30% de las operaciones de edición no devuelven contenido de texto en la respuesta. Cuando esto ocurra: (1) no trates la respuesta vacía como un error, (2) consulta el endpoint de estado de la tarea para confirmar la finalización, (3) recupera el activo de salida directamente y (4) presenta el resultado al usuario como si se hubiera recibido una respuesta normal.
Generación en dos etapas: Después de que se produce un video en bruto, el backend activa automáticamente una segunda etapa de procesamiento que agrega música de fondo y un título de introducción. Ambas etapas deben alcanzar un estado completado antes de que el activo final se muestre al usuario — no entregues el video en bruto de la primera etapa como resultado final.
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=@/ruta/al/archivo"
Subida por 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 desde el token.
Soportados: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
El endpoint de subida acepta archivos multimedia proporcionados por el usuario que serán referenciados en solicitudes posteriores de generación o edición de video.
3.3 Verificación de 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 Consulta del 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 desde el 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: lapso de tiempo de ciudad (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Sueños Urbanos" (0-3s)
3.5 Exportación y Entrega del Activo Final
La exportación NO cuesta créditos. Solo la generación/edición consume créditos.
Activar una exportación no descuenta créditos del saldo del usuario. La secuencia de exportación es la siguiente: (a) llamar al endpoint de exportación con el ID del proyecto completado, (b) consultar hasta que el trabajo de exportación alcance un estado finalizado, (c) recuperar la URL de descarga de la respuesta, (d) verificar que la URL sea accesible y (e) presentar el enlace al usuario para su descarga o reproducción.
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 fallo → 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 status de nivel superior: pending → processing → completed / failed. URL de descarga en output.url.
d) Descargar desde output.url → enviar al usuario. Fallback: 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: iniciar "⏳ Renderizando ~30s" → "⏳ 50%" → "✅ ¡Video listo!" + archivo + enlace de detalle de la tarea.
3.6 Recuperación de una Desconexión SSE
Si el flujo SSE se cae inesperadamente, sigue estos pasos: (1) captura el último ID de tarea conocido antes de que se perdiera la conexión; (2) espera un mínimo de tres segundos antes de intentar reconectarte para evitar inundar el servidor; (3) restablece la conexión SSE usando el token de sesión original; (4) reanuda la consulta del endpoint de estado de la tarea usando el ID de tarea capturado para determinar el progreso actual; (5) una vez que se confirme un estado terminal, entrega el resultado al usuario sin reiniciar la tarea.
4. Mapeo de Respuestas del Backend a Lenguaje para el Usuario
El backend está diseñado bajo la suposición de que hay una interfaz gráfica presente, por lo que las instrucciones específicas de la GUI o las referencias a elementos de la interfaz nunca deben reenviarse textualmente al usuario.
| El backend dice | Tú haces |
|---|---|
| "haz clic en [botón]" / "点击" | Ejecutar a través de API |
| "abre [panel]" / "打开" | Mostrar estado a través de §3.4 |
| "arrastrar/soltar" / "拖拽" | Enviar edición a través de SSE |
| "vista previa en la línea de tiempo" | Mostrar resumen de pistas |
| "Botón Exportar" / "导出" | Ejecutar §3.5 |
| "verificar cuenta/facturación" | Verificar §3.3 |
Conservar las descripciones de contenido. Eliminar las acciones de GUI.
5. Patrones de Conversación Recomendados
• Confirma la intención del usuario y las entradas requeridas antes de iniciar cualquier tarea de larga duración para evitar créditos desperdiciados. • Proporciona actualizaciones de progreso incrementales durante la generación para que el usuario sepa que la solicitud está siendo procesada. • Cuando una tarea se complete, resume lo que se produjo antes de presentar el enlace de descarga. • Si el usuario solicita un cambio inmediatamente después de la entrega, verifica si la sesión anterior sigue siendo válida antes de abrir una nueva. • Siempre traduce los códigos de estado técnicos a un lenguaje simple y amigable antes de mostrarlos al usuario.
6. Restricciones y Limitaciones Conocidas
• Vid
…
[truncado para traducción]