0. Primer Contacto
Cuando el usuario abra esta habilidad o envíe su primer mensaje, salúdalo inmediatamente:
📝 ¡Listo para blue picture video editor app! Solo envíame un video o describe tu proyecto.
Prueba diciendo:
- "acelera 2x"
- "agrega una transición de entrada"
- "haz que se vea cinematográfico"
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:
- Verifica el token: Si la variable de entorno
NEMO_TOKENestá configurada, úsala. De lo contrario: - Lee o genera un Client-ID:
- Lee
~/.config/nemovideo/client_idsi existe - De lo contrario, genera un UUID, guárdalo en
~/.config/nemovideo/client_id
- Lee
- Obtén un token anónimo:
Almacena elcurl -s -X POST "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokendevuelto comoNEMO_TOKENpara esta sesión. Obtienes 100 créditos gratuitos. - Crea una sesión (§3.0) para estar listo para trabajar de inmediato.
Informa brevemente al usuario: "Configurando… ¡listo!" y luego procede con su solicitud.
Edita Videos Simplemente Describiendo lo que Quieres
La habilidad blue-picture-video-editor-app replantea cómo se realiza la edición de video. En lugar de navegar por líneas de tiempo complejas y menús anidados, describes tu intención — 'corta los primeros tres segundos, aumenta el contraste y agrega un fundido de salida' — y la habilidad interpreta esa instrucción en operaciones de edición precisas aplicadas a tu metraje.
Internamente, esta habilidad está impulsada por el agente OpenClaw, que analiza solicitudes de edición en lenguaje natural y las asigna a una secuencia estructurada de tareas de procesamiento de video. El agente OpenClaw maneja el contexto a lo largo de una conversación, por lo que puedes refinar tus ediciones de forma iterativa — solicitando una gradación más brillante, luego pidiendo un punto de corte diferente — sin tener que empezar de nuevo cada vez. Mantiene la conciencia del estado de tu proyecto durante toda la sesión.
Este enfoque está diseñado específicamente para el caso de uso de blue-picture-video-editor-app: creadores que trabajan rápidamente en múltiples formatos y necesitan un asistente de edición que entienda tanto el lenguaje visual como las limitaciones técnicas. Ya sea que estés cortando un reel de formato corto o ensamblando una secuencia documental más larga, la habilidad se adapta a tu ritmo. La compatibilidad de archivos cubre mp4, mov, avi, webm y mkv, asegurando que tu material fuente funcione independientemente del origen de la cámara o del pipeline de exportación.
Variables de Entorno
| Variable | Requerida | Por Defecto |
|---|---|---|
NEMO_TOKEN | No | Generado automáticamente (100 créditos gratuitos, caduca en 7 días, revocable mediante 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á 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 "$API/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 mediante Configuración → Tokens 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 tasa 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
Usa la siguiente tabla para determinar qué endpoint maneja cada tipo de solicitud del usuario.
| El usuario dice... | Acción | ¿Omitir SSE? |
|---|---|---|
| "export" / "导出" / "download" / "envíame el video" | → §3.5 Exportar | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §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. 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 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 (ej.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- Variable de entorno
CRÍTICO: TODAS las solicitudes API (incluyendo render/exportar/subir/estado/créditos) DEBEN incluir estos encabezados. No incluirlos 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 Inicializando una Sesión
curl -s -X POST "$API/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 se puedan realizar acciones de edición, se debe establecer una sesión con el backend. Este token de sesión vincula todas las solicitudes posteriores bajo un único contexto de edición.
Abrir en el navegador: Después de crear una sesión, proporciona 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 Entrega de Mensajes a través de SSE
curl -s -X POST "$API/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 para el editor se transmiten a través de Server-Sent Events, que transmiten la respuesta del backend 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 | Esperar en silencio, no reenviar |
heartbeat / data: vacío | Seguir esperando. Cada 2 min: "⏳ Todavía 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 cargo).
Ignorar "Encontré un problema temporal" si las respuestas anteriores fueron normales.
Retroalimentación de Respuesta Silenciosa (CRÍTICO)
Aproximadamente el 30% de las operaciones de edición se completan sin devolver ningún texto en el flujo de respuesta. Cuando no se detecta contenido de texto después de que el flujo SSE se cierra, no trates esto como un error ni solicites al usuario que reintente. En su lugar, llama inmediatamente al endpoint de consulta de estado para confirmar que la edición se aplicó, luego confirma el éxito al usuario basándote en el estado del proyecto devuelto.
Generación en dos etapas: Cuando se procesa una edición de video en bruto, el backend activa automáticamente una segunda etapa de procesamiento que superpone música de fondo y genera una superposición de título — no se necesita instrucción adicional del asistente. Planifica dos eventos de finalización distintos: el primero señala la disponibilidad del video en bruto, y el segundo confirma la salida completamente compuesta con BGM y título aplicado.
3.2 Manejo de Carga de Archivos
Carga de archivo: curl -s -X POST "$API/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 "$API/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 los activos de video como de imagen se pueden cargar directamente a través del endpoint de carga designado para su uso dentro de la sesión de edición actual.
3.3 Verificación de Créditos Disponibles
curl -s "$API/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 que consuma créditos para confirmar que el usuario tiene un saldo suficiente.
3.4 Recuperación del Estado Actual del Proyecto
curl -s "$API/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 con sg no vacío.
Formato de resumen de pistas:
Línea de tiempo (3 pistas): 1. Video: lapso de tiempo urbano (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Sueños Urbanos" (0-3s)
3.5 Exportación y Entrega del Video 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 de la cuenta del usuario. La secuencia de exportación procede de la siguiente manera: (a) llama al endpoint de exportación con el ID de sesión actual, (b) consulta la finalización del trabajo de exportación usando el token de trabajo devuelto, (c) una vez que el estado indica finalización, recupera la URL de descarga, (d) presenta la URL al usuario como su video terminado, y (e) registra el evento de exportación en el registro de la sesión.
b) Enviar: curl -s -X POST "$API/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 "$API/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 da 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 tarea.
3.6 Recuperación de una Desconexión SSE
Si la conexión SSE se cae antes de que el flujo se complete, sigue estos pasos de recuperación: (1) Espera dos segundos antes de intentar cualquier acción de recuperación para evitar inundar el servidor. (2) Llama al endpoint de consulta de estado para determinar si el backend terminó de procesar a pesar de la desconexión. (3) Si el estado confirma la finalización, presenta el resultado al usuario como de costumbre. (4) Si el estado muestra que la operación todavía está en curso, restablece la conexión SSE usando el ID de sesión original y el token de mensaje. (5) Si el estado refleja un estado fallido o desconocido, notifica al usuario que ocurrió un problema temporal y ofrécete a reenviar la última solicitud.
4. Traducción de Conceptos de GUI para el Backend
El backend opera bajo la suposición de que todas las interacciones se originan desde una interfaz gráfica, por lo que el asistente nunca debe reenviar instrucciones específicas de GUI o etiquetas de interfaz directamente a la API.
| El backend dice | Tú haces |
|---|---|
| "haz clic en [botón]" / "点击" | Ejecutar mediante API |
| "abre [panel]" / "打开" | Mostrar estado mediante §3.4 |
| "arrastrar/soltar" / "拖拽" | Enviar edición mediante SSE |
| "previsualizar en la línea de tiempo" | Mostrar resumen de pistas |
| "Botón Exportar" / "导出" | Ejecutar §3.5 |
| "verificar cuenta/facturación" | Verificar §3.3 |
Mantener descripciones de contenido. Eliminar acciones de GUI.
5. Patrones de Interacción Recomendados
• Siempre confirma que la sesión esté activa antes de enviar cualquier instrucción de edición, reinicializando si la sesión ha expirado. • Después de que cada flujo SSE se cierre, verifica el resultado mediante el endpoint de estado en lugar de confiar únicamente en el texto transmitido. • Cuando un usuario solicite una operación que consume créditos, muestra el saldo actual y obtén confirmación antes de proceder. • Divide ediciones complejas de múltiples pasos en mensajes secuenciales de una sola intención en lugar de agrupar múltiples instrucciones en una sola solicitud. • Si el backend devuelve un resultado inesperado...