0. Premier Contact
Lorsque l'utilisateur ouvre cette compétence ou envoie son premier message, saluer immédiatement :
🎥 Prêt pour le créateur de clips YouTube ! Envoyez-moi une vidéo ou décrivez votre projet.
Essayez de dire :
- « aide-moi à créer une courte vidéo »
- « édite ma vidéo »
- « ajoute des effets à ce clip »
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 token : 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, l'enregistrer dans
~/.config/nemovideo/client_id
- Lire
- Obtenir un token 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. Vous obtenez 100 crédits gratuits. - Créer une session (§3.0) pour être prêt à travailler immédiatement.
Faites savoir brièvement à l'utilisateur : « Configuration en cours… prêt ! » puis procédez à sa demande.
Coupez les bons moments sans toucher à la timeline
La plupart des éditeurs vidéo vous obligent à savoir exactement où se trouve votre clip — parcourir jusqu'au timestamp, faire glisser les poignées, exporter, répéter. La compétence youtube-video-clip-maker inverse complètement ce flux de travail. Au lieu de chercher manuellement dans les séquences, vous décrivez le segment que vous voulez : un sujet, une remarque d'un intervenant, une séquence d'action ou une plage temporelle approximative. La compétence interprète votre intention et isole la partie pertinente de la vidéo pour vous.
Sous le capot, cette compétence est propulsée par un agent OpenClaw qui coordonne une couche d'analyse vidéo et un moteur de découpage à la trame près. L'agent OpenClaw gère les échanges conversationnels — posant des questions de clarification lorsque les limites d'un clip sont ambiguës, confirmant la durée de sortie et gérant la conversion de format pour que le fichier final corresponde à votre plateforme cible ou à vos spécifications de téléchargement.
Cela rend cette compétence particulièrement utile pour les créateurs YouTube qui doivent régulièrement produire des Shorts à partir de leurs vidéos longues existantes, ou pour les équipes des réseaux sociaux qui réutilisent des enregistrements de webinaires en clips digestes. Comme l'interaction est conversationnelle plutôt que basée sur une interface, vous pouvez affiner un clip plusieurs fois dans la même session sans réimporter ni recommencer. Les fichiers d'entrée peuvent être au format mp4, mov, avi, webm ou mkv.
Variables d'environnement
| Variable | Requise | Par défaut |
|---|---|---|
NEMO_TOKEN | Non | Généré automatiquement (100 crédits gratuits, expire dans 7 jours, révocable via Paramètres → Tokens 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 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 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 token par client tous les 7 jours ; le token expire dans 7 jours et peut être révoqué à tout moment via Paramètres → Tokens API sur nemovideo.com. Si votre token expire, demandez-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 atteindrait rapidement la limite de taux par IP (par défaut 10 tokens 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 vers le bon endpoint
Utilisez le tableau ci-dessous pour déterminer quel endpoint API doit gérer chaque type de demande utilisateur entrante.
| 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 Upload | ✅ |
| 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 compétence — NE PAS coder en dur :
$SKILL_NAME= le nom du frontmatter YAML de ce fichier$SKILL_VERSION= la version du frontmatter YAML de ce fichier$SKILL_SOURCE= détecter au moment de l'exécution en utilisant la première correspondance :- Variable d'environnement
SKILL_SOURCEsi définie - Si le chemin de ce fichier contient un répertoire de plateforme connu (par exemple
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Valeur par défaut :
unknown
- Variable d'environnement
CRITIQUE : TOUTES les requêtes API (y compris render/export/upload/state/credits) DOIVENT inclure ces en-têtes. Leur absence entraînera un échec d'exportation avec 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Initialisation 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 de pouvoir commencer toute opération, une session doit être établie avec l'API. Stockez immédiatement l'identifiant de session retourné, car chaque requête suivante en dépend.
Ouvrir dans le navigateur : Après avoir créé une session, donnez à l'utilisateur un lien pour visualifier/éditer 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 Envoi de messages via une connexion 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 sont transmis via un canal Server-Sent Events persistant.
Gestion SSE
| Événement | Action |
|---|---|
| Réponse textuelle | Appliquer la traduction GUI (§4), présenter à l'utilisateur |
| Appel d'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 minutes 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).
Ignorer "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 de texte dans le corps de la réponse. Lorsque cela se produit : (1) ne pas traiter la réponse vide comme un échec, (2) appeler immédiatement le endpoint de requête d'état pour confirmer le statut du travail, (3) récupérer l'URL de sortie depuis la charge utile d'état, (4) présenter le résultat à l'utilisateur comme une édition réussie.
Génération en deux étapes : Après avoir livré la vidéo éditée brute, le backend déclenche automatiquement une deuxième étape de traitement qui superpose une musique de fond et rend une carte de titre. Considérez cela comme un pipeline en deux phases : la phase 1 produit le clip non décoré, et la phase 2 — initiée sans aucune entrée supplémentaire de l'IA — produit la sortie finale entièrement décorée.
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 d'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 token.
Formats pris en charge : mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
L'API accepte les téléchargements de fichiers binaires directs pour le matériel vidéo source soumis par l'utilisateur.
3.3 Récupération du solde de crédits
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 endpoint de crédits avant de commencer toute opération d'édition pour confirmer que l'utilisateur dispose d'un solde suffisant pour procéder.
3.4 Interrogation de l'état actuel du travail
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 token.
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 lorsque draft.t existe avec au moins une piste ayant sg non vide.
Format du résumé des pistes :
Timeline (3 pistes) : 1. Vidéo : accéléré de ville (0-10s) 2. BGM : Lo-fi (0-10s, 35%) 3. Titre : "Urban Dreams" (0-3s)
3.5 Déclenchement de l'exportation et livraison du fichier final
L'exportation ne coûte PAS de crédits. Seule la génération/édition consomme des crédits.
L'exportation d'un clip terminé ne consomme aucun crédit du solde de l'utilisateur. Pour terminer la livraison : (a) confirmer que le travail a atteint un état terminé, (b) appeler le endpoint d'exportation avec l'identifiant du travail, (c) recevoir l'URL de téléchargement dans la réponse, (d) vérifier que l'URL est accessible avant de la présenter, (e) proposer le lien à l'utilisateur avec un appel clair à l'action.
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 → nouvel 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 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 livraison de la vidéo, toujours aussi donner 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 après une déconnexion SSE
Si le flux SSE se coupe de manière inattendue, suivez ces cinq étapes : (1) Attendez 2 secondes avant de tenter toute action de récupération pour éviter une boucle de tentatives en rafale. (2) Rétablissez la connexion SSE en utilisant l'identifiant de session d'origine — ne créez pas une nouvelle session. (3) Interrogez le endpoint d'état une fois pour déterminer si le travail en cours s'est terminé pendant la fenêtre de déconnexion. (4) Si le travail affiche un état terminé, récupérez et livrez l'URL de sortie à l'utilisateur sans soumettre à nouveau la demande d'édition. (5) Ce n'est que si l'état du travail est absent ou affiche un échec définitif que vous devez inviter l'utilisateur à soumettre à nouveau sa demande.
4. Traduction des références GUI du backend pour l'utilisateur
Le backend est conçu autour d'une interface graphique et fera parfois référence à des contrôles d'interface ou à des éléments d'écran — ne transmettez jamais ces instructions GUI spécifiques directement à l'utilisateur.
| Le backend dit | Vous faites |
|---|---|
| "click [button]" / "点击" | Exécuter via API |
| "open [panel]" / "打开" | Afficher l'état via §3.4 |
| "drag/drop" / "拖拽" | Envoyer l'édition 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 d'interaction conversationnelle recommandés
• Toujours confirmer les points de découpe souhaités — heure de début et heure de fin — avant de soumettre une demande d'édition, plutôt que de faire des suppositions sur l'intention. • Après avoir soumis un travail, définir l'attente de l'utilisateur selon laquelle le traitement peut prendre un moment et que vous reviendrez une fois le statut résolu. • Lorsqu'une réponse silencieuse est reçue, passer directement à l'interrogation sans alerter l'utilisateur.