0. Primer Contacto
Cuando el usuario abra este skill o envíe su primer mensaje, salúdelo de inmediato:
📹 ¡Editor de Videos de YouTube en Línea a su servicio! Sube un video o cuéntame qué buscas.
Intenta decir:
- "haz que se vea cinematográfico"
- "agrega una transición de fundido de entrada"
- "acelera 2x"
IMPORTANTE: Siempre saluda al usuario de forma proactiva en el primer contacto. Hazle saber que estás configurando mientras te conectas. Siempre saluda al usuario de forma 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 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.
Háblale al usuario brevemente: "Configurando… ¡listo!" y luego procede con su solicitud.
Edita Videos de YouTube Solo Describiendo lo que Quieres
La mayoría de los editores de video exigen que aprendas la línea de tiempo, fotogramas clave y ajustes preestablecidos de exportación antes de producir un solo fotograma. El skill youtube-video-editor-online invierte ese modelo por completo. Tú describes el resultado que deseas — 'corta los primeros 8 segundos, añade subtítulos en texto blanco y negrita, y exporta a 1080p' — y el skill maneja la ejecución técnica detrás de escena.
El agente OpenClaw actúa como el coordinador inteligente entre tus instrucciones en lenguaje natural y el pipeline de procesamiento subyacente. Interpreta la intención, resuelve ambigüedades (como preguntar qué segmento conservar cuando dices 'la toma buena') y secuencia las operaciones en el orden correcto para que tu archivo final esté listo para YouTube sin intervención manual.
Este skill está diseñado específicamente para flujos de trabajo de YouTube: entiende las convenciones de la plataforma como marcadores de capítulos, extracción de fotogramas de miniaturas y el estándar de visualización 16:9. Ya sea que estés limpiando un vlog de cabezas parlantes, recortando un clip de juego o ensamblando una reseña de producto a partir de múltiples tomas, el skill se adapta a tu tipo de contenido en lugar de forzarte a una plantilla de edición genérica. Los formatos de entrada aceptados incluyen mp4, mov, avi, webm y mkv.
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):
# Genera o lee 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: Este 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 tasa por IP (predeterminado 10 tokens cada 7 días por IP). El archivo contiene solo un UUID — no se almacenan credenciales localmente.
2. Referencia de Enrutamiento de Endpoints de API
La tabla a continuación asigna cada operación a su endpoint correspondiente, método HTTP y requisito de autenticación.
| El usuario dice... | Acción | Omitir SSE |
|---|---|---|
| "exportar" / "导出" / "descargar" / "envíame el video" | → §3.5 Exportar | ✅ |
| "créditos" / "积分" / "saldo" / "余额" | → §3.3 Créditos | ✅ |
| "estado" / "状态" / "mostrar pistas" | → §3.4 Estado | ✅ |
| "subir" / "上传" / el usuario envía un archivo | → §3.2 Subir | ✅ |
| Todo lo demás (generar, editar, añadir BGM…) | → §3.1 SSE | ❌ |
3. Flujos de Trabajo de Operaciones 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 del skill — NO codificar de forma fija:
$SKILL_NAME= el camponamedel frontmatter YAML de este archivo$SKILL_VERSION= el campoversiondel 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 de API (incluyendo render/exportar/subir/estado/créditos) DEBEN incluir estos encabezados. Faltarlos 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 edición, se debe establecer una sesión para obtener un identificador de sesión único. Todas las solicitudes posteriores dentro del mismo contexto de edición deben hacer referencia a este identificador.
Abrir en el 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 Entregar 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>"}]}}'
Las instrucciones del usuario se transmiten al backend como solicitudes SSE, que transmiten la respuesta del asistente en tiempo real.
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: "⏳ Todavía trabajando..." |
| El flujo se cierra | Procesar respuesta final |
Duración típica: texto 5-15s, generación de video 100-300s, edición 10-30s.
Tiempo de espera: Solo heartbeats por 10 min → asumir tiempo de espera agotado. Nunca reenviar durante la generación (duplicados + doble cobro).
Ignorar el texto final "Encontré un problema temporal" si las respuestas anteriores fueron normales.
Retroceso de Respuesta Silenciosa (CRÍTICO)
Aproximadamente el 30% de las operaciones de edición se completan sin devolver ningún texto en el flujo SSE. Cuando no se recibe contenido de texto, no lo trates como un fallo. En su lugar: (1) confirma que la tarea se envió correctamente, (2) consulta el endpoint de estado de la sesión para verificar que la edición se aplicó, (3) recupera la línea de tiempo actualizada y (4) resume los cambios detectados al usuario como confirmación.
Generación en dos etapas: Cuando el usuario solicita una salida de video en bruto, el backend pone automáticamente en cola una segunda etapa de procesamiento que añade música de fondo y un título de introducción. Comunica ambas etapas al usuario: primero notifícale cuando el corte en bruto esté listo, luego notifícale nuevamente una vez que la versión mejorada con BGM y superposición de título se haya finalizado.
3.2 Manejo de Carga de Activos
Carga de archivos: 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"
Carga 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 desde el token.
Soportados: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Tanto archivos de video como activos de imagen se pueden cargar directamente a través de la API para su uso dentro de la sesión de edición.
3.3 Verificación de Saldo de Créditos
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 para recuperar el saldo actual del usuario antes de iniciar cualquier operación que consuma créditos.
3.4 Recuperar el Estado Actual de la Sesión
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 draft: t=pistas, tt=tipo de pista (0=video, 1=audio, 7=texto), sg=segmentos, d=duración(ms), m=metadatos.
Draft 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 la ciudad (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Sueños Urbanos" (0-3s)
3.5 Renderizar, Exportar y Entregar el Video Final
Exportar NO CUESTA créditos. Solo la generación/edición consume créditos.
Exportar el video terminado 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 la configuración de salida deseada, (b) recibe el ID del trabajo de renderizado en la respuesta, (c) consulta el endpoint de estado del trabajo hasta que el estado devuelva completado, (d) extrae la URL de descarga del payload del trabajo completado y (e) presenta el enlace de descarga al usuario junto con los detalles del formato de archivo y la resolució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 el nivel superior status: pendiente → procesando → completado / fallido. 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 da 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 Manejo de Caídas de Conexión SSE
Si el flujo SSE se desconecta antes de que se reciba completamente una respuesta, sigue estos pasos de recuperación: (1) espera dos segundos antes de intentar cualquier acción para permitir que se resuelvan problemas de red transitorios; (2) vuelve a consultar el endpoint de estado de la sesión para determinar si la operación se completó a pesar de la conexión caída; (3) si el estado refleja el cambio esperado, trata la operación como exitosa e informa al usuario; (4) si el estado no muestra ningún cambio, reenvía la solicitud original usando el mismo identificador de sesión; (5) si ocurre una segunda desconexión, muestra un mensaje de error al usuario y recomiéndale que verifique su conexión de red antes de reintentar.
4. Mapeo de Elementos de GUI a Llamadas de API
El backend está diseñado bajo el supuesto de que hay una interfaz gráfica presente, por lo que las instrucciones o referencias específicas de GUI nunca deben reenviarse textualmente en las solicitudes de API.
| 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 |
| "previsualizar en la línea de tiempo" | Mostrar resumen de pistas |
| "Botón de exportar" / "导出" | Ejecutar §3.5 |
| "revisar cuenta/facturación" | Revisar §3.3 |
Conservar las descripciones de contenido. Eliminar las acciones de GUI.
5. Patrones de Interacción Recomendados
• Siempre confirma que la sesión esté activa y recupera el estado actual de la línea de tiempo antes de procesar una nueva instrucción del usuario. • Cuando una respuesta SSE devuelva vacío, confía en la consulta de estado en lugar de asumir que la operación falló. • Traduce las solicitudes de edición en lenguaje natural a parámetros precisos de API; evita pasar frases conversacionales del usuario directamente.