ComfyUI-OpenClaw Skill 🎨✨
A professional, token-saving agent skill for connecting and controlling ComfyUI via API. Designed for high efficiency, automatic asset handling, and seamless integration with OpenClaw.
🏗️ Skill Structure
- Host Address:
192.168.1.38:8190(Configured inTOOLS.md) - Workflow Directory:
skills/comfyui/workflows/(Self-contained within the skill folder) - Output Directory:
outputs/comfy/(Relative to workspace root) - Core Script:
skills/comfyui/comfy_client.py(Handles prompt injection, image uploads, and result polling)
🛠️ Tools (CLI)
Invoke via the exec command: python3 skills/comfyui/comfy_client.py <template_id> "<prompt>" [input_image_path/orientation] [orientation]
Parameters:
- template_id:
1. gen_z: Text-to-Image (uses image_z_image_turbo.json) 2. qwen_edit: Image-to-Image / Editing (uses qwen_image_edit_2511.json) - *Supports automatic image upload.*
- prompt: The description of the image to generate or edits to perform.
- input_image_path: (Optional) Local path for image-to-image tasks.
- orientation: (Optional) Set to
portrait(720x1280) orlandscape(1280x720). Defaults toportrait.
💡 How to Add New Workflows
You can expand this skill easily:
- Place your new API-formatted JSON workflow in
skills/comfyui/workflows/. - Update the
WORKFLOW_MAPdictionary inskills/comfyui/comfy_client.pywith a new ID and the file path. - (Optional) If the workflow uses unique node types, adjust the injection logic in the script's
main()function.
🚀 Token-Saving Strategy
- Template Mapping: Never send full workflow JSONs in the chat. Refer to them by
template_id. - Vision-Saving Strategy: To minimize token usage, the agent should prioritize using the file path from metadata instead of analyzing image content via vision capabilities unless explicitly asked to describe or analyze the image.
- Direct Delivery: Deliver images directly to users via messaging plugins (e.g., Telegram) or local file openers (
open) to avoid bloating the LLM's context window with base64 data.