2026 OpenClaw en pratique par lot : API, modèles de script et PNG multi-formats réseaux sur Mac distant

① Freins habituels sans cadre lot

1. Dispersion des secrets : une clé API collée dans un dépôt Git ou un carnet partagé expose le compte fournisseur et invalide les audits.
2. Sorties non traçables : sans run_id ni dossiers par plateforme, on écrase des visuels ou on mélange les versions « recadrage Stories » et « carré fil ».
3. Absence de politique de retry : un timeout réseau ou une limite de débit laisse le lot à moitié généré ; sans journal, personne ne sait quoi relancer.

La suite verrouille ces points avec des conventions concrètes : installation OpenClaw, dossier surveillé.

② Matrice : curl, script bash, passerelle OpenClaw

③ Préparation Mac distant et dossiers

Sur le Mac distant : macOS à jour, Xcode CLT pour sips si besoin, SSH stable (guide SSH/VNC). Racine type ~/SocialBatch :

• input/ — visuels sources ou manifeste JSON listant les visuels et les cibles ;
• out/ig/, out/li/, out/x/ — un sous-dossier par famille de formats ;
• logs/ — un fichier par exécution (20260324T1530Z.txt) ;
• failed/ — requêtes ou fichiers partiels à rejouer.

Documentez ces chemins dans un README interne et dans la configuration OpenClaw afin qu’un autre opérateur relance le même lot sans improviser. Si vous enchaînez avec une étape post-traitement (conversion profil, rogne léger), gardez un script postprocess.sh à côté du manifeste pour que la chaîne reste une seule commande documentée.

Gabarit minimal d’appel (à adapter à votre endpoint) : chargez la clé depuis l’environnement, envoyez le corps JSON du manifeste, écrivez la réponse binaire dans out/ seulement si le code HTTP est 200, sinon incrémentez le compteur de retry. Ainsi le lot reste idempotent côté fichiers : un échec ne laisse pas un PNG tronqué dans le dossier de livraison.

④ Clés API, passerelle et journaux

Passerelle HTTP vers OpenClaw : TLS, filtrage IP, jeton distinct de la clé fournisseur, pas de logs contenant le corps des requêtes sensibles. Fixez débit max et timeouts. Voir cas d’usage OpenClaw 2026.

⑤ Modèle de prompt et gabarit d’appel

Fixez un prompt système court et un modèle utilisateur qui répète la liste des formats. Exemple de bloc utilisateur rejouable (à adapter à votre API) :

Rôle : générer des PNG pour une campagne « spring-drop ».
Source : fichier décrit dans le manifeste JSON (champ asset_id).
Formats à produire (largeur x hauteur, sRGB, transparence si logo) :
- ig_feed : 1080x1350
- ig_story : 1080x1920
- li_cover : 1584x396
- x_card : 1600x900
Sortie : un fichier PNG par ligne, nom conforme au schéma indiqué dans le manifeste.
Refuser toute demande hors liste ; en cas d’ambiguïté, écrire une entrée dans logs/ et ne pas inventer de dimensions.

Script : fonction qui lit le manifeste, boucle, écrit dans out/<plateforme>/. Prompt dans prompts/v1_social.txt versionné.

⑥ Échecs, retries et nommage des fichiers

Trois tentatives, backoff 2s / 8s / 32s ; sinon entrée dans failed/ + code HTTP. run_id par exécution pour ne pas écraser une livraison OK. Nom : campagne_plateforme_LxH_v02.png (minuscules, pas d’accents dans le fichier). Option : shasum -a 256 dans le journal pour la traçabilité.

⑦ Chiffres et formats à citer

• 1080 × 1350 px — fil Instagram portrait ; ancrer dans le manifeste.
• 1080 × 1920 px — Stories ; largeur alignée avec le fil.
• 1584 × 396 px — bandeau LinkedIn ; marge visuelle (recadrage client).

⑧ Passer à l’exécution sur un nœud dédié

Résumé : ~/SocialBatch figé, secrets hors Git, prompt versionné, retries bornés, noms normalisés. Un Mac distant dédié isole la charge et les chemins macOS (sips, outils design). Accueil, blog, aide SSH/VNC.