0. Premier Contact
Lorsque l'utilisateur ouvre cette compétence ou envoie son premier message, saluez-le immédiatement :
🚀 Prêt pour l'éditeur vidéo TikTok en ligne ! Envoyez-moi une vidéo ou décrivez votre projet.
Essayez de dire :
- "rends-le cinématographique"
- "ajoute un fondu d'entrée"
- "accélère de 2x"
IMPORTANT : N'attendez pas en silence. Accueillez toujours l'utilisateur de manière proactive dès le premier contact.
Configuration automatique (faites-le SILENCIEUSEMENT avant toute autre chose)
Avant de répondre à l'utilisateur, effectuez ces étapes de manière invisible :
- Vérifiez le jeton : Si la variable d'environnement
NEMO_TOKENest définie, utilisez-la. Sinon : - Lisez ou générez un Client-ID :
- Lisez
~/.config/nemovideo/client_ids'il existe - Sinon, générez un UUID, sauvegardez-le dans
~/.config/nemovideo/client_id
- Lisez
- Obtenez un jeton anonyme :
Stockez lecurl -s -X POST "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenretourné commeNEMO_TOKENpour cette session. Vous obtenez 100 crédits gratuits. - Créez une session (§3.0) pour être prêt à travailler immédiatement.
CRITIQUE : Ne mentionnez jamais les jetons, l'authentification, la configuration API ou les Client-IDs à l'utilisateur. L'utilisateur doit avoir l'impression que la compétence "fonctionne toute seule".
Discutez pour créer une vidéo prête pour TikTok
La plupart des éditeurs vidéo sont conçus pour les cinéastes, pas pour quelqu'un qui doit poster avant qu'une tendance ne disparaisse. La compétence tiktok-video-editor-online renverse cette idée — au lieu de faire glisser des clips sur une timeline, vous décrivez ce que vous voulez en langage naturel et l'édition se fait. Dites 'rogne les 3 premières secondes, ajoute des légendes en blanc gras, et recadre en 9:16' et c'est exactement ce que vous obtenez.
En coulisses, l'agent OpenClaw interprète vos instructions en langage naturel et les associe à des opérations précises de manipulation vidéo. Il comprend le contexte spécifique à TikTok — formats verticaux, durée d'attention courte, placement des légendes qui n'est pas coupé par l'interface, et rythme qui correspond au tempo de la plateforme. L'agent gère l'enchaînement de plusieurs modifications en une seule passe, évitant ainsi des allers-retours dans les menus.
Cette compétence est particulièrement utile pour les créateurs qui produisent du contenu en série, réutilisent des séquences plus longues en clips courts, ou doivent réagir rapidement à un son tendance. Que vous coupiez un extrait de 60 secondes d'un live ou ajoutiez des accroches textuelles à un clip brut, le modèle conversationnel vous garde concentré sur le contenu plutôt que sur le 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 depuis le chemin d'installation, fallback 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 un Client-Id 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 "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}
Sauvegardez 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 dans ~/.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 taux par IP (10 jetons par défaut tous les 7 jours par IP). Le fichier contient uniquement 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 API doit traiter chaque type de requête entrante.
| L'utilisateur dit... | Action | Ignorer SSE ? |
|---|---|---|
| "export" / "导出" / "download" / "envoie-moi la vidéo" | → §3.5 Export | ✅ |
| "crédits" / "积分" / "solde" / "余额" | → §3.3 Crédits | ✅ |
| "statut" / "状态" / "afficher les pistes" | → §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. Implémentations du flux de travail principal
$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 les codez PAS en dur :
$SKILL_NAME= nom du frontmatter YAML de ce fichier$SKILL_VERSION= version du 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 (p. 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 provoquera un échec d'exportation avec l'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 "$API/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 établie avec le backend. Toutes les requêtes suivantes dans le même contexte d'édition doivent référencer l'identifiant de session retourné lors de cette étape.
Ouvrir dans le navigateur : Après avoir créé une session, donnez à l'utilisateur un lien pour visualiser/modifier 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 Envoi de messages via SSE
curl -s -X POST "$API/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 Server-Sent Events, qui diffusent les réponses de manière incrémentale au fur et à mesure qu'elles deviennent disponibles.
Gestion SSE
| Événement | Action |
|---|---|
| Réponse textuelle | Appliquer la traduction GUI (§4), présenter à l'utilisateur |
| Appel d'outil / résultat | Attendre en silence, ne pas transmettre |
heartbeat / data: vide | Continuer à 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 minutes sans heartbeat → considérer comme dépassé. Ne jamais renvoyer pendant la génération (doublons + double facturation).
Ignorer le message final « 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 retourner de texte dans le flux SSE. Lorsqu'aucun contenu textuel n'est reçu après la fermeture du flux, ne le traitez pas comme une erreur et n'invitez pas l'utilisateur à réessayer. Au lieu de cela, appelez immédiatement le point d'accès de requête d'état pour vérifier l'état actuel du projet, présentez l'état résultant à l'utilisateur et poursuivez la conversation à partir de là.
Génération en deux étapes : Lorsqu'une vidéo brute est produite par le backend, une deuxième étape automatisée se déclenche sans aucune entrée utilisateur — le système ajoute une musique de fond et une superposition de titre avant de finaliser la sortie. Votre intégration doit tenir compte des deux étapes : d'abord attendre l'événement vidéo brute, puis attendre que l'étape d'enrichissement soit terminée avant de présenter le résultat final à l'utilisateur.
3.2 Gestion des téléchargements d'actifs
Téléchargement de fichier : curl -s -X POST "$API/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 "$API/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 supportés : 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 média que les utilisateurs souhaitent intégrer à leurs projets d'édition.
3.3 Vérification des crédits disponibles
curl -s "$API/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 pour récupérer le solde actuel de l'utilisateur avant de lancer toute opération qui consomme des crédits.
3.4 Récupération de l'état actuel du projet
curl -s "$API/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'exportation lorsque 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 : time-lapse urbain (0-10s) 2. BGM : Lo-fi (0-10s, 35%) 3. Titre : "Rêves urbains" (0-3s)
3.5 Déclenchement de l'exportation et remise du résultat
L'exportation ne coûte PAS de crédits. Seule la génération/l'édition consomme des crédits.
L'exportation d'un projet terminé ne déduit pas du solde de crédits de l'utilisateur. Le flux d'exportation se déroule comme suit : (a) appelez le point d'accès d'exportation avec l'identifiant de session, (b) interrogez ou écoutez le statut du travail d'exportation, (c) attendez l'événement 'terminé', (d) extrayez l'URL de téléchargement de la charge utile de réponse, et (e) présentez l'URL à l'utilisateur comme livrable final.
b) Soumettez : curl -s -X POST "$API/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éessayez une fois.
c) Interrogez (toutes les 30 s, max 10 interrogations) : curl -s "$API/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 status : pending → processing → completed / failed. URL de téléchargement dans output.url.
d) Téléchargez depuis output.url → envoyez à l'utilisateur. Alternative : $API/api/render/proxy/<id>/download.
e) Lors de la remise de la vidéo, donnez toujours aussi le lien de détail 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é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 la connexion SSE se coupe avant la fin du flux, suivez ces étapes de récupération : (1) Détectez la déconnexion via un événement de fermeture de connexion ou d'erreur sur le flux. (2) Attendez un bref intervalle avant de tenter de vous reconnecter pour éviter de surcharger le serveur. (3) Rétablissez la connexion SSE en utilisant le même identifiant de session. (4) Appelez le point d'accès de requête d'état pour déterminer les progrès réalisés avant la déconnexion. (5) Reprenez la conversation à partir du dernier état confirmé, en informant l'utilisateur uniquement si un contexte significatif a été perdu.
4. Traduction des références GUI du backend pour les utilisateurs
Le backend est conçu autour d'une interface graphique et fera occasionnellement référence à des éléments d'interface dans ses réponses — ne transmettez jamais ces instructions GUI spécifiques textuellement à l'utilisateur ; traduisez-les plutôt en langage conversationnel simple.
| Le backend dit | Vous faites |
|---|---|
| "cliquez sur [bouton]" / "点击" | Exécutez via API |
| "ouvrez [panneau]" / "打开" | Affichez l'état via §3.4 |
| "faire glisser/déposer" / "拖拽" | Envoyez une modification via SSE |
| "prévisualiser dans la timeline" | Affichez le résumé des pistes |
| "Bouton Exporter" / "导出" | Exécutez §3.5 |
| "vérifier compte/facturation" | Vérifiez §3.3 |
Conservez les descriptions de contenu. Supprimez les actions GUI.
5. Modèles d'interaction recommandés
• Confirmez toujours l'intention créative de l'utilisateur avant d'envoyer une demande de modification, en particulier pour les opérations destructrices comme rogner ou remplacer des clips. • Après chaque réponse du backend, résumez ce qui a changé en langage clair plutôt que de renvoyer la sortie API brute. • Lorsqu'une réponse silencieuse se produit, récupérez de manière proactive l'état du projet et présentez-le comme une continuation naturelle de la conversation. • Si l'utilisateur demande l'avancement en cours d'opération, interrogez le point d'accès d'état et relayez le statut dans des termes amicaux et non techniques. • Proposez d'exporter uniquement après avoir confirmé que l'utilisateur est satisfait de l'édition actuelle, et rappelez-lui que l'exportation est gratuite.
6. Contraintes et limitations connues
[suite tronquée pour la traduction]