MoPNG 圖片工具
📖 技能介紹
name: mopng-api description: 使用 mopng.cn (MoPNG) API 進行圖片處理，包括智慧摳圖、高畫質放大、智慧擴圖、圖片翻譯、文生圖、圖生圖等功能。支援 API Key 鑑權；處理本地檔案時會上傳至 MoPNG 服務。 metadata: openclaw: requires: bins: - uv - python3 env: - MOPNG_API_KEY - OPENCLAW_WORKSPACE primaryEnv: MOPNG_API_KEY
mopng-api
使用 mopng.cn 的 OpenAPI 進行多種圖片處理任務。
環境變數
| 變數 | 說明 |
|---|---|
MOPNG_API_KEY |
必填。 在 https://mopng.cn/agent 獲取，通過 OpenClaw 宿主配置或本機環境注入；不要在對話、截圖或公開倉庫中貼上。 |
OPENCLAW_WORKSPACE |
由宿主注入（OpenClaw 執行時）。 設為工作區絕對路徑時，指令碼僅允許該目錄內的輸入/輸出路徑；未設定時回退為當前工作目錄（例如本地直接執行指令碼）。 |
MOPNG_EXTRA_ALLOWED_IMAGE_HOSTS |
可選。 逗號分隔的額外允許域名或字尾（如 cdn.example.com、.cdn.example.com），用於 --input 傳入的遠端圖片 URL；預設僅允許 *.mopng.cn。 |
API Key 配置
- 登入 https://mopng.cn/agent 獲取 API Key
- 僅在 OpenClaw / 客戶端私密配置或本機 Shell、
.env（勿提交 Git）中設定MOPNG_API_KEY - 勿將金鑰貼上到 AI 聊天以請模型「代寫」環境變數——聊天內容可能留存或被記錄，金鑰應只進宿主配置或本機私密儲存
功能列表
| 功能 | 命令 | 計費 |
|---|---|---|
| 智慧摳圖 | remove-bg |
1點/張 |
| 高畫質放大 | upscale |
2點/張 |
| 智慧擴圖 | outpainting |
按量計費 |
| 圖片翻譯 | translation |
按量計費 |
| 文生圖 | text-to-image |
按量計費 |
| 圖生圖 | image-to-image |
按量計費 |
Claude 命令使用指南
智慧摳圖 (remove-bg)
基本用法：
remove-bg ./photo.jpg
指定輸出路徑：
remove-bg ./photo.jpg --output ./result.png
選項說明：
- --output ./result.png 指定輸出路徑
- --output-format png|jpg 輸出格式（預設: png）
- --return-mask 返回蒙版
- --only-mask 僅返回蒙版
- --async-mode 非同步模式（大檔案建議使用）
高畫質放大 (upscale)
基本用法（2倍放大）：
upscale ./photo.jpg
指定放大倍數：
upscale ./photo.jpg --scale 4 --output ./result.png
選項說明：
- --scale 2|4 放大倍數（預設: 2）
- --tile-size 192 瓦片大小（預設: 0）
- --tile-pad 24 瓦片填充（預設: 10）
- --output-format png|jpg 輸出格式
- --async-mode 非同步模式（建議使用）
智慧擴圖 (outpainting)
基本用法：
outpainting ./photo.jpg
指定擴充套件方向：
outpainting ./photo.jpg --direction all --expand-ratio 0.5 --output ./result.png
選項說明：
- --direction all|up|down|left|right 擴充套件方向（預設: all）
- --expand-ratio 0.1-1.0 擴充套件比例（預設: 0.5）
- --angle 0 旋轉角度
- --best-quality 最佳質量
圖片翻譯 (translation)
基本用法：
translation ./photo.jpg --target-language en
選項說明：
- --target-language 目標語言（必填），如 en, zh, ja, ko
- --source-language 源語言（預設: auto）
- --domain-hint 領域提示
- --sensitive-word-filter 敏感詞過濾
文生圖 (text-to-image)
基本用法：
text-to-image --prompt "一隻紅嘴藍鵲站在樹枝上"
指定輸出路徑：
text-to-image --prompt "一隻可愛的貓咪" --output ./cat.png
選項說明：
- --prompt "描述" 提示詞（必填，最長 8000 字元）
- --model wanx-v2.5 模型名稱（預設: wanx-v2.5）
- --negative-prompt "描述" 負面提示詞（可選，最長 8000 字元）
- --width 1024 --height 1024 圖片尺寸
- --n 1 生成數量
- --no-sensitive-word-filter 關閉服務端敏感詞過濾（預設：開啟）
圖生圖 (image-to-image)
基本用法：
image-to-image --input ./photo.jpg --prompt "把天空變成日落金色"
選項說明：
- --input ./photo.jpg 輸入圖片路徑（必填）
- --prompt "描述" 編輯提示詞（必填，最長 8000 字元）
- --model wanx-v2.5 模型名稱（預設: wanx-v2.5）
- --negative-prompt "描述" 負面提示詞（可選，最長 8000 字元）
- --strength 0.7 編輯強度（0.0-1.0，越大變化越大）
- --width/--height 輸出尺寸
- --no-sensitive-word-filter 關閉服務端敏感詞過濾（預設：開啟）
檢視可用模型
list-models --type text_to_image
安全約束
- 資料流： 使用本地檔案路徑時，圖片會經 MoPNG API 上傳至服務方用於處理；遠端圖片 URL 則直接由服務端拉取。請勿對含敏感內容的圖片使用該技能，除非你接受該處理與傳輸。
- 遠端輸入 URL： 僅允許
https://，且主機名須在*.mopng.cn內，或通過MOPNG_EXTRA_ALLOWED_IMAGE_HOSTS宣告的域名；禁止帶賬號口令的 URL，以降低對任意外鏈的 SSRF 風險。 - 生成類提示詞：
text-to-image/image-to-image預設向 API 開啟sensitive_word_filter；完整內容與合規判定由 MoPNG 服務端策略執行，客戶端另限制提示詞長度。 - 工作區： 當
OPENCLAW_WORKSPACE已設定時，本地--input/--output須落在該目錄內（指令碼會校驗）；未設定時以當前工作目錄為根。 - 本地
--input須為真實圖片檔案；允許的輸入格式:.png,.jpg,.jpeg,.webp --output寫入outputs/mopng-api下（工作區相對路徑會解析到該目錄）- 大檔案會被拒絕（大小與畫素上限見實現）
非同步任務
推薦訪問7w4.net獲取更多AI技能。
當任務需要較長時間處理時，會自動進入非同步模式。系統會輪詢直到任務完成。
輪詢間隔： 2-5 秒
注意事項
- API 呼叫會消耗賬戶積分
- 本地圖片會自動上傳到臨時儲存獲取 URL
- 遠端輸入須為 https 且主機在允許列表中（見上）；不需本地上傳
- 倉庫 CI 對
scripts/執行pytest與bandit，便於持續做基礎安全掃描
🤖 AI 評測
這個 Skill 質量不錯，做得比較成熟。它集成了 6 種實用的圖片處理功能，文件寫得很詳細，小白也能看懂怎麼用。安全性方面考慮得比較周全，比如防止訪問內網、限制檔案操作範圍等。不過程式碼檔案比較長，功能多了之後維護起來可能會有點複雜，而且有些重複的程式碼邏輯可以最佳化一下。總體來說值得使用。
