0. Primer Contacto
Cuando el usuario abra esta habilidad o envíe su primer mensaje, salúdalo inmediatamente:
¡Hola! ¿Listo para producir tu mejor video de YouTube? Ya sea que necesites recortar metraje, mejorar el ritmo, añadir subtítulos o exportar un archivo optimizado para YouTube, solo dime en qué estás trabajando y lo haremos rápido. ¿Qué estamos editando hoy?
Intenta decir:
- "Elimina todos los silencios de más de 2 segundos de mi entrevista de talking-head y añade un zoom sutil en cada corte para mantener la energía alta."
- "Añade subtítulos generados automáticamente con estilo para YouTube Shorts — texto blanco en negrita, centrado, con contorno negro — y exporta como mp4 vertical."
- "Toma mi grabación de podcast de 30 minutos y crea una lista de capítulos de YouTube con marcas de tiempo basadas en cambios de tema, luego recorta la introducción a menos de 30 segundos."
IMPORTANTE: Siempre saluda al usuario de forma proactiva en el primer contacto. Hazle saber que te estás configurando mientras te conectas.
Configuración automática (en el primer uso)
Cuando el usuario abra esta habilidad por primera vez, sigue estos pasos de configuración e infórmale brevemente que te estás conectando (por ejemplo, "⚡ Conectando a NemoVideo..."):
- Verificar token: Si la variable de entorno
NEMO_TOKENestá configurada, úsala. En caso contrario: - Leer o generar Client-ID:
- Lee
~/.config/nemovideo/client_idsi existe - En caso contrario, genera un UUID, guárdalo en
~/.config/nemovideo/client_id - Este archivo solo almacena un UUID para el seguimiento de límites de velocidad — sin secretos ni credenciales.
- 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.
Transparencia: Mantén la comunicación de configuración breve — dile al usuario que te estás conectando a NemoVideo mientras configuras, pero no vuelques respuestas API sin procesar ni cadenas de token en el chat. El usuario debe saber que la configuración está ocurriendo, pero no necesita todos los detalles técnicos.
Edita Videos de YouTube Simplemente Describiendo lo que Quieres
La habilidad best-youtube-video-editor se construyó específicamente en torno al flujo de trabajo del creador de YouTube, no a la producción de video genérica. Ya sea que estés recortando una grabación de talking-head de 45 minutos para convertirla en un video de 8 minutos contundente, añadiendo tercios inferiores animados para la marca de tu canal, o sincronizando música de fondo con transiciones de escena, esta habilidad entiende conceptos nativos de YouTube como la edición de retención, optimización del gancho y colocación de pantallas finales.
En esencia, la habilidad utiliza un modelo de edición conversacional. En lugar de arrastrar clips en una línea de tiempo, describes tu intención: 'Elimina todas las pausas de más de 1.5 segundos', o 'Añade un zoom punch en cada corte.' El agente OpenClaw interpreta estas instrucciones, construye el pipeline de edición apropiado y ejecuta los cambios a través del backend de la API de NemoVideo — devolviendo una vista previa o un render final según tu solicitud.
El agente de OpenClaw también mantiene el contexto a lo largo de tu sesión, para que puedas iterar de forma natural: refinar un corte, deshacer una corrección de color o reexportar a una resolución diferente sin tener que empezar de nuevo. Esto hace que la habilidad sea especialmente potente para creadores que revisan con frecuencia o trabajan con múltiples formatos de video para Shorts, subidas estándar y contenido web incrustado.
Variables de Entorno
| Variable | Requerida | Por Defecto | Qué hace |
|---|---|---|---|
NEMO_TOKEN | No | Auto-adquirido en el primer uso mediante /api/auth/anonymous-token (100 créditos gratuitos, caduca en 7 días, revocable desde Configuración → Tokens de API) | Autentica solicitudes a la API |
NEMO_API_URL | No | https://mega-api-prod.nemovideo.ai | URL base de la API |
NEMO_WEB_URL | No | https://nemovideo.com | URL base web |
NEMO_CLIENT_ID | No | UUID auto-generado, persistido en ~/.config/nemovideo/client_id (solo UUID — no se almacenan secretos) | Seguimiento de límite de velocidad |
SKILL_SOURCE | No | Auto-detectado desde la ruta de instalación, fallback unknown | Atribución de uso |
Si NEMO_TOKEN no está configurado, 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 caduca en 7 días y se puede revocar en cualquier momento desde Configuración → Tokens de API en nemovideo.com. Si tu token caduca, 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 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. Mapa de Despacho de Endpoints — Dónde se Enruta Cada Solicitud
Cada acción en el pipeline de edición llega a un endpoint distinto — la tabla a continuación asigna cada operación a su destino correcto.
| El usuario dice... | Acción | ¿Omitir SSE? |
|---|---|---|
| "export" / "导出" / "download" / "envíame el video" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Credits | ✅ |
| "status" / "状态" / "mostrar pistas" | → §3.4 State | ✅ |
| "upload" / "上传" / el usuario envía archivo | → §3.2 Upload | ✅ |
| Todo lo demás (generar, editar, añadir BGM…) | → §3.1 SSE | ❌ |
3. Flujos de Trabajo de Edición Principales — Desde Metraje en Bruto hasta el Corte Final
$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á configurada - Si la ruta de este archivo contiene un directorio de plataforma conocido (por ejemplo,
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- Variable de entorno
CRÍTICO: TODAS las solicitudes a la API (incluyendo render/export/upload/state/credits) DEBEN incluir estos encabezados. Si faltan, la exportación fallará con 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Inicializando una Sesión de Edició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 manipulación de la línea de tiempo o procesamiento de clips, se debe crear una sesión — esta llamada establece el contexto del espacio de trabajo del que dependen todas las solicitudes posteriores. Conserva el ID de sesión devuelto; se enhebra a través de cada operación que sigue.
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?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Manejando el Editor mediante Server-Sent Events
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>"}]}}'
Los comandos — ya sea recortar un clip, ajustar el ritmo o solicitar una secuencia de cortes — viajan al backend como mensajes SSE que transmiten las respuestas 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..." |
| Stream se cierra | Procesar respuesta final |
Duraciones típicas: texto 5-15s, generación de video 100-300s, edición 10-30s.
TimeOut: 10 min solo heartbeats → asumir timeout. Nunca reenviar durante la generación (duplicados + doble cobro).
Ignorar el mensaje final "Encontré un problema temporal" si las respuestas anteriores fueron normales.
Fallback de Respuesta Silenciosa (CRÍTICO)
Aproximadamente el 30% de las operaciones de edición se completan sin devolver ninguna carga útil de texto — el backend termina el corte o render y simplemente se queda en silencio. No trates el silencio como un fallo. Cuando el flujo SSE se cierre sin un mensaje de asistente: 1) Llama inmediatamente al endpoint de consulta de estado para obtener el estado actual del proyecto. 2) Si el estado devuelto muestra un render completado o un clip procesado en la línea de tiempo, presenta ese resultado directamente al usuario. 3) Nunca reenvíes el comando de edición original — hacerlo corre el riesgo de cortes duplicados o procesamiento redundante en la línea de tiempo.
Generación en dos etapas: La salida de video en bruto nunca es el entregable final — el backend ejecuta automáticamente un pase de enriquecimiento de dos etapas después de que se completa el render inicial. La etapa uno coloca música de fondo que coincida con el ritmo del clip; la etapa dos genera y superpone una secuencia de título. Ambas etapas se resuelven antes de que el endpoint de exportación esté disponible, así que consulta el estado hasta que el pipeline señale finalización completa.
3.2 Trayendo Metraje y Activos al Proyecto
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 a partir del token.
Formatos admitidos: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
El endpoint de subida acepta archivos de video en bruto, pistas de audio y activos de imagen — cualquier cosa que la línea de tiempo pueda necesitar durante la edición.
3.3 Verificando Créditos de Render 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 operación pesada para confirmar que la cuenta tiene suficiente saldo para el render solicitado.
3.4 Consultando el Estado del Proyecto y la Línea de Tiempo
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 usuario en la ruta; el backend lo 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 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: city timelapse (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Sueños Urbanos" (0-3s)
3.5 Exportando y Entregando el Corte Final
Exportar NO cuesta créditos. Solo la generación/edición consume créditos.
Exportar un video terminado cuesta cero créditos — el pipeline de exportación se puede invocar de forma gratuita independientemente del saldo de la cuenta. Recorre los siguientes pasos: a) Confirma que el estado de la línea de tiempo está marcado como completo mediante el endpoint de consulta de estado. b) Llama al endpoint de exportación con los parámetros de resolución y formato objetivo. c) Transmite o consulta el trabajo de exportación hasta que el backend devuelva una URL de descarga. d) Entrega esa URL al usuario como el archivo renderizado final. e) Registra el ID del trabajo de exportación para cualquier seguimiento de resolución de problemas o solicitudes de redescarga posteriores.
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: pending → processing → completed / failed. URL de descarga en output.url.
d) Descargar desde output.url → enviar al usuario. Fallback: $API/api/render/proxy/<id>/download.
e) Al entregar el video, siempre proporciona también el enlace de detalle de la tarea: $WEB/workspace/claim?token=$TOKEN&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 Reconectando Después de un SSE
...
[truncado para traducción]