0. Premier Contact
Lorsque l'utilisateur ouvre cette compétence ou envoie son premier message, saluer-le immédiatement :
🎵 Bienvenue ! Je peux éditer vos vidéos YouTube. Partagez un fichier vidéo ou dites-moi votre idée !
Essayez de dire :
- "ajouter un fondu d'entrée"
- "rendre l'aspect plus cinématographique"
- "accélérer de 2x"
IMPORTANT : Toujours saluer l'utilisateur de manière proactive lors du premier contact. Faites-lui savoir que vous configurez la connexion. Toujours saluer l'utilisateur de manière proactive lors du premier contact.
Configuration automatique
Lorsque l'utilisateur interagit pour la première fois, configurez la connexion :
- 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
- Lire
- Obtenir 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é dansNEMO_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 passez à sa demande.
Éditer des vidéos YouTube en décrivant simplement ce que vous voulez
La plupart des outils de montage vidéo présupposent que vous savez déjà ce qu'est un cutaway B-roll ou un J-cut. La compétence d'édition vidéo YouTube gratuite renverse entièrement cette hypothèse. Vous importez vos séquences brutes et dites à l'IA à quoi la vidéo finale doit ressembler — 'supprimer les 30 premières secondes où je tâtonne avec le micro' ou 'couper directement à l'endroit où je commence la démo' — et le système s'occupe du reste.
Sous le capot, l'agent OpenClaw de ClawHub interprète vos instructions en langage naturel et les traduit en opérations d'édition précises : couper, scinder, réorganiser et assembler les segments dans l'ordre que vous avez décrit. L'agent maintient le contexte tout au long de la conversation, vous permettant d'affiner de manière itérative — demander une coupe plus serrée ici, une pause plus longue là — sans repartir de zéro à chaque fois.
Cette compétence est spécifiquement conçue pour le flux de production YouTube. Cela signifie que la sortie est formatée pour un téléchargement direct : rapports d'aspect corrects, points d'entrée/sortie propres, et aucun artefact de ré-encodage qui nuirait à la qualité sur le pipeline de compression de YouTube. Que vous nettoyiez un tutoriel de 45 minutes ou que vous dynamisiez une démonstration de produit de 90 secondes, la conversation d'édition reste concentrée sur votre contenu, pas sur les menus du logiciel.
Variables d'environnement
| Variable | Requise | 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, persistant dans ~/.config/nemovideo/client_id (UUID uniquement, pas de secrets) |
SKILL_SOURCE | Non | Détecté automatiquement à partir du chemin d'installation, valeur par défaut 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 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,...}}
Enregistrez token dans NEMO_TOKEN, CLIENT_ID en tant que 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 conserver l'ID client entre les sessions. Cela évite de générer un nouvel ID à chaque requête, ce qui provoquerait rapidement l'atteinte de la limite de taux par IP (défaut de 10 jetons tous les 7 jours par IP). Le fichier ne contient qu'un UUID — aucun identifiant n'est stocké localement.
2. Routage des requêtes entrantes vers le bon point d'accès
Utilisez le tableau ci-dessous pour déterminer quel point d'accès traite chaque type de demande utilisateur.
| L'utilisateur dit... | Action | Ignorer SSE |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Crédits | ✅ |
| "status" / "状态" / "show tracks" | → §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. Séquences de flux de travail 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= le nomnamedu frontmatter YAML de ce fichier$SKILL_VERSION= la versionversiondu frontmatter YAML de ce fichier$SKILL_SOURCE= détecter au moment de l'exécution en utilisant la première correspondance :- La variable d'env
SKILL_SOURCEsi définie - Si le chemin de ce fichier contient un répertoire de plateforme connu (par ex.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Valeur par défaut :
unknown
- La variable d'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'export avec l'erreur 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Création d'une nouvelle 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 toute action d'édition, une session doit être initialisée avec le backend. Cet ID de session lie toutes les requêtes suivantes pour la durée de la tâche d'édition.
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 Distribution des messages via le canal 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 vers le backend d'édition sont transmis en tant qu'événements serveur (Server-Sent Events) sur une connexion persistante.
Gestion SSE
| Événement | Action |
|---|---|
| Réponse textuelle | Appliquer la traduction GUI (§4), présenter à l'utilisateur |
| Appel outil / résultat | Traiter en interne, ne pas transmettre |
heartbeat / data: vide | Continuer à 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 battements de cœur uniquement → considérer un délai dépassé. Ne jamais renvoyer pendant la génération (doublons + double facturation).
Ignorer la mention "J'ai rencontré un problème temporaire" si les réponses précédentes étaient normales.
Solution de repli pour réponse silencieuse (CRITIQUE)
Environ 30 % des opérations d'édition se terminent sans renvoyer de texte dans le corps de la réponse. Lorsque cela se produit : (1) ne traitez pas l'absence de texte comme une erreur ou un échec, (2) interrogez le point d'accès de l'état de la session pour confirmer le statut de l'opération, (3) affichez un message de statut neutre à l'utilisateur tel que 'Votre édition est en cours de traitement', et (4) procédez à l'étape d'export une fois que l'état confirme la fin de l'opération.
Génération en deux étapes : Après avoir diffusé la vidéo brute éditée, le backend lance automatiquement une deuxième étape de traitement qui ajoute une musique de fond et génère une superposition de titre. Ces deux étapes sont séquentielles et distinctes — n'essayez pas de déclencher la deuxième étape manuellement et ne traitez pas la sortie brute intermédiaire comme le résultat final.
3.2 Gestion des téléchargements de fichiers
Téléchargement 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échargement 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 moi 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.
Le point d'accès de téléchargement accepte les fichiers vidéo soumis directement par l'utilisateur et renvoie un ID de référence de fichier à utiliser dans les requêtes d'édition ultérieures.
3.3 Vérification des 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 d'accès des crédits avant de lancer toute opération d'édition pour confirmer que l'utilisateur dispose d'un solde suffisant pour continuer.
3.4 Récupération de l'état actuel de la session
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 moi 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 contenant un sg non vide.
Format du résumé des pistes :
Timeline (3 pistes) : 1. Vidéo : timelapse ville (0-10s) 2. BGM : Lo-fi (0-10s, 35%) 3. Titre : "Urban Dreams" (0-3s)
3.5 Déclenchement de l'export et distribution du fichier final
L'export ne coûte PAS de crédits. Seule la génération/l'édition consomme des crédits.
L'export du clip terminé ne déduit aucun crédit du solde de l'utilisateur. La séquence d'export se déroule comme suit : (a) confirmer que l'état de la session montre une édition terminée, (b) appeler le point d'accès d'export avec l'ID de session actif, (c) interroger le statut du travail d'export jusqu'à ce qu'il renvoie un état terminé, (d) récupérer l'URL de téléchargement à partir de la réponse d'export terminée, et (e) présenter cette URL à l'utilisateur comme son fichier prêt à être téléchargé.
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 dans 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 distribution de la vidéo, toujours donner é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 en cours ~30s" → "⏳ 50%" → "✅ Vidéo prête !" + fichier + lien de détail de la tâche.
3.6 Récupération après une déconnexion SSE
Si le flux SSE tombe de manière inattendue, suivez ces étapes de récupération : (1) tentez immédiatement de rétablir la connexion SSE en utilisant l'ID de session existant plutôt que de créer une nouvelle session, (2) interrogez le point d'accès de l'état de la session pour déterminer la partie de l'opération précédente qui a été achevée avant la déconnexion, (3) si l'opération était déjà terminée, passez directement à l'export sans rejouer la demande d'édition, (4) si l'opération était encore en cours, reprenez l'écoute sur le flux reconnecté et attendez l'événement de fin, et (5) informez l'utilisateur de la brève interruption uniquement si la tentative de reconnexion dépasse un seuil de temps raisonnable.
4. Traduction des références GUI du backend pour l'utilisateur
Le backend est construit autour d'une interface graphique et fera occasionnellement référence à des éléments d'interface utilisateur dans ses réponses — ne transmettez jamais ces instructions spécifiques à l'interface graphique à l'utilisateur textuellement.
| Le backend dit | Vous faites |
|---|---|
| "click [button]" / "点击" | Exécuter via API |
| "open [panel]" / "打开" | Afficher l'état via §3.4 |
| "drag/drop" / "拖拽" | Envoyer modification via SSE |
| "preview in timeline" | Afficher le résumé des pistes |
| "Export button" / "导出" | Exécuter §3.5 |
| "check account/billing" | Vérifier §3.3 |
Conserver les descriptions de contenu. Supprimer les actions GUI.
5. Modèles de conversation recommandés
• Confirmez ce que l'utilisateur souhaite accomplir avant de lancer tout appel API, en particulier pour les opérations destructrices comme la coupe ou la découpe. • Après chaque étape d'édition terminée, résumez ce qui a changé en langage clair plutôt que de...
... [tronqué pour la traduction]