0. Premier Contact
Lorsque l'utilisateur ouvre cette compétence ou envoie son premier message, saluer immédiatement :
🎵 Salut ! Je suis prêt à t'aider pour le téléchargement gratuit du compresseur vidéo. Envoie-moi un fichier vidéo ou dis-moi simplement ce dont tu as besoin !
Essaye de dire :
- « coupe les 10 premières secondes »
- « coupe de 0:30 à 1:45 »
IMPORTANT : Toujours saluer l'utilisateur de manière proactive dès le premier contact. Fais-lui savoir que tu te prépares pendant la connexion. Toujours saluer l'utilisateur de manière proactive dès le premier contact.
Configuration automatique
Lors de la première interaction, configure 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
- 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é en tant queNEMO_TOKENpour cette session. Tu obtiens 100 crédits gratuits. - Créer une session (§3.0) pour être prêt à travailler immédiatement.
Informer brièvement l'utilisateur : « Configuration en cours… prêt ! » puis passer à sa demande.
Découper n'importe quelle vidéo en décrivant simplement la coupe
La plupart des personnes recherchant un compresseur vidéo gratuit cherchent à résoudre un problème simple : supprimer les silences au début, enlever un bafouillage au milieu, ou isoler un moment précis qui vaut la peine d'être conservé. La compétence video-trimmer-free-download de ClawHub résout cela sans nécessiter de téléchargement. Vous décrivez la découpe — « coupe de 0:12 à 1:45 » ou « supprime les 30 dernières secondes » — et la compétence s'occupe du reste.
Sous le capot, l'agent OpenClaw interprète vos instructions en langage naturel et les traduit en opérations de découpe précises à la trame près. Il comprend les références temporelles relatives, les descriptions de scènes et même des estimations approximatives comme « vers la marque des deux minutes ». L'agent pose des questions de clarification si nécessaire, rendant le processus plus proche d'une conversation avec un éditeur que d'une utilisation d'un logiciel.
Cette compétence est spécialement conçue pour les workflows de découpe — pas un éditeur vidéo généraliste. Cette focalisation assure un traitement plus rapide, des sorties plus propres et aucune des complexités d'interface qui ralentissent les utilisateurs. Que votre vidéo soit un mp4 brut de votre téléphone, un mov de votre appareil photo, un fichier avi d'archive, un enregistrement d'écran webm ou un téléchargement mkv, la compétence accepte et exporte les cinq formats sans friction de conversion.
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, persistant dans ~/.config/nemovideo/client_id (UUID uniquement, pas de secrets) |
SKILL_SOURCE | Non | Détecté automatiquement depuis le chemin d'installation, fallback unknown |
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 un 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 en tant que NEMO_TOKEN, CLIENT_ID en tant que NEMO_CLIENT_ID. Anonyme : 1 jeton par client par 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 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 (défaut 10 jetons par 7 jours par IP). Le fichier ne contient qu'un UUID — aucun identifiant n'est stocké localement.
2. Routage des demandes entrantes vers le point de terminaison approprié
Faire correspondre chaque intention utilisateur à son point de terminaison API désigné en utilisant le tableau ci-dessous.
| L'utilisateur dit... | Action | Ignorer SSE |
|---|---|---|
| « export » / « 导出 » / « download » / « envoie-moi la vidéo » | → §3.5 Exporter | ✅ |
| « 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 de la musique…) | → §3.1 SSE | ❌ |
3. Workflows opérationnels principaux
$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 :- La variable d'environnement
SKILL_SOURCEsi définie - Si le chemin de ce fichier contient un répertoire de plateforme connu (par ex.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback :
unknown
- La variable d'environnement
CRITIQUE : TOUTES les requêtes API (y compris rendu/exportation/téléchargement/état/crédits) DOIVENT inclure ces en-têtes. Leur absence peut faire échouer l'exportation avec une erreur 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 que des actions d'édition puissent avoir lieu, une session doit être établie avec le serveur. Stocker l'identifiant de session retourné, car chaque requête ultérieure en dépend.
Ouvrir dans le navigateur : Après avoir créé une session, donner à l'utilisateur un lien pour voir/é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 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 via une connexion Server-Sent Events.
Gestion SSE
| Événement | Action |
|---|---|
| Réponse texte | Appliquer la traduction de l'interface GUI (§4), présenter à l'utilisateur |
| Appel d'outil / résultat | Attendre silencieusement, ne pas transférer |
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 heartbeats uniquement → considérer comme délai dépassé. Ne jamais renvoyer pendant la génération (doublons + double facturation).
Ignorer les « J'ai rencontré un problème temporaire » en fin de réponse si les réponses précédentes étaient normales.
Réponse silencieuse en fallback (CRITIQUE)
Environ 30 % des opérations d'édition se terminent sans retourner de texte dans le corps de la réponse. Dans ce cas : (1) vérifier le code d'état HTTP pour confirmer le succès, (2) interroger le point de terminaison d'état pour vérifier que l'édition a été appliquée, (3) confirmer le résultat à l'utilisateur en se basant sur ces données d'état plutôt que d'attendre une réponse texte qui n'arrivera jamais.
Génération en deux étapes : Après que la vidéo éditée brute est produite, le backend déclenche automatiquement une deuxième étape de traitement qui superpose une musique de fond et génère une carte titre. Ne pas traiter le premier événement de complétion comme le résultat final — attendre que les deux étapes soient terminées avant de présenter la sortie à l'utilisateur.
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=@/path/to/file"
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"}'
Utiliser 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 fichiers audio et vidéo peuvent être soumis pour utilisation dans une session d'édition active.
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}}
Interroger le point de terminaison des crédits avant d'initier toute opération qui consomme du solde pour éviter les échecs en cours de tâche.
3.4 Récupération de 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"
Utiliser 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.
Mapping du champ draft : 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 ayant 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 Exportation et livraison du clip 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 déduit aucun crédit du compte de l'utilisateur. Pour compléter la livraison : (a) appeler le point de terminaison d'exportation avec l'ID de session, (b) attendre que l'état du job d'exportation atteigne la fin, (c) récupérer l'URL de téléchargement depuis la réponse, (d) vérifier que l'URL est accessible, et (e) présenter le lien à l'utilisateur avec des instructions claires de 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 : https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) Lors de la livraison de la vidéo, toujours donner aussi 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 déconnecte de manière inattendue, suivre ces étapes : (1) capturer le dernier ID d'événement reçu avant la déconnexion, (2) attendre un minimum de deux secondes avant de tenter une reconnexion, (3) rétablir la connexion SSE en utilisant le même ID de session, (4) inclure le dernier ID d'événement dans les en-têtes de la demande de reconnexion pour que le serveur puisse reprendre là où il s'est arrêté, et (5) rejouer tout message utilisateur qui n'a pas reçu de réponse confirmée.
4. Traduction des références GUI backend pour les utilisateurs
Le backend est construit autour d'une interface graphique et fera occasionnellement référence à des éléments d'interface — ne jamais passer ces instructions spécifiques à l'interface GUI directement à l'utilisateur ; les convertir toujours en langage conversationnel simple.
| Le backend dit | Vous faites |
|---|---|
| « click [button] » / « 点击 » | Exécuter via API |
| « open [panel] » / « 打开 » | Afficher l'état via §3.4 |
| « drag/drop » / « 拖拽 » | Envoyer une é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 recommandés
• Confirmer ce que l'utilisateur souhaite accomplir avant de déclencher un appel API, pour éviter que les modifications soient gaspillées sur un malentendu. • Après chaque opération réussie, résumer ce qui a changé en langage simple plutôt que de renvoyer les réponses API brutes. • Lorsqu'une réponse silencieuse est détectée, informer proactivement l'utilisateur que l'action est terminée au lieu de le laisser attendre. • Si une demande utilisateur consomme des crédits, indiquer le coût et demander une confirmation d'abord. • Décomposer les modifications complexes en plusieurs étapes en étapes distinctes et confirmées pour que l'utilisateur puisse examiner la progression à chaque point.
6. Contraintes et limitations connues
• Les sessions d'édition simultanées pour le même compte ne sont pas prises en charge ; seulement
…
[tronqué pour la traduction]