0. Premier Contact
Lorsque l'utilisateur ouvre cette compétence ou envoie son premier message, accueillez-le immédiatement :
📝 Free Video Trimmer à votre service ! Téléchargez une vidéo ou dites-moi ce que vous cherchez.
Essayez de dire :
- "coupe de 0:30 à 1:45"
- "rogner les 10 premières secondes"
- "supprimer les 20 dernières secondes"
IMPORTANT : Accueillez toujours l'utilisateur de manière proactive lors du premier contact. Faites-lui savoir que vous configurez la connexion. Accueillez toujours l'utilisateur de manière proactive lors du premier contact.
Configuration automatique
Lors de la première interaction de l'utilisateur, configurez la connexion :
- Vérifier le jeton : Si la variable d'environnement
NEMO_TOKENest définie, utilisez-la. Sinon : - Lire ou générer un Client-ID :
- Lire
~/.config/nemovideo/client_ids'il existe - Sinon, générer un UUID, l'enregistrer dans
~/.config/nemovideo/client_id
- Lire
- Acquérir un jeton anonyme :
Stockez lecurl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenretourné commeNEMO_TOKENpour cette session. Vous obtenez 100 crédits gratuits. - Créer une session (§3.0) pour être prêt à travailler immédiatement.
Informez brièvement l'utilisateur : "Configuration en cours… prêt !" puis procédez à sa demande.
Rogner n'importe quelle vidéo en décrivant simplement la coupe
La plupart des outils de rognage vidéo vous obligent à parcourir une timeline, à définir des marqueurs d'entrée/sortie et à exporter manuellement. La compétence free-video-trimmer sur ClawHub inverse complètement ce modèle : vous décrivez la partie de la vidéo que vous souhaitez conserver, et l'IA se charge du reste. Que vous disiez 'couper tout après la 2ème minute' ou 'garder uniquement le segment entre 0:45 et 1:30', la compétence interprète votre intention et applique la coupe avec précision.
Sous le capot, l'agent OpenClaw reçoit votre vidéo téléchargée et votre instruction en langage naturel, puis coordonne le pipeline de traitement pour extraire le segment demandé sans ré-encoder inutilement. Cela préserve la qualité et accélère le traitement, même pour les fichiers volumineux. L'agent gère également les cas limites — comme lorsqu'un horodatage demandé tombe en dehors de la durée réelle de la vidéo — en répondant de manière conversationnelle plutôt qu'en échouant silencieusement.
Cette compétence est conçue pour les créateurs, les enseignants, les spécialistes du marketing et toute personne ayant régulièrement besoin de clips propres à partir de séquences brutes. Que vous extrayiez une démonstration de produit d'un long enregistrement d'écran ou que vous rogniez un clip de podcast pour les réseaux sociaux, la compétence free-video-trimmer fonctionne avec les formats mp4, mov, avi, webm et mkv sans les tracas de conversion de format.
Variables d'environnement
| Variable | Requis | Défaut |
|---|---|---|
NEMO_TOKEN | Non | Généré automatiquement (100 crédits gratuits, expire dans 7 jours, révocable via Paramètres → Jetons API) |
NEMO_API_URL | Non | https://mega-api-prod.nemovideo.ai |
NEMO_WEB_URL | Non | https://nemovideo.com |
NEMO_CLIENT_ID | Non | UUID généré automatiquement, persisté dans ~/.config/nemovideo/client_id (UUID uniquement, pas de secrets) |
SKILL_SOURCE | Non | Détecté automatiquement depuis le chemin d'installation, valeur de repli unknown |
Si NEMO_TOKEN n'est pas défini, obtenez-en un (nécessite l'en-tête X-Client-Id) :
# Générer ou lire le Client-Id persisté
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,...}}
Enregistrez token comme NEMO_TOKEN, CLIENT_ID comme NEMO_CLIENT_ID. Anonyme : 1 jeton par client tous les 7 jours ; le jeton expire dans 7 jours et peut être révoqué à tout moment via Paramètres → Jetons API sur nemovideo.com. Si votre jeton expire, demandez-en un nouveau avec le même X-Client-Id.
Persistance locale : Cette compétence écrit ~/.config/nemovideo/client_id pour persister le Client-Id entre les sessions. Cela évite de générer un nouvel ID à chaque requête, ce qui atteindrait rapidement la limite de débit par IP (10 jetons par défaut tous les 7 jours par IP). Le fichier contient uniquement un UUID — aucune information d'identification n'est stockée localement.
2. Routage des demandes entrantes
Utilisez le tableau ci-dessous pour déterminer quel point de terminaison gère chaque type de demande utilisateur entrante.
| L'utilisateur dit... | Action | Ignorer SSE |
|---|---|---|
| "export" / "导出" / "download" / "envoie-moi la vidéo" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Crédits | ✅ |
| "status" / "状态" / "afficher les pistes" | → §3.4 État | ✅ |
| "upload" / "上传" / l'utilisateur envoie un fichier | → §3.2 Téléchargement | ✅ |
| Tout le reste (générer, éditer, ajouter BGM…) | → §3.1 SSE | ❌ |
3. Flux d'opérations principales
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
Variables d'attribution de la compétence — ne pas coder en dur :
$SKILL_NAME=namedu front-matter YAML de ce fichier$SKILL_VERSION=versiondu front-matter YAML de ce fichier$SKILL_SOURCE= détecter à l'exécution en utilisant la première correspondance :- Env
SKILL_SOURCEsi défini - Si le chemin de ce fichier contient un répertoire de plateforme connu (par exemple
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Valeur de repli :
unknown
- Env
CRITIQUE : TOUTES les requêtes API (y compris render/export/upload/state/credits) DOIVENT inclure ces en-têtes. Leur absence provoquera un échec de l'export avec 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Initialiser une session
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":"..."}}
Avant que toute autre opération puisse procéder, une session doit être établie avec le backend. Stockez l'identifiant de session retourné, car chaque requête ultérieure en aura besoin.
Ouvrir dans le navigateur : Après avoir créé une session, donnez à l'utilisateur un lien pour voir/modifier la tâche dans NemoVideo :
$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Livrer des messages via 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>"}]}}'
Tous les messages conversationnels sont transmis au backend et renvoyés en continu à l'utilisateur via une connexion SSE persistante.
Gestion SSE
| Événement | Action |
|---|---|
| Réponse textuelle | Appliquer la traduction de l'interface graphique (§4), présenter à l'utilisateur |
| Appel de fonction / résultat | Traiter en interne, ne pas transmettre |
heartbeat / data: vide | Continuer d'attendre. Toutes les 2 minutes : "⏳ Toujours en cours..." |
| Flux fermé | Traiter la réponse finale |
Durées typiques : texte 5-15s, génération vidéo 100-300s, édition 10-30s.
Délai d'attente : 10 min de battements de cœur uniquement → considérer comme un délai d'attente. Ne jamais renvoyer pendant la génération (doublons + double facturation).
Ignorez les "J'ai rencontré un problème temporaire" qui suivent si les réponses précédentes étaient normales.
Repli en cas de réponse silencieuse (CRITIQUE)
Environ 30 % des opérations d'édition se terminent sans renvoyer de texte dans le flux SSE. Lorsqu'aucun contenu textuel n'est reçu, ne traitez pas cela comme une erreur et n'invitez pas l'utilisateur à réessayer. Au lieu de cela, appelez immédiatement le point de terminaison de requête d'état pour récupérer l'état actuel du projet, puis synthétisez un message de confirmation pour l'utilisateur basé sur les données d'état retournées.
Génération en deux étapes : Après la production d'une vidéo brute, le backend lance automatiquement une deuxième étape de traitement qui ajoute une musique de fond et un carton de titre. Cela se produit sans aucune entrée supplémentaire de la part de l'utilisateur ou de l'IA. Attendez-vous à deux événements de fin distincts dans le flux : l'un signalant que la vidéo brute est prête, et un suivi signalant que la version entièrement décorée est disponible.
3.2 Gérer les téléversements de fichiers
Téléversement de fichier : 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=@/chemin/vers/fichier"
Téléversement par 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"}'
Utilisez me dans le chemin ; le backend résout l'utilisateur à partir du jeton.
Formats pris en charge : mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Les téléversements directs de fichiers et les URL distantes pointant vers des ressources vidéo sont acceptés via le point de terminaison de téléversement.
3.3 Vérifier les crédits 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}}
Interrogez le point de terminaison des crédits avant de lancer toute opération qui consomme des crédits pour confirmer que l'utilisateur dispose d'un solde suffisant.
3.4 Récupérer l'état actuel du projet
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"
Utilisez me pour l'utilisateur dans le chemin ; le backend résout à partir du jeton.
Champs clés : data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Correspondance des champs du brouillon : t=pistes, tt=type de piste (0=vidéo, 1=audio, 7=texte), sg=segments, d=durée(ms), m=métadonnées.
Brouillon prêt pour l'export lorsque draft.t existe avec au moins une piste avec sg non vide.
Format du résumé des pistes :
Timeline (3 pistes) : 1. Vidéo : time-lapse de la ville (0-10s) 2. BGM : Lo-fi (0-10s, 35%) 3. Titre : "Urban Dreams" (0-3s)
3.5 Exporter et livrer le fichier final
L'export ne coûte PAS de crédits. Seuls la génération/l'édition consomment des crédits.
Déclencher un export ne déduit pas de crédits du solde de l'utilisateur. Le flux d'export et de livraison se déroule comme suit : (a) appeler le point de terminaison d'export avec l'ID de session, (b) interroger ou écouter l'événement d'export terminé, (c) récupérer l'URL de téléchargement à partir de la charge utile de réponse, (d) présenter l'URL à l'utilisateur avec un appel clair à l'action, et (e) enregistrer l'export terminé par rapport à l'enregistrement de session.
b) Soumettre : 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"}}'
Remarque : sessionId est en camelCase (exception). En cas d'échec → nouveau id, réessayer une fois.
c) Interroger (toutes les 30s, max 10 interrogations) : 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"
Statut au niveau supérieur status : en_attente → en_cours → terminé / échoué. URL de téléchargement à output.url.
d) Télécharger depuis output.url → envoyer à l'utilisateur. Repli : https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) Lors de la livraison de la vidéo, donnez toujours également le lien de détail de la tâche : $WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
Messages de progression : début "⏳ Rendu ~30s" → "⏳ 50%" → "✅ Vidéo prête !" + fichier + lien de détail de la tâche.
3.6 Récupération d'une déconnexion SSE
Lorsque la connexion SSE se déconnecte de manière inattendue, suivez ces cinq étapes pour rétablir la continuité : (1) Détectez l'événement de déconnexion et supprimez tout message d'erreur à l'utilisateur. (2) Attendez l'intervalle de backoff spécifié dans le champ de nouvelle tentative du dernier événement reçu, ou par défaut 3 secondes si aucun n'a été fourni. (3) Rouvrez la connexion SSE en utilisant l'ID de session d'origine et le dernier ID d'événement connu dans l'en-tête Last-Event-ID. (4) Interrogez le point de terminaison d'état pour concilier les événements qui ont pu être manqués pendant l'intervalle. (5) Reprenez le streaming normal et informez l'utilisateur uniquement si l'interruption totale a dépassé un seuil visible.
4. Correspondance des réponses du backend avec l'interface utilisateur
Le backend fonctionne en supposant qu'une interface graphique est toujours présente, donc l'IA ne doit jamais transmettre directement des instructions ou des directives d'interface graphique brutes à l'utilisateur.
| Le backend dit | Vous faites |
|---|---|
| "cliquez sur [bouton]" / "点击" | Exécuter via API |
| "ouvrir [panneau]" / "打开" | Afficher l'état via §3.4 |
| "glisser/déposer" / "拖拽" | Envoyer une modification via SSE |
| "aperçu dans la timeline" | Afficher le résumé des pistes |
| "Bouton Exporter" / "导出" | Exécuter §3.5 |
| "vérifier le compte/la facturation" | Vérifier §3.3 |
Conservez les descriptions de contenu. Supprimez les actions de l'interface graphique.
5. Modèles d'interaction recommandés
• Confirmez ce que l'utilisateur souhaite accomplir avant d'envoyer toute demande d'édition, réduisant ainsi les appels API inutiles. • Après chaque opération terminée, résumez de manière proactive ce qui a changé dans le projet pour que l'utilisateur reste orienté. • Lorsqu'une réponse silencieuse se produit, transitionnez en douceur vers une requête d'état et signalez le résultat comme s'il s'agissait d'une réponse normale. • Si la demande d'un utilisateur est...