前言¶
在 Cursor、Claude Code 等環境裏做圖片，常見做法是臨時寫一段調用腳本，或把提示詞交給通用對話模型「描述一張圖」。前者要自己處理鑑權、參考圖上傳和異步任務輪詢；後者往往拿不到可直接使用的圖片 URL。若你已經在用 OpenClaw 平臺的圖片能力，更希望 Agent 按固定流程生成、改圖並返回可追蹤的任務結果，可以把邏輯收斂到一個 SkillHub 技能裏。下面介紹社區技能 gpt-image-openclaw（座標 @user_07ea056c/gpt-image-2-new）的定位、能力與安裝方式。
這是什麼¶
gpt-image-openclaw 是 SkillHub 上分類爲 design-media 的社區技能（來源 community，發佈者 user_07ea056c，當前版本 1.0.2）。它通過 OpenClaw 平臺完成作圖、文生圖、圖生圖、圖片編輯，以及商品圖、電商主圖、套圖、詳情頁圖、營銷海報和社媒配圖等需求；當用戶要按提示詞生成新圖、基於參考圖改圖/換風格，或製作多張可分別使用的電商素材時，技能說明要求 Agent 優先啓用本技能。
技能包內自帶 scripts/generate_image.py，統一處理 accessKey 讀取、參考圖壓縮上傳、任務創建、積分預估與輪詢，並在本地維護 openclaw_tasks.json 記錄任務狀態。SkillHub 頁面標註 requires_api_key=true，使用前需配置 OpenClaw 的 accessKey。
核心功能¶
以下能力均來自技能包 SKILL.md 與腳本實現，可與官方簡介對照：
- 文生圖：僅提供提示詞時，調用 OpenClaw 創建生成任務並輪詢至完成。
- 參考圖生圖 / 圖生圖：通過多次
--reference-image傳入本地參考圖；超過 4MB 的圖會先壓縮再上傳，不覆蓋本地原文件。 - GPT 圖片模型與質量檔：默認模型別名
gpt-image-vip（與gpt-image-2、gpt-image-2-vip按同一類 GPT 圖片模型處理）；支持low/medium/high（及中文「低 / 中 / 高」）。腳本還支持nano-banana-pro、nano-banana2。 - 尺寸與清晰度：通過
--size（畫幅比例，如1:1、3:2）和--resolution（如1K、2K、4K）控制輸出。 - 積分預估：創建任務前打印
estimated_credits；文檔內置 1K/2K/4K 各質量檔的預估表，最終以 API 的credits_charged爲準。 - 電商多圖拆分：當提示詞出現「第一張圖」「套圖」「image set」等表述時，技能要求拆成多個獨立任務，保持產品主體與風格一致，並按編號或用途分組返回。
- 任務恢復：未完成的歷史任務會在下次運行腳本時繼續輪詢，避免長任務中斷後丟失進度。
安裝與啓用¶
通過 SkillHub CLI 安裝¶
先確認本機已安裝 skillhub（安裝說明見 SkillHub 安裝文檔）。安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。
skillhub install @user_07ea056c/gpt-image-2-new --dir ~/.cursor/skills/
常用目錄（與官方安裝文檔一致）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
SkillHub 頁面也支持將下面提示交給 AI，讓其按同一文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_07ea056c/gpt-image-2-new。
配置 OpenClaw 鑑權¶
在技能目錄（與 SKILL.md 同級）複製示例配置並填入密鑰：
cp config.example.json config.json
config.example.json 結構如下：
{
"base_url": "https://openclaw.aisupermarket.top",
"access_key": "paste-your-access-key-here"
}
將 access_key 替換爲在 https://openclaw.aisupermarket.top 登錄後，於 openclaw 能力項目中複製的 accessKey。也可僅對當前 shell 設置環境變量（勿寫入日誌或公開倉庫）：
export OPENCLAW_IMAGE_ACCESS_KEY="your-access-key"
export OPENCLAW_IMAGE_BASE_URL="https://openclaw.aisupermarket.top"
典型用法¶
在技能包根目錄（含 scripts/ 的目錄）執行 Python 腳本。路徑以你安裝後的實際目錄爲準，例如 ~/.cursor/skills/@user_07ea056c/gpt-image-2-new/。
文生圖¶
用戶只給提示詞、無參考圖時使用：
python scripts/generate_image.py \
--prompt "A clean product hero image for a black smartwatch on glass" \
--size 1:1 \
--resolution 1K \
--model gpt-image-vip \
--quality medium
未明確要求質量時，技能文檔建議默認 medium；強調省積分用 low，強調高清商用用 high。
參考圖生圖¶
每張本地參考圖重複一次 --reference-image：
python scripts/generate_image.py \
--prompt "Keep the product shape and create a premium launch poster" \
--reference-image "/path/to/product.png" \
--size 3:2 \
--resolution 2K \
--model gpt-image-vip \
--quality medium
成功後腳本輸出 JSON，其中包含任務狀態、圖片 URL，以及 API 返回時的扣費信息；Agent 應按技能說明彙總給用戶，且不在回覆中暴露 accessKey。
適用場景與注意¶
適合誰：已在 OpenClaw 開通圖片能力、希望在 Agent 對話中穩定完成文生圖、參考圖改圖和電商多圖素材編排的開發者或運營同學。
平臺與社區信息：SkillHub 抓取數據顯示該技能評分 100000、下載 2170 次（統計以 SkillHub 頁面爲準）。標籤標明需要 API Key，積分消耗與賬號權限以 OpenClaw 平臺爲準。
使用注意：
accessKey等同密碼，不要提交 Git 或出現在截圖、公開 issue 中；openclaw_tasks.json僅保存任務狀態，不含密鑰。- 參考圖上傳前有 4MB 限制，大圖會自動壓縮爲 JPEG；透明通道會先鋪白底。
- 默認輪詢間隔 2 秒、超時 300 秒，可通過
--poll-interval、--timeout調整；超時未完成的任務 ID 仍寫在openclaw_tasks.json中，下次運行可繼續跟輪詢。 - 排錯時可查閱技能包內
references/api.md，日常生成不必必讀。
結尾¶
gpt-image-openclaw 把 OpenClaw 的圖片生成流程封裝成 Agent 可複用的 SKILL.md 與腳本：配置一次 accessKey，即可在對話裏完成文生圖、參考圖生圖和電商套圖拆分，並拿到可追蹤的任務與圖片 URL。
- SkillHub API 頁：https://api.skillhub.cn/user_07ea056c/gpt-image-2-new
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_07ea056c/gpt-image-2-new
