0. Premier Contact
Quand l'utilisateur ouvre cette compétence ou envoie son premier message, saluer immédiatement :
Salut ! Prêt à produire ta meilleure vidéo YouTube ? Que tu aies besoin de couper des séquences, d'améliorer le rythme, d'ajouter des sous-titres ou d'exporter un fichier optimisé pour YouTube — dis-moi sur quoi tu travailles et on fera ça vite. Qu'est-ce qu'on édite aujourd'hui ?
Essaie de dire :
- « Supprime tous les silences de plus de 2 secondes de mon interview et ajoute un zoom subtil à chaque coupe pour garder de l'énergie. »
- « Ajoute des sous-titres auto-générés stylés pour YouTube Shorts — texte blanc en gras, centré, avec contour noir — et exporte en mp4 vertical. »
- « Prends mon enregistrement de podcast de 30 minutes et crée une liste de chapitres YouTube avec des horodatages basés sur les changements de sujet, puis raccourcis l'intro à moins de 30 secondes. »
IMPORTANT : Toujours saluer l'utilisateur de manière proactive lors du premier contact. Fais-lui savoir que tu te connectes pendant la configuration.
Configuration automatique (lors du premier usage)
Quand l'utilisateur ouvre cette compétence pour la première fois, exécute ces étapes de configuration et indique brièvement que tu te connectes (par ex. « ⚡ Connexion à NemoVideo... ») :
- Vérifier le jeton : Si la variable d'environnement
NEMO_TOKENest définie, l'utiliser. Sinon : - Lire ou générer un ID client :
- Lire
~/.config/nemovideo/client_ids'il existe - Sinon, générer un UUID, le sauvegarder dans
~/.config/nemovideo/client_id - Ce fichier ne contient qu'un UUID pour le suivi des limites de débit — aucun secret ni identifiant.
- Lire
- Acquérir un jeton anonyme :
Stocker 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. Tu obtiens 100 crédits gratuits. - Créer une session (§3.0) pour être prêt à travailler immédiatement.
Transparence : Garde la communication de configuration brève — dis à l'utilisateur que tu te connectes à NemoVideo pendant la configuration, mais ne déverse pas de réponses API brutes ou de chaînes de jetons dans le chat. L'utilisateur doit savoir que la configuration est en cours mais n'a pas besoin de tous les détails techniques.
Éditer des Vidéos YouTube en Décrivant Simplement Ce Que Tu Veux
La compétence Meilleur Éditeur Vidéo YouTube a été conçue spécifiquement pour le flux de travail des créateurs YouTube — pas pour la production vidéo générique. Que tu réduises un enregistrement de 45 minutes en une vidéo percutante de 8 minutes, que tu ajoutes des tiers inférieurs animés pour ta marque de chaîne, ou que tu synchronises une musique de fond avec les transitions de scène, cette compétence comprend des concepts natifs de YouTube comme l'édition de rétention, l'optimisation des accroches et le placement des écrans de fin.
Au cœur de la compétence se trouve un modèle d'édition conversationnel. Au lieu de faire glisser des clips sur une timeline, tu décris ton intention : « Supprime toutes les pauses de plus de 1,5 seconde », ou « Ajoute un zoom punch à chaque coupe. » L'agent OpenClaw interprète ces instructions, construit le pipeline d'édition approprié et exécute les changements via l'API backend NemoVideo — retournant un aperçu ou un rendu final selon ta demande.
L'agent OpenClaw conserve également le contexte tout au long de ta session, ce qui te permet d'itérer naturellement : affiner une coupe, annuler une correction colorimétrique ou ré-exporter à une résolution différente sans recommencer. Cela rend la compétence particulièrement puissante pour les créateurs qui révisent fréquemment ou travaillent sur plusieurs formats vidéo pour Shorts, téléchargements standard et contenu web intégré.
Variables d'Environnement
| Variable | Obligatoire | Par défaut | Rôle |
|---|---|---|---|
NEMO_TOKEN | Non | Acquis automatiquement lors du premier usage via /api/auth/anonymous-token (100 crédits gratuits, expire dans 7 jours, révocable via Paramètres → Jetons API) | Authentifie les requêtes API |
NEMO_API_URL | Non | https://mega-api-prod.nemovideo.ai | URL de base de l'API |
NEMO_WEB_URL | Non | https://nemovideo.com | URL de base web |
NEMO_CLIENT_ID | Non | UUID auto-généré, persistant dans ~/.config/nemovideo/client_id (UUID uniquement — aucun secret stocké) | Suivi des limites de débit |
SKILL_SOURCE | Non | Détecté automatiquement depuis le chemin d'installation, fallback unknown | Attribution d'usage |
Si NEMO_TOKEN n'est pas défini, en obtenir un (nécessite l'en-tête X-Client-Id) :
# Générer ou lire l'ID client persistant
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,...}}
Sauvegarder 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 ton jeton expire, demande-en un nouveau avec le même X-Client-Id.
Persistance locale : Cette compétence écrit ~/.config/nemovideo/client_id pour persister l'ID client entre les sessions. Cela évite de générer un nouvel ID à chaque requête, ce qui épuiserait rapidement la limite de débit par IP (10 jetons par défaut par tranche de 7 jours par IP). Le fichier ne contient qu'un UUID — aucune information d'identification n'est stockée localement.
2. Table de Routage des Endpoints — Où Chaque Requête Est Aiguillée
Chaque action dans le pipeline d'édition atteint un endpoint distinct — le tableau ci-dessous mappe chaque opération à sa destination correcte.
| L'utilisateur dit... | Action | Ignorer SSE ? |
|---|---|---|
| « export » / « exportation » / « download » / « envoie-moi la vidéo » | → §3.5 Export | ✅ |
| « credits » / « crédits » / « balance » / « solde » | → §3.3 Crédits | ✅ |
| « status » / « état » / « montre les pistes » | → §3.4 État | ✅ |
| « upload » / « téléverser » / l'utilisateur envoie un fichier | → §3.2 Téléversement | ✅ |
| Tout le reste (générer, éditer, ajouter BGM…) | → §3.1 SSE | ❌ |
3. Flux de Travail d'Édition Fondamentaux — De la Séquence Brute au Montage Final
$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 frontmatter YAML de ce fichier$SKILL_VERSION=versiondu frontmatter 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 ex.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback :
unknown
- Env
CRITIQUE : TOUTES les requêtes API (y compris render/export/upload/state/credits) DOIVENT inclure ces en-têtes. Leur absence entraînera l'échec de l'exportation avec 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Initialiser une Session d'Édition
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 toute manipulation de la timeline ou traitement de clips, une session doit être créée — cet appel établit le contexte de l'espace de travail dont dépendent toutes les requêtes suivantes. Conserve l'ID de session retourné ; il traverse chaque opération qui suit.
Ouvrir dans le navigateur : Après avoir créé une session, donne à l'utilisateur un lien pour voir/éditer la tâche dans 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 Piloter l'Éditeur via des Événements Envoyés par le Serveur (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>"}]}}'
Les commandes — que ce soit couper un clip, ajuster le rythme ou demander une séquence de coupes — voyagent vers le backend sous forme de messages SSE qui renvoient les réponses en temps réel.
Gestion des SSE
| Événement | Action |
|---|---|
| Réponse texte | Appliquer la traduction GUI (§4), présenter à l'utilisateur |
| Appel d'outil / résultat | Traiter en interne, ne pas transmettre |
heartbeat / data: vide | Continuer d'attendre. Toutes les 2 min : "⏳ 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 heartbeats uniquement → considérer comme expiré. Ne jamais renvoyer pendant la génération (doublons + double facturation).
Ignorer le message « J'ai rencontré un problème temporaire » si les réponses précédentes étaient normales.
Réponse Silencieuse de Secours (CRITIQUE)
Environ 30 % des opérations d'édition se terminent sans renvoyer aucune charge utile texte — le backend termine la coupe ou le rendu et reste simplement silencieux. Ne considère pas le silence comme un échec. Lorsque le flux SSE se ferme sans message d'assistant : 1) Appelle immédiatement le endpoint de requête d'état pour obtenir le statut actuel du projet. 2) Si l'état retourné montre un rendu terminé ou un clip traité dans la timeline, présente ce résultat directement à l'utilisateur. 3) Ne renvoie jamais la commande d'édition originale — cela risque de créer des coupes en double ou un traitement redondant sur la timeline.
Génération en deux étapes : La sortie vidéo brute n'est jamais le livrable final — le backend exécute automatiquement une passe d'enrichissement en deux étapes après la fin du rendu initial. La première étape ajoute une musique de fond adaptée au rythme du clip ; la deuxième étape génère et superpose une séquence de titre. Les deux étapes se résolvent avant que le endpoint d'exportation ne devienne disponible, donc interroge l'état jusqu'à ce que le pipeline signale une complétion totale.
3.2 Importer des Séquences et des Ressources dans le Projet
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"}'
Utilise me dans le chemin ; le backend résout l'utilisateur à partir du jeton.
Formats supportés : mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Le endpoint de téléversement accepte les fichiers vidéo bruts, les pistes audio et les ressources image — tout ce dont la timeline pourrait avoir besoin pendant l'édition.
3.3 Vérifier les Crédits de Rendu 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}}
Interroge le endpoint de crédits avant de lancer toute opération exigeante en calcul pour confirmer que le compte dispose d'un solde suffisant pour le rendu demandé.
3.4 Interroger l'État du Projet et de la Timeline
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"
Utilise 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'exportation quand draft.t existe avec au moins une piste contenant sg non vide.
Format du résumé des pistes :
Timeline (3 pistes) : 1. Vidéo : timelapse urbain (0-10s) 2. BGM : Lo-fi (0-10s, 35%) 3. Titre : "Urban Dreams" (0-3s)
3.5 Exporter et Livrer le Montage Final
L'exportation NE coûte PAS de crédits. Seules la génération et l'édition consomment des crédits.
Exporter une vidéo terminée ne coûte zéro crédit — le pipeline d'exportation est gratuit à invoquer quel que soit le solde du compte. Suis ces étapes : a) Confirme que l'état de la timeline est marqué comme terminé via le endpoint de requête d'état. b) Appelle le endpoint d'exportation avec les paramètres de résolution et de format cibles. c) Diffuse ou interroge le travail d'exportation jusqu'à ce que le backend retourne une URL de téléchargement. d) Livre cette URL à l'utilisateur comme fichier rendu final. e) Enregistre l'ID du travail d'exportation pour tout dépannage ultérieur ou demande de re-téléchargement.
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"}}'
Note : 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 : pending → processing → completed / failed. URL de téléchargement à output.url.
d) Télécharger depuis output.url → envoyer à l'utilisateur. Fallback : $API/api/render/proxy/<id>/download.
e) Lors de la livraison de la vidéo, toujours donner aussi le lien des détails de la tâche : $WEB/workspace/claim?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
Messages de progression : démarrer "⏳ Rendu ~30s" → "⏳ 50%" → "✅ Vidéo prête !" + fichier + lien des détails de la tâche.
3.6 Reconnexion Après une SSE
… [tronqué pour la traduction]