Orshot-HQ/orshot-openclaw

Contenu Social Orshot : concevez le modèle une fois, publiez-en pour toujours

Le contenu social d'Orshot repose sur un modèle designé avec un nouveau texte à chaque publication, et non une nouvelle image IA à chaque fois. Cette compétence permet de créer des modèles Orshot studio qui ont l'air professionnellement conçus, et non le look « IA » centré générique, pour les posts Instagram, les posts LinkedIn, TikTok et Reels, les stories, les publicités, les bannières, les miniatures et les carrousels. C'est la couche de connaissance qui se superpose aux outils de design du serveur MCP Orshot (orshot_create_template_design, orshot_update_template_design, orshot_patch_template_elements, orshot_get_brand_kit).

Connectez-vous d'abord

openclaw mcp add orshot --url https://mcp.orshot.com/mcp --transport streamable-http --auth oauth
openclaw mcp login orshot

Les outils de design renvoient des vignettes intégrées et des vérifications de design, ils sont donc exclusivement MCP. Le plan gratuit (100 crédits par mois, sans carte) couvre la création de modèles et les aperçus. Les détails et le repli REST pour le rendu se trouvent dans la compétence orshot.

Générer un modèle pour une plateforme

1. Choisissez le format. Passez le préréglage comme size lors de la création et du rendu, ou donnez la largeur et la hauteur.

Plateforme	Préréglage	Pixels
Post Instagram (portrait, le défaut 2026)	instagram-post-portrait	1080x1350
Carré Instagram	instagram-post	1080x1080
Story Instagram, couverture Reels, TikTok, YouTube Short	instagram-story, tiktok-video, youtube-short	1080x1920
Post LinkedIn	linkedin-post	1200x627
Carrousel LinkedIn (pages PDF ou image)	linkedin-carousel	pages carrées ou 4:5
Post X, bannière X	twitter-post, twitter-header	1200x675, 1500x500
Post Facebook, story, couverture	facebook-post, facebook-story, facebook-cover	1200x630, 1080x1920, 851x315
Pinterest pin	pinterest-pin	1000x1500
Miniature YouTube	youtube-thumbnail	1280x720

Liste complète : la ressource MCP orshot://formats.

2. Lisez les spécifications et la charte. orshot://template-design-spec (schéma des éléments, les pièges de l'animation), puis orshot_get_brand_kit quand le design doit être cohérent avec la marque.
3. Lisez le pack references/social-media.md pour les zones de sécurité, les archétypes et une recette. Choisissez un archétype différent du dernier modèle de ce type.
4. Créez avec orshot_create_template_design, complétez pages_data, chaque élément de texte en textMode: "fit" avec minFontSize, les champs dynamiques marqués parameterizable: true avec des parameterId en snake_case (headline, subtitle, product_image), includeThumbnails: true.
5. Critiquez la vignette et la vérification du design, corrigez avec orshot_update_template_design ou orshot_patch_template_elements. Ne publiez jamais la première passe sans l'avoir vue.
6. Rendez-le avec le texte réel (orshot_render_template) et montrez le résultat à l'utilisateur. Un design, toutes les tailles : extraSizes: ["instagram-story", "linkedin-post", "1080x1080"].
7. Transférez. La publication, la programmation et l'analyse sont dans la compétence orshot-social-media-scheduler ; les carrousels de six diapositives dans orshot-carousel. Gardez le modèle ; chaque publication future est un rendu, pas une refonte.

Quand l'utiliser

Utilisez-la chaque fois que vous concevez ou affinez un modèle visuel : un post social / une story / un carrousel, une création publicitaire, une bannière, une miniature, un graphique de lancement. Pour le schéma des éléments du studio et les pièges de rendu, consultez également la ressource MCP orshot://template-design-spec.

Limites

• Ceci est un guide de conception, il NE remplace PAS la spécification du schéma. Les valeurs de style sont toujours des chaînes avec des unités ; position / dimensions sont des objets imbriqués. Voir Compatibilité ci-dessous.
• Il se compose avec la compétence orshot (mécanismes d'API / de génération) : utilisez-la pour le rendu.

Principe de fonctionnement

Le design sert la tâche. Décidez de la SEULE chose que le spectateur doit retenir, puis faites en sorte que tout la soutienne. Respectez la marque et la plateforme plutôt qu'un joli générique. Préférez les règles déterministes ci-dessous à une itération subjective.

Workflow requis (dans l'ordre)

1. Forme : reformulez l'objectif, le public et le message clé unique avant de placer quoi que ce soit.
2. Héritez de la marque (quand c'est de marque) : SI le design doit correspondre à la marque / au produit de l'utilisateur (l'invite l'implique, ou demande « notre » style), appelez orshot_get_brand_kit (filtrez par balise selon l'objectif) et mappez les couleurs / polices / logo de la marque sur les rôles dans Systèmes. Si l'invite demande un look générique / autonome, utilisez les valeurs par défaut du pack, n'imposez pas la marque.
3. Choisissez le pack vertical : lisez le fichier correspondant dans references/ (par ex. references/social-media.md) pour le format, les zones de sécurité, les archétypes et une recette concrète. Choisissez un archétype DIFFÉRENT des modèles récents de ce type.
4. Construisez : établissez un élément focal, puis soutenez-le. Gardez le design simple lors de la première création ; affinez-le dans une mise à jour ultérieure.
5. Critiquez : créez / mettez à jour avec includeThumbnails: true, LISEZ la vignette et corrigez les problèmes avec orshot_update_template_design / orshot_patch_template_elements. Ne publiez jamais la première passe sans l'avoir vue. (L'outil de création renvoie également un « Vérification du design 🎨 », résolvez ses ⚠.)

Systèmes

• Hiérarchie : un point focal clair via la taille, le poids et la position. Pas tout centré.
• Typographie : exactement 2 familles de polices (d'affichage + de corps). Hiérarchie via l'échelle / le poids. lineHeight serré (1.0–1.15) et letterSpacing légèrement négatif sur les grandes polices d'affichage. La police de marque la plus lourde → affichage, la plus légère → corps.
• Couleur, 60-30-10 : 60% dominante, 30% secondaire, 10% d'accent. Une palette cohérente bat plus de couleurs. Contraste WCAG AA clair. Mappez les couleurs de la marque sur les rôles par USAGE, pas par l'étiquette « primaire ».
• Composition et espacement : marges généreuses (≥ ~6% du canevas par bord), alignez sur une grille implicite, préférez le décentré à l'empilement centré.
• Imagerie : en plein écran ou intentionnellement encadrée ; objectFit: "cover" pour les photos ; ajoutez un dégradé sous le texte sur les photos chargées.

Marque (contextuel, pas obligatoire)

Utilisez la charte graphique QUAND le design doit être cohérent avec la marque (l'invite fait référence à la marque, au produit ou à l'identité de l'utilisateur) : couleurs → rôles 60-30-10, polices → affichage / corps, logo → une petite marque de coin / pied de page, images → héro / produit. Pour un look générique / exploratoire / autonome, la palette du pack est suffisante, n'imposez pas les éléments de la marque.

Variété

Ne répétez jamais une mise en page pour le même type de contenu. Variez l'archétype, le placement focal et l'accentuation des couleurs entre les designs de même nature.

Compatibilité (faites-les correctement ou le rendu échoue silencieusement)

• TOUTES les valeurs de style sont des chaînes avec unités : "48px", "700", "12px" : jamais de nombres nus.
• position et dimensions sont des objets imbriqués ({x, y}, {width, height}).
• Définissez textMode: "fit" + minFontSize sur CHAQUE élément de texte (minimums : titre 48, sous-titre 28, corps 24, accroche 18, légende 14). La valeur par défaut "overflow" ne réduit pas ni ne refond le texte, le texte long / paramétré déborde de son bloc.
• Sauts de ligne : utilisez \n, JAMAIS <br> ; évitez les blocs <p> multiples (ils se chevauchent). Pour un titre multi-lignes avec un mot d'accent de couleur, utilisez un élément de texte par ligne.
• Un <span> arrière-plan surligné (pastille colorée) force tout l'élément sur une ligne (white-space: nowrap) → débordement sur un texte long. Mettez en surbrillance seulement 1–3 mots ; pour les titres longs, utilisez l'accentuation par color (sans arrière-plan) ou divisez par ligne.
• Les champs paramétrables nécessitent parameterizable: true, un parameterId unique en snake_case et un parameterType correspondant à l'élément (texte → "text", image → "imageUrl", forme → "fill", canevas / conteneur → "backgroundColor").
• Les formes avec un remplissage transparent + une bordure ne rendent rien ; le content SVG doit être un data-URI.

Mouvement et audio (modèles vidéo)

Rendre la vidéo designée, pas générée :

• Révéler en sections sur ~4–5 s. Les éléments qui forment une unité (icône+étiquette, une ligne de spécifications, le pied de page) partagent le MÊME type enter et showAt ; décalez de ~0.3–0.5 s ENTRE les sections dans l'ordre de lecture. showAt / hideAt sont des frères de enter / exit : jamais imbriqués à l'intérieur.
• Chaque photo en plein écran obtient un kenBurns ambiant (zoom 1.08–1.15). Une photo fixe maintenue 3 secondes se lit comme une image morte ; un slow push se lit comme une séquence. Alternez la direction panX entre les pages.
• L'ambiant reste subtil et LENT : cycles de 6–10 s contre un enter de 0,5 s. Si le spectateur peut nommer le mouvement, il est trop fort, sauf s'il s'agit d'un accent délibéré (un badge qui bouge). shake / slowRotate nécessitent easing: "linear" ou la couture de boucle est visible.
• Une pageTransition pour toute la vidéo, 0.3–0.5 s. Une transition différente par coupure est le signe le plus clair d'un montage généré automatiquement.
• Son par défaut : piste de narration au volume 1 + un lit ambiant généré retenu (sfx, volume 0.08–0.18, boucle) + page.subtitle { source: "auto-audio" } avec un préréglage de légende (karaoke / bold) et strokeWidth 2–3 sur une séquence chargée. Budget narration à ~2 mots / seconde avec 1 s de marge. Appelez orshot_get_audio_authoring_options avant d'écrire l'audio généré ; donnez tts.parameterId pour que le texte parlé reste un paramètre de rendu.

Anti-patrons (les signes de l'IA de qualité médiocre, à éviter)

• Tout centré et empilé ; pas de point focal.
• 3+ polices, ou des tailles aléatoires sans hiérarchie.
• Texte à faible contraste sur une photo chargée sans dégradé.
• Forcer les éléments de la marque quand l'invite n'a pas demandé un design de marque (ou ignorer la charte quand elle l'a clairement fait).
• Un titre minuscule au-dessus d'un paragraphe de corps de texte (un modèle n'est pas un document).
• Réémettre la mise en page précédente pour le même type de contenu.

Packs verticaux (divulgation progressive)

Lisez celui qui correspond à la tâche, chacun ajoute un format / des zones de sécurité, des archétypes et une recette :

• references/social-media.md : posts, stories, carrousels.
• (davantage de verticaux, publicités, immobilier, e-commerce, ajoutés ici au fil du temps.)

Exemples

Exemple 1, « Crée un post Instagram annonçant notre nouvelle fonctionnalité »

1. orshot_get_brand_kit (balises : "social-media") → couleurs / polices / logo de la marque.
2. Lisez references/social-media.md → portrait 4:5 par défaut 1080×1350 ; choisissez l'archétype type-hero (différent du dernier post).
3. orshot_create_template_design avec la police d'affichage de la marque pour un titre surdimensionné, la couleur dominante de la marque comme fond, une couleur d'accent sur un mot, le logo + @handle en pied de page, includeThumbnails: true.
4. Lisez la vignette + « Vérification du design 🎨 » ; corrigez le contraste / l'espacement si nécessaire.

Exemple 2, « Affine ce modèle, il a l'air générique »

1. orshot_get_studio_template pour inspecter le design actuel.
2. Diagnostiquez en fonction des Anti-patrons (centré ? 3+ polices ? pas de point focal ? marque ignorée ?).
3. orshot_patch_template_elements pour définir un titre focal, réduire à 2 polices, appliquer la règle 60-30-10 de la marque, aligner à gauche / en bas. Re-rendez avec includeThumbnails: true et vérifiez.

Dépannage

Le titre s'affiche sur une ligne / <br> ignoré. Utilisez \n, pas <br>. Pour un mot coloré dans un titre multi-lignes, divisez en un élément de texte par ligne.

Les couleurs / polices semblent hors marque. Vous avez sauté l'étape 2, appelez orshot_get_brand_kit et mappez la value (couleurs) et le name (polices) retournés sur le design.

La « Vérification du design 🎨 » avertit d'une répétition. Cette mise en page correspond à un modèle récent du même type. Changez d'archétype et déplacez le point focal.