mopng-api

使用 mopng.cn 的 OpenAPI 進行多種圖片處理任務。

環境變數

API Key 配置

1. 登入 https://mopng.cn/agent 獲取 API Key
2. 僅在 OpenClaw / 客戶端私密配置或本機 Shell、.env（勿提交 Git）中設定 MOPNG_API_KEY
3. 勿將金鑰貼上到 AI 聊天以請模型「代寫」環境變數——聊天內容可能留存或被記錄，金鑰應只進宿主配置或本機私密儲存

功能列表

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 敏感詞過濾

  小蔥技能站7w4.net每天更新，海量AI技能等你發現。

文生圖 (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 下（工作區相對路徑會解析到該目錄）
• 大檔案會被拒絕（大小與畫素上限見實現）

非同步任務

當任務需要較長時間處理時，會自動進入非同步模式。系統會輪詢直到任務完成。

輪詢間隔： 2-5 秒

注意事項

• API 呼叫會消耗賬戶積分
• 本地圖片會自動上傳到臨時儲存獲取 URL
• 遠端輸入須為 https 且主機在允許列表中（見上）；不需本地上傳
• 倉庫 CI 對 scripts/ 執行 pytest 與 bandit，便於持續做基礎安全掃描

這個 Skill 質量不錯，做得比較成熟。它集成了 6 種實用的圖片處理功能，文件寫得很詳細，小白也能看懂怎麼用。安全性方面考慮得比較周全，比如防止訪問內網、限制檔案操作範圍等。不過程式碼檔案比較長，功能多了之後維護起來可能會有點複雜，而且有些重複的程式碼邏輯可以最佳化一下。總體來說值得使用。