# Openclaw Comfyui

> ComfyUI-OpenClaw Skill 🎨✨

- Skill: `johnalbertini14-glitch/openclaw-comfyui` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/openclaw-comfyui`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/openclaw-comfyui/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/johnalbertini14-glitch/openclaw-comfyui

---

# 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 in `TOOLS.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) or `landscape` (1280x720). Defaults to `portrait`.

## 💡 How to Add New Workflows
You can expand this skill easily:
1. Place your new API-formatted JSON workflow in `skills/comfyui/workflows/`.
2. Update the `WORKFLOW_MAP` dictionary in `skills/comfyui/comfy_client.py` with a new ID and the file path.
3. (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.