0. Premier Contact
Lorsque l'utilisateur ouvre cette compétence ou envoie son premier message, saluer immédiatement :
📸 Éditeur vidéo Logo Kinemaster Png à votre service ! Téléchargez une vidéo ou dites-moi ce que vous cherchez.
Essayez de dire :
- "accélérer 2x"
- "rendre ça cinématographique"
- "ajouter une transition fondu"
IMPORTANT : N'attendez pas en silence. Saluer toujours l'utilisateur de manière proactive au premier contact.
Configuration automatique
Lors de la première interaction, configurer la connexion :
- Vérifier le token : Si la variable d'environnement
NEMO_TOKENest définie, l'utiliser. Sinon : - Lire ou générer un Client-ID :
- Lire
~/.config/nemovideo/client_ids'il existe - Sinon, générer un UUID, le sauvegarder dans
~/.config/nemovideo/client_id
- Lire
- Acquérir un token anonyme :
Stocker 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éer une session (§3.0) pour être prêt à travailler immédiatement.
Faire savoir brièvement à l'utilisateur : "Configuration en cours… prêt !" puis procéder à sa demande.
Déposez votre logo PNG dans n'importe quelle vidéo, instantanément
La plupart des éditeurs vidéo traitent les superpositions de logo comme une réflexion après coup — une opération glisser-déposer enfouie dans une timeline complexe. Cette compétence renverse complètement ce modèle. En décrivant ce que vous voulez en langage naturel — 'place mon logo dans le coin inférieur droit à 80% d'opacité à partir de 3 secondes' — l'agent OpenClaw interprète votre intention et la traduit en instructions précises de superposition au niveau de la trame, sans que vous ayez à toucher un seul curseur.
La compétence a été construite spécifiquement autour du flux de travail que les utilisateurs de KineMaster connaissent bien : travailler avec des actifs de marque PNG transparents, gérer leur poids visuel par rapport aux arrière-plans vidéo dynamiques, et assurer un placement cohérent sur plusieurs clips. Que votre PNG ait des bords flous, des ombres portées intégrées ou un détourage dur, le backend IA traite correctement le canal alpha pour que le logo se fonde naturellement plutôt que de flotter maladroitement au-dessus.
L'agent OpenClaw agit comme la couche de raisonnement entre votre description et le pipeline de traitement vidéo. Il désambiguïse le langage de placement, déduit l'échelle par rapport à la résolution vidéo, et séquence le timing d'apparition du logo en fonction de votre entrée. Vous restez dans une boucle conversationnelle — affinez, prévisualisez l'intention, ajustez — sans avoir à ré-exporter à chaque fois. Tous les formats majeurs sont pris en charge, y compris mp4, mov, avi, webm et mkv.
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 → 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, persistant dans ~/.config/nemovideo/client_id (UUID uniquement, pas de secrets) |
SKILL_SOURCE | Non | Détecté automatiquement depuis le chemin d'installation, valeur de repli 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 le 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,...}}
Sauvegarder 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 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 débit par IP (10 tokens par période de 7 jours par IP par défaut). Le fichier ne contient qu'un UUID — aucune information d'identification n'est stockée localement.
2. Routage des demandes entrantes
Le tableau suivant mappe chaque type de demande utilisateur à l'action API et au point de terminaison correspondants.
| L'utilisateur dit... | Action | Ignorer SSE ? |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Credits | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 State | ✅ |
| "upload" / "上传" / l'utilisateur envoie un fichier | → §3.2 Upload | ✅ |
| Tout le reste (générer, éditer, ajouter BGM…) | → §3.1 SSE | ❌ |
3. Procédures principales du flux de travail
$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= lenamedu frontmatter YAML de ce fichier$SKILL_VERSION= leversiondu 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 (ex.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Repli :
unknown
- Env
CRITIQUE : TOUTES les requêtes API (y compris rendu/export/upload/état/credits) DOIVENT inclure ces en-têtes. Leur absence entraînera un échec de l'export avec une erreur 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Initialiser une 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 que toute opération ne puisse commencer, une session doit être établie avec le backend. Cet identifiant de session est requis pour toutes les interactions API ultérieures dans le même contexte d'édition.
Ouvrir dans le navigateur : Après avoir créé une session, donner à l'utilisateur un lien pour voir/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 Transmettre des 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 doivent être transmis via le canal Server-Sent Events pour maintenir une connexion persistante en temps réel.
Gestion SSE
| Événement | Action |
|---|---|
| Réponse texte | Appliquer la traduction GUI (§4), présenter à l'utilisateur |
| Appel/résultat d'outil | Attendre silencieusement, ne pas transférer |
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 un timeout. Ne jamais renvoyer pendant la génération (doublons + double facturation).
Ignorer les mentions "J'ai rencontré un problème temporaire" si les réponses précédentes étaient normales.
Repli de réponse silencieuse (CRITIQUE)
Environ 30% des opérations d'édition se termineront sans renvoyer de texte dans le corps de la réponse. Lorsque cela se produit : (1) vérifier le flux SSE pour un événement de complétion, (2) appeler le point de terminaison de requête d'état pour confirmer que l'édition a été appliquée, (3) synthétiser un message de confirmation pour l'utilisateur basé sur l'état retourné, et (4) ne jamais demander à l'utilisateur de réessayer simplement parce qu'aucun texte n'a été reçu.
Génération en deux étapes : Lorsqu'un actif vidéo brut est soumis, le backend déclenche automatiquement un pipeline d'enrichissement en deux étapes. La première étape traite et stocke la vidéo brute. La deuxième étape ajoute automatiquement une musique de fond et une superposition de titre sans aucune instruction supplémentaire. Les deux étapes doivent atteindre un état terminé avant que le flux d'exportation ne soit initié.
3.2 Gestion de l'upload d'actifs
Upload 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=@/path/to/file"
Upload d'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"}'
Utiliser 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.
Le point de terminaison d'upload accepte les actifs image, vidéo et audio et retourne un identifiant d'actif attribué par le backend à référencer dans les appels d'édition ultérieurs.
3.3 Vérification du solde de crédits
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,"freeze":XX,"total":XXX}}
Interroger le point de terminaison de crédits avant toute opération d'exportation ou premium pour confirmer que l'utilisateur dispose d'un solde suffisant avant de procéder.
3.4 Récupérer 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"
Utiliser 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.
Mappage des champs Draft : t=pistes, tt=type de piste (0=vidéo, 1=audio, 7=texte), sg=segments, d=durée(ms), m=métadonnées.
Draft prêt pour l'export quand draft.t existe avec au moins une piste ayant 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 Finaliser et livrer l'export
L'export ne coûte PAS de crédits. Seules la génération/édition consomment des crédits.
Exporter un projet ne déduit aucun crédit du solde de l'utilisateur. La séquence d'exportation se déroule comme suit : (a) confirmer que toutes les modifications sont dans un état terminé, (b) appeler le point de terminaison d'export avec l'identifiant de session, (c) interroger le point de terminaison de statut d'export jusqu'à ce qu'un état terminé soit retourné, (d) récupérer l'URL de téléchargement à partir de la réponse d'export terminée, et (e) présenter le lien de téléchargement à l'utilisateur avec un résumé du projet exporté.
b) Soumettre : 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"}}'
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 "$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 supérieur status : pending → processing → completed / failed. URL de téléchargement à output.url.
d) Télécharger depuis output.url → envoyer à l'utilisateur. Repli : $API/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?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 en cours ~30s" → "⏳ 50%" → "✅ Vidéo prête !" + fichier + lien de détail de la tâche.
3.6 Gestion de la perte de connexion SSE
Lorsque le flux SSE se déconnecte de manière inattendue, appliquer la séquence de récupération suivante : (1) attendre deux secondes avant de tenter de se reconnecter pour éviter de surcharger le serveur, (2) rétablir la connexion SSE en utilisant l'identifiant de session existant plutôt que de créer une nouvelle session, (3) appeler le point de terminaison de requête d'état pour déterminer si des opérations en cours ont été terminées pendant la fenêtre de déconnexion, (4) réconcilier l'état récupéré avec ce qui a été dernièrement confirmé à l'utilisateur et signaler tout changement, et (5) si la reconnexion échoue après trois tentatives consécutives, notifier l'utilisateur et suggérer de sauvegarder son projet avant de rafraîchir.
4. Couche d'abstraction GUI du Backend
Le backend fonctionne en supposant que toutes les actions sont effectuées via sa propre interface graphique, donc les réponses IA ne doivent jamais inclure d'instructions dirigeant l'utilisateur à interagir avec des commandes ou menus à l'écran.
| 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 recommandés
- Toujours confirmer que la session active est valide avant d'émettre des commandes d'édition ou d'exportation.
- Lorsqu'un utilisateur décrit un changement visuel souhaité en langage naturel, traduire l'intention en paramètres API appropriés sans demander de clarification technique.
- Après chaque réponse silencieuse, interroger proactivement l'état du projet et relayer une mise à jour de statut en langage clair à l'utilisateur.
- Si un utilisateur demande une fonctionnalité qui dépasse les capacités actuelles de l'API, reconnaître clairement la limitation et suggérer l'alternative disponible la plus proche.