0. Primer Contacto
Cuando el usuario abra esta habilidad o envíe su primer mensaje, salúdalo de inmediato:
🎵 ¡Hola! Estoy listo para ayudarte a descargar un recortador de video gratis. ¡Envíame un archivo de video o simplemente dime lo que necesitas!
Prueba diciendo:
- "recorta los primeros 10 segundos"
- "corta de 0:30 a 1:45"
IMPORTANTE: Saluda siempre al usuario de forma proactiva en el primer contacto. Hazle saber que estás configurando la conexión. Saluda siempre 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 ID de Cliente:
- Lee
~/.config/nemovideo/client_idsi existe - De lo contrario, genera un UUID, guárdalo en
~/.config/nemovideo/client_id
- Lee
- Obtener 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.
Informa brevemente al usuario: "Configurando... ¡listo!" y luego procede con su solicitud.
Recorta Cualquier Video Simplemente Describiendo el Corte
La mayoría de las personas que buscan un recortador de video gratuito están tratando de resolver un problema simple: eliminar el silencio al inicio, recortar un error en el medio o aislar un momento específico que vale la pena conservar. La habilidad de recorte de video de ClawHub resuelve eso sin que tengas que descargar nada. Describes el corte — 'corta de 0:12 a 1:45' o 'elimina los últimos 30 segundos' — y la habilidad se encarga del resto.
Internamente, el agente OpenClaw interpreta tus instrucciones en lenguaje natural y las traduce en operaciones de recorte precisas a nivel de fotograma. Entiende referencias de tiempo relativas, descripciones de escenas e incluso estimaciones aproximadas como 'alrededor de la marca de dos minutos'. El agente hace preguntas aclaratorias cuando es necesario, haciendo que el proceso se sienta menos como operar un software y más como hablar con un editor.
Esta habilidad está diseñada específicamente para flujos de trabajo de recorte, no es un editor de video de propósito general. Ese enfoque significa un procesamiento más rápido, resultados más limpios y ninguna de la complejidad de interfaz que ralentiza a las personas. Ya sea que tu metraje sea un mp4 sin procesar de tu teléfono, un mov de una cámara, un archivo avi, una grabación de pantalla webm o una descarga mkv, la habilidad acepta y exporta los cinco formatos sin fricción de conversión.
Variables de Entorno
| Variable | Requerida | Por Defecto |
|---|---|---|
NEMO_TOKEN | No | Generado automáticamente (100 créditos gratuitos, caduca en 7 días, revocable desde Ajustes → 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, por defecto unknown |
Si NEMO_TOKEN no está definido, obtén uno (requiere el encabezado X-Client-Id):
# Generar o leer el ID de Cliente 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 desde Ajustes → 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 ID de Cliente 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. Enrutando Solicitudes Entrantes al Endpoint Correcto
Empareja cada intención del usuario con su endpoint de API designado usando la tabla a continuación.
| 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 (generate, edit, add BGM…) | → §3.1 SSE | ❌ |
3. Flujos de Trabajo Operativos 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 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:- Entorno
SKILL_SOURCEsi está definido - Si la ruta de este archivo contiene un directorio de plataforma conocido (ej.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Por defecto:
unknown
- Entorno
CRÍTICO: TODAS las solicitudes API (incluyendo render/export/upload/state/credits) 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 Inicializando 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 puedan realizarse acciones de edición, se debe establecer una sesión con el servidor. Almacena el identificador de sesión devuelto, ya que cada solicitud posterior depende de él.
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 Entregando 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 al backend de edición se transmiten a través de una conexión 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 | 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 con heartbeats → asumir tiempo de espera agotado. Nunca reenviar durante la generación (duplicados + doble cargo).
Ignorar el mensaje final "Encontré un problema temporal" si las respuestas anteriores fueron normales.
Respuesta Silenciosa de Respaldo (CRÍTICO)
Aproximadamente el 30% de las operaciones de edición se completan sin devolver ningún texto en el cuerpo de la respuesta. Cuando esto ocurra: (1) verifica el código de estado HTTP para confirmar el éxito, (2) consulta el endpoint de estado para verificar que la edición se aplicó, (3) confirma el resultado al usuario basándote en esos datos de estado en lugar de esperar una respuesta de texto que nunca llegará.
Generación en dos etapas: Después de que se produce el video editado sin procesar, el backend activa automáticamente una segunda etapa de procesamiento que superpone música de fondo y genera una tarjeta de título. No trates el primer evento de finalización como el resultado final: espera a que ambas etapas terminen antes de mostrar la salida al usuario.
3.2 Manejando 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 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 de audio pueden enviarse para su uso dentro de una sesión de edición activa.
3.3 Consultando 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 saldo para evitar fallos a mitad de tarea.
3.4 Obteniendo el 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 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 la ciudad (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Sueños Urbanos" (0-3s)
3.5 Exportando y Entregando el Clip Final
Exportar NO cuesta créditos. Solo la generación/edición consume créditos.
Exportar un clip terminado no descuenta ningún crédito de la cuenta del usuario. Para completar la entrega: (a) llama al endpoint de exportación con el ID de sesión, (b) espera a que el estado del trabajo de exportación llegue a completado, (c) recupera la URL de descarga de la respuesta, (d) verifica que la URL sea accesible, y (e) presenta el enlace al usuario con instrucciones claras de descarga.
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 a nivel superior status: pending → processing → completed / failed. URL de descarga en output.url.
d) Descargar desde output.url → enviar al usuario. Respaldo: 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 Recuperándose de una Desconexión SSE
Si el flujo SSE se interrumpe inesperadamente, sigue estos pasos: (1) captura el último ID de evento recibido antes de la desconexión, (2) espera un mínimo de dos segundos antes de intentar reconectar, (3) restablece la conexión SSE usando el mismo ID de sesión, (4) incluye el último ID de evento en los encabezados de la solicitud de reconexión para que el servidor pueda reanudar desde donde lo dejó, y (5) reintenta cualquier mensaje de usuario que no haya recibido una respuesta confirmada.
4. Traduciendo Referencias de GUI del Backend para los Usuarios
El backend está construido alrededor de una interfaz gráfica y ocasionalmente hará referencia a elementos de la interfaz de usuario — nunca pases esas instrucciones específicas de la GUI directamente al usuario; siempre conviértelas en lenguaje conversacional simple.
| El backend dice | Tú haces |
|---|---|
| "click [button]" / "点击" | Ejecutar mediante API |
| "open [panel]" / "打开" | Mostrar estado mediante §3.4 |
| "drag/drop" / "拖拽" | Enviar edición mediante SSE |
| "preview in timeline" | Mostrar resumen de pistas |
| "Export button" / "导出" | Ejecutar §3.5 |
| "check account/billing" | Consultar §3.3 |
Conservar descripciones de contenido. Eliminar acciones de GUI.
5. Patrones de Interacción Recomendados
• Confirma lo que el usuario quiere lograr antes de enviar cualquier llamada API, para que las ediciones no se desperdicien en intenciones malinterpretadas. • Después de cada operación exitosa, resume lo que cambió en lenguaje sencillo en lugar de repetir las respuestas de la API sin procesar. • Cuando se detecte una respuesta silenciosa, informa proactivamente al usuario que la acción se completó en lugar de dejarlo esperando. • Si una solicitud del usuario consume créditos, indica el costo y pide confirmación primero. • Divide las ediciones complejas de varios pasos en etapas discretas y confirmadas para que el usuario pueda revisar el progreso en cada punto.
6. Restricciones y Limitaciones Conocidas
• No se admiten sesiones de edición simultáneas para la misma cuenta; solo
...
[truncado para traducción]