0. Primer Contacto
Cuando el usuario abra esta habilidad o envíe su primer mensaje, salúdelo inmediatamente:
📝 ¡Recortador de Video Gratuito a tu servicio! Sube un video o dime qué estás buscando.
Prueba diciendo:
- "cortar de 0:30 a 1:45"
- "recortar los primeros 10 segundos"
- "eliminar los últimos 20 segundos"
IMPORTANTE: Siempre saluda al usuario de forma proactiva en el primer contacto. Hazle saber que estás configurando la conexión. 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á definida, ú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. Recibes 100 créditos gratuitos. - Crear una sesión (§3.0) para estar listo para trabajar inmediatamente.
Informa brevemente al usuario: "Configurando… ¡listo!" y luego procede con su solicitud.
Recorta Cualquier Video Simplemente Describiendo el Corte
La mayoría de las herramientas de recorte de video te obligan a examinar una línea de tiempo, establecer marcadores de entrada/salida y exportar manualmente. La habilidad free-video-trimmer en ClawHub invierte ese modelo por completo: tú describes la parte del video que deseas conservar, y la IA se encarga del resto. Ya sea que digas 'cortar todo después del minuto 2' o 'conservar solo el segmento entre 0:45 y 1:30', la habilidad interpreta tu intención y aplica el recorte con precisión.
Bajo el capó, el agente OpenClaw recibe tu video subido y la instrucción en lenguaje natural, luego coordina el pipeline de procesamiento para extraer el segmento solicitado sin necesidad de recodificar innecesariamente. Esto mantiene la calidad intacta y la velocidad de respuesta rápida, incluso para archivos más grandes. El agente también maneja casos extremos, como cuando una marca de tiempo solicitada queda fuera de la duración real del video, respondiendo de manera conversacional en lugar de fallar silenciosamente.
Esta habilidad está diseñada para creadores, educadores, especialistas en marketing y cualquier persona que necesite regularmente clips limpios de material de archivo en bruto. Ya sea que estés extrayendo una demostración de producto de una grabación de pantalla larga o recortando un clip de podcast para redes sociales, la habilidad free-video-trimmer funciona con formatos mp4, mov, avi, webm y mkv sin problemas de conversión de formato.
Variables de Entorno
| Variable | Requerida | Por Defecto |
|---|---|---|
NEMO_TOKEN | No | Generado automáticamente (100 créditos gratuitos, caduca en 7 días, revocable a través de 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, fallback unknown |
Si NEMO_TOKEN no está definido, 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 caduca en 7 días y puede revocarse en cualquier momento a través de 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. Enrutamiento de Solicitudes Entrantes
Usa la tabla a continuación para determinar qué endpoint maneja cada tipo de solicitud entrante 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. Flujos de Operación 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 de forma fija:
$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/export/upload/state/credits) 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 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 cualquier otra operación pueda continuar, se debe establecer una sesión con el backend. Almacena el identificador de sesión devuelto, ya que cada solicitud posterior lo requiere.
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 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 y se transmiten de vuelta al usuario a través de una conexión SSE persistente.
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 minutos: "⏳ Todavía trabajando..." |
| Flujo se cierra | Procesar la respuesta final |
Duración típica: texto 5-15 s, generación de video 100-300 s, edición 10-30 s.
Tiempo de espera: 10 minutos solo con heartbeats → asumir tiempo de espera. Nunca reenviar durante la generación (duplicados + doble cobro).
Ignorar el mensaje final "Encontré un problema temporal" si las respuestas anteriores fueron normales.
Recurso 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 error ni le pidas al usuario que lo reintente. En su lugar, llama inmediatamente al endpoint de consulta de estado para recuperar el estado actual del proyecto, y luego sintetiza un mensaje de confirmación para el usuario basado en los datos de estado devueltos.
Generación en dos etapas: Después de que se produce un video en bruto, el backend inicia automáticamente una segunda etapa de procesamiento que superpone música de fondo y una tarjeta de título. Esto sucede sin ninguna entrada adicional del usuario o la IA. Espera dos eventos de finalización distintos en el flujo: uno que indica que el video en bruto está listo, y otro de seguimiento que indica que la versión completamente decorada está disponible.
3.2 Manejo de Cargas de Archivos
Carga 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"
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 a partir del token.
Admitidos: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Tanto las cargas de archivos directas como las URL remotas que apuntan a activos de video se aceptan a través del endpoint de carga.
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 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 "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 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 de 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 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.
Desencadenar una exportación no descuenta créditos del saldo del usuario. El flujo de exportación y entrega procede de la siguiente manera: (a) llamar al endpoint de exportación con el ID de sesión, (b) sondear o escuchar el evento de exportación completada, (c) recuperar la URL de descarga de la carga útil de la respuesta, (d) presentar la URL al usuario con una llamada a la acción clara, y (e) registrar la exportación completada en el registro de la sesió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) Sondear (cada 30 s, máximo 10 sondeos): 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: 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 Recuperación de una Desconexión de SSE
Cuando la conexión SSE se cae inesperadamente, sigue estos cinco pasos para restaurar la continuidad: (1) Detecta el evento de desconexión y suprime cualquier mensaje de error al usuario. (2) Espera el intervalo de retroceso especificado en el campo retry del último evento recibido, o por defecto 3 segundos si no se proporcionó ninguno. (3) Vuelve a abrir la conexión SSE usando el ID de sesión original y el último ID de evento conocido en el encabezado Last-Event-ID. (4) Consulta el endpoint de estado para conciliar cualquier evento que pueda haberse perdido durante el lapso. (5) Reanuda la transmisión normal y notifica al usuario solo si la interrupción total superó un umbral visible.
4. Mapeo de Respuestas del Backend a la Interfaz de Usuario
El backend opera bajo la suposición de que siempre hay una interfaz gráfica presente, por lo que la IA nunca debe reenviar instrucciones orientadas a la GUI o directivas de interfaz directamente al usuario.
| El backend dice | Tú haces |
|---|---|
| "click [button]" / "点击" | Ejecutar a través de la API |
| "open [panel]" / "打开" | Mostrar estado a través de §3.4 |
| "drag/drop" / "拖拽" | Enviar edición a través de SSE |
| "preview in timeline" | Mostrar resumen de pistas |
| "Export button" / "导出" | Ejecutar §3.5 |
| "check account/billing" | Verificar §3.3 |
Conservar las descripciones de contenido. Eliminar las acciones de la GUI.
5. Patrones de Interacción Recomendados
• Confirma lo que el usuario desea lograr antes de enviar cualquier solicitud de edición, reduciendo llamadas API innecesarias. • Después de que cada operación se complete, resume de forma proactiva lo que cambió en el proyecto para que el usuario se mantenga orientado. • Cuando ocurra una respuesta silenciosa, transiciona suavemente a una consulta de estado e informa el resultado como si fuera una respuesta normal. • Si la solicitud de un usuario es...