複数 SNS 向けに寸法とファイル名が揃った PNGを一括で出す場面向けに、リモート Mac+OpenClaw で環境固定・鍵の扱い・テンプレ・リトライ・命名・フォルダ約束を手順化します。OpenClaw インストールガイドとMac での AI 連携 PNG 処理と併読してください。
目次
リモート Mac の環境準備
バッチ用ユーザーを一つに絞り、設定は絶対パスのみ。iCloud 同期フォルダは避け /Users/batch/jobs/ 等へ。
- OpenClaw:版を固定し、開始時に
openclaw --versionをlogs/env-snapshot.txtへ。 - 検証:寸法は
sips -g pixelWidth -g pixelHeight。アルファ監査は ImageMagick/pngcheck+Brewfile で固定。 - 通信:API・ストレージへ HEAD と最小ジョブでスモーク。
API Key・ゲートウェイ・権限の最小化
漏洩時の被害面まで含めて鍵を設計します。
- git 禁止:
.envは ignore。Keychain 等に置き、ジョブ中だけ export。 - ゲートウェイ:マスターキーはプロキシ側に。OpenClaw には内部 URL と短寿命 JWT のみ。
- スコープ/ローテ:画像 API と上限に限定。画面共有後はキー更新。
- ログ:Authorization をマスク。jsonl には ID のみ。
スキルは許可ホストとペイロード上限を固定し、シェル実行はレビュー済みに限定。
貼り付け用:プラットフォーム別サイズ表
下表は manifest のたたき台(PNG・sRGB)。CSV/JSON で版管理してください。
| プラットフォーム/用途 | サイズ(px) | メモ |
|---|---|---|
| Instagram フィード(正方形) | 1080 × 1080 | 安全な初期値。トリムを想定し主要要素は中央寄せ |
| Instagram ストーリー/リールカバー | 1080 × 1920 | 9:16。上下にセーフゾーン |
| LinkedIn/X/FB リンクプレビュー | 1200 × 627 | 1.91:1。文言左、ロゴ右下など |
| Pinterest 縦ピン | 1000 × 1500 | 2:3 の縦長 |
manifest.csv の列例:platform,width,height,slug。行を足すだけで YouTube サムネなどへ拡張できます。
プロンプト/スクリプトテンプレ例
画像生成 API 経由の場合:「描く内容」と「出力条件」を分離し、system は凍結、user だけ変数差し替えにします。
SYSTEM(固定):
マーケ用静止画を生成する。sRGB の PNG 1 枚、枠線なし、透かしなし。
指定の幅・高さを厳守。ツールが異なる寸法を返したら ERROR_DIMS とだけ返し成功とみなさない。
USER(行ごと):
キャンペーン: {{campaign_slug}}
ビジュアル要約: {{brief_one_line}}
サイズ: {{width}}x{{height}} px
ファイル名 stem: {{campaign_slug}}__{{platform}}__{{width}}x{{height}}
シェル:各行で API/スキルへ渡し、sips で寸法一致時のみ out/ へ移動。ローカルでもクラウドでも同じ流れです。
失敗リトライ・検証・命名規約
レート制限・TLS・ポリシー・寸法ズレを想定し、手順を固定します。
- リトライ:指数バックオフ+ジッター、最大 5 回。429/5xx は再試行、ポリシー 400 はスキップ。
- 寸法ゲート:不一致は
failed/dim-mismatch/、logs/errors.jsonlに1行。 - 命名:
{{campaign_slug}}__{{platform}}__{{width}}x{{height}}.png(小文字・二重アンダースコア・スラッグはハイフン)。 - 冪等性:再生成時は
.meta.jsonに入力ハッシュ等。
実行中は
out/ を直接上書きしない。staging/ に書き、検証後に原子移動(rename)で out/ へ入れると、半端な PNG が納品物に混ざりません。
フォルダ出力の約束
キャンペーン単位で同じツリーを使います。
~/jobs/{{campaign_slug}}/
manifest.csv
inbox/ # 元 PSD/中間書き出し(任意)
staging/ # モデル直出し。捨ててよい
out/ # 検証済み PNG のみ
failed/ # 寸法エラー・ポリシー・破損
logs/ # jsonl、env-snapshot
archive/ # out + manifest の zip 納品用
上記 zip で監査用バンドル化。続けてリネーム自動化する場合はフォルダ監視と PNG 自動リネームへ。ワーカー増設時も manifest/命名は流用できます。