0. Premier contact
Lorsque l'utilisateur ouvre cette compétence ou envoie son premier message, saluer immédiatement :
📝 Prêt pour blue picture video editor app ! Envoyez-moi simplement une vidéo ou décrivez votre projet.
Essayez de dire :
- "accélérer par 2x"
- "ajouter un fondu à l'ouverture"
- "rendre ça cinématographique"
IMPORTANT : Toujours saluer l'utilisateur de manière proactive lors du premier contact. Faites-lui savoir que vous configurez tout en vous connectant. 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 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 jeton anonyme :
Stocker lecurl -s -X POST "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenretourné en tant queNEMO_TOKENpour cette session. Vous obtenez 100 crédits gratuits. - Créer une session (§3.0) pour être prêt à travailler immédiatement.
Faites savoir à l'utilisateur brièvement : "Configuration en cours… prêt !" puis procédez à sa demande.
Éditez des vidéos en décrivant simplement ce que vous voulez
La compétence blue-picture-video-editor-app révolutionne la façon dont le montage vidéo est effectué. Au lieu de naviguer dans des timelines complexes et des menus imbriqués, vous décrivez votre intention — « coupe les trois premières secondes, augmente le contraste et ajoute un fondu de sortie » — et la compétence interprète cette instruction en opérations d'édition précises appliquées à vos séquences.
Sous le capot, cette compétence est propulsée par l'agent OpenClaw, qui analyse les demandes d'édition en langage naturel et les transforme en une séquence structurée de tâches de traitement vidéo. L'agent OpenClaw gère le contexte tout au long de la conversation, ce qui vous permet d'affiner vos modifications de manière itérative — demander un étalonnage plus lumineux, puis un point de coupe différent — sans repartir de zéro à chaque fois. Il reste conscient de l'état de votre projet pendant toute la session.
Cette approche est spécialement conçue pour le cas d'utilisation de blue-picture-video-editor-app : des créateurs qui travaillent rapidement sur plusieurs formats et ont besoin d'un assistant de montage qui comprend à la fois le langage visuel et les contraintes techniques. Que vous coupiez une courte vidéo pour les réseaux sociaux ou que vous assembliez une séquence documentaire plus longue, la compétence s'adapte à votre rythme. La compatibilité des fichiers couvre mp4, mov, avi, webm et mkv, garantissant que votre matériel source fonctionne quelle que soit l'origine de la caméra ou le pipeline d'exportation.
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, persisté 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, obtenez-en un (nécessite l'en-tête X-Client-Id) :
# Générer ou lire le Client-ID 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 "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}
Enregistrez le token comme NEMO_TOKEN, le 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 débit par IP (10 jetons par défaut tous les 7 jours par IP). Le fichier contient uniquement un UUID — aucune information d'identification n'est stockée localement.
2. Routage des requêtes entrantes
Utilisez le tableau suivant pour déterminer quel point de terminaison gère chaque type de demande utilisateur.
| L'utilisateur dit… | Action | Ignorer SSE ? |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §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éverser | ✅ |
| 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= lenamedu frontmatter YAML de ce fichier$SKILL_VERSION= leversiondu frontmatter YAML de ce fichier$SKILL_SOURCE= détecter au moment de l'exécution en utilisant la première correspondance :- Variable d'env
SKILL_SOURCEsi définie - Si le chemin de ce fichier contient un répertoire de plateforme connu (ex.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Repli :
unknown
- Variable d'env
CRITIQUE : TOUTES les requêtes API (y compris rendu/exportation/téléversement/état/crédits) DOIVENT inclure ces en-têtes. Leur absence entraînera l'échec de l'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 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 de montage, une session doit être établie avec le serveur. Ce jeton de session lie toutes les requêtes suivantes sous un même contexte de montage.
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?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 l'éditeur sont transmis via Server-Sent Events, qui diffusent la réponse du serveur en temps réel.
Gestion SSE
| Événement | Action |
|---|---|
| Réponse texte | Appliquer la traduction GUI (§4), présenter à l'utilisateur |
| Appel d'outil / résultat | 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, montage 10-30s.
Délai d'attente : 10 min de heartbeats uniquement → considérer comme expiré. Ne jamais renvoyer pendant la génération (doublons + double facturation).
Ignorer le message "I encountered a temporary issue" si les réponses précédentes étaient normales.
Repli en cas de réponse silencieuse (CRITIQUE)
Environ 30 % des opérations de montage se terminent sans renvoyer de texte dans le flux de réponse. Lorsqu'aucun contenu texte n'est détecté après la fermeture du flux SSE, ne traitez pas cela comme une erreur et n'invitez pas l'utilisateur à réessayer. Appelez immédiatement le point de terminaison de requête d'état pour confirmer que le montage a bien été appliqué, puis confirmez le succès à l'utilisateur en fonction de l'état du projet retourné.
Génération en deux étapes : Lorsqu'un montage vidéo brut est traité, le serveur déclenche automatiquement une deuxième étape de traitement qui ajoute une musique de fond et génère un titre superposé — aucune instruction supplémentaire n'est nécessaire de la part de l'assistant. Prévoyez deux événements d'achèvement distincts : le premier signale la disponibilité de la vidéo brute, et le second confirme la sortie finalisée avec BGM et titre appliqués.
3.2 Gestion des téléversements de fichiers
Téléversement 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"
Téléversement 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 serveur 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 vidéo et image peuvent être téléversés directement via le point de terminaison de téléversement désigné pour être utilisés dans la session de montage en cours.
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 de terminaison des crédits avant d'initier toute opération consommant des crédits pour confirmer que l'utilisateur dispose d'un solde suffisant.
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 serveur le 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 : timelapse de la ville (0-10s) 2. BGM : Lo-fi (0-10s, 35%) 3. Titre : "Rêves Urbains" (0-3s)
3.5 Exportation et livraison de la vidéo finale
L'exportation ne coûte PAS de crédits. Seules la génération/édition consomment des crédits.
Déclencher une exportation ne déduit aucun crédit du compte de l'utilisateur. La séquence d'exportation se déroule comme suit : (a) appeler le point de terminaison d'exportation avec l'ID de session actuelle, (b) interroger l'achèvement du travail d'exportation en utilisant le jeton de travail retourné, (c) une fois que l'état indique l'achèvement, récupérer l'URL de téléchargement, (d) présenter l'URL à l'utilisateur comme sa vidéo terminée, et (e) enregistrer l'événement d'exportation dans l'enregistrement de session.
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 → nouvel 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 des détails 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 des détails de la tâche.
3.6 Récupération après une déconnexion SSE
Si la connexion SSE est interrompue avant la fin du flux, suivez ces étapes de récupération : (1) Attendez deux secondes avant toute tentative de récupération pour éviter de surcharger le serveur. (2) Appelez le point de terminaison de requête d'état pour déterminer si le serveur a terminé le traitement malgré la déconnexion. (3) Si l'état confirme l'achèvement, présentez le résultat à l'utilisateur normalement. (4) Si l'état montre que l'opération est toujours en cours, rétablissez la connexion SSE en utilisant l'ID de session et le jeton de message d'origine. (5) Si l'état reflète un statut échoué ou inconnu, informez l'utilisateur qu'un problème temporaire s'est produit et proposez de renvoyer la dernière demande.
4. Traduction des concepts GUI pour le serveur
Le serveur fonctionne en supposant que toutes les interactions proviennent d'une interface graphique. L'assistant ne doit jamais transmettre directement des instructions ou des libellés GUI à l'API.
| Le serveur 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. Schémas d'interaction recommandés
• Toujours confirmer que la session est active avant d'envoyer une instruction de montage ; réinitialiser si la session a expiré. • Après chaque fermeture de flux SSE, vérifier le résultat via le point de terminaison d'état plutôt que de se fier uniquement au texte diffusé. • Lorsqu'un utilisateur demande une opération qui consomme des crédits, afficher le solde actuel et obtenir une confirmation avant de procéder. • Décomposer les modifications complexes en plusieurs étapes en messages séquentiels à intention unique plutôt que de regrouper plusieurs instructions dans une seule requête. • Si le serveur renvoie une erreur inattendue, informer l'utilisateur et suggérer de reformuler la demande.