Midjourney → Instagram（linkmidjourneyinstagram）
專案根目錄
自動化程式在 repository root（與 skills/ 同層、含有 main.py 的那個資料夾）。
透過 exec 執行指令時，必須先 cd 到該目錄；不要只在 {baseDir}（此 skill 資料夾）底下跑 python main.py。
何時用這份 skill
- 使用者要「從 Midjourney 產圖 → 自動發四則 IG 貼文」。
- 需要選擇 caption 來源：
captions.txt、與 MJ 相同的 prompt、或 vision API。 - Troubleshooting：首次登入、Playwright、HEADLESS、POST_DELAY、Gemini 區域限制等。
前置條件
- Python 3.10+，
python在 PATH。 - Midjourney 有效訂閱（Google / Discord OAuth，由瀏覽器手動完成首次登入）。
- Instagram 帳號；
.env內需INSTAGRAM_USERNAME、INSTAGRAM_PASSWORD（見.env.example）。 - 依賴：
pip install -r requirements.txt，並執行python -m playwright install chromium。
安裝與設定（一次性）
於 repository root：
python -m venv .venv
啟用 venv 後（Windows：.venv/Scripts/activate；macOS/Linux：source .venv/bin/activate）：
pip install -r requirements.txt
python -m playwright install chromium
cp .env.example .env
編輯 .env 填入 IG 帳密；其餘選項見 .env.example 註解。
首次執行（務必可視瀏覽器）
- 維持
HEADLESS=false（預設），讓 Chromium 視窗開著。 - Midjourney：完成 Google/Discord 登入與驗證；session 會存到
browser_data/midjourney/。 - Instagram：完成網頁登入與可能的 2FA；session 會存到
browser_data/instagram/。 - 之後可視需求改
HEADLESS=true。
執行 pipeline（給 agent 用 exec）
預設讀取 prompt.txt 與 captions.txt：
python main.py
常用選項：
python main.py --prompt "your midjourney prompt here"
python main.py --skip-instagram
python main.py --headless
python main.py --post-delay 60
python main.py --use-prompt-caption
python main.py --use-vision-caption
行為摘要：
| 模式 | 條件 |
|---|---|
| Vision caption | --use-vision-caption 或 .env 中 INSTAGRAM_USE_VISION_CAPTION；若設了 GEMINI_API_KEY/GOOGLE_API_KEY 且未明確關閉，預設會開 vision |
| Prompt 當 caption | --use-prompt-caption 或 INSTAGRAM_USE_PROMPT_CAPTION=true（vision 開啟時會被蓋過） |
captions.txt | 上述皆否時，依 --- 分區塊，每張圖一則；區塊不足則用最後一則重複 |
Vision：GEMINI_API_KEY / GOOGLE_API_KEY，或 VISION_CAPTION_PROVIDER=openai 搭配 OPENAI_API_KEY。詳見 .env.example。
編輯輸入檔
prompt.txt：以 # （井號+空白）或單獨 # 開頭的行為註解並忽略；#midjourney 這類標籤保留。非註解行會用空白串成一句送進 Midjourney。
captions.txt：四個（或多個）區塊，區塊之間一行 ---。註解規則同 prompt.txt。
輸出與安全
- 圖片：
outputs/mj_<timestamp>/image_1.png…image_4.png。 - 勿 commit
.env、browser_data/（含 session cookie）；已應在.gitignore。 - 自動發文可能觸發平台風控；善用
--post-delay（預設對應POST_DELAY_S），勿過度密集發送。
OpenClaw 載入後
必要時請使用者 /new 或重啟 gateway；可用 openclaw skills list 確認 skill 名稱 link-midjourney-instagram 已載入。