← Back to Skills Marketplace
salmonrk

OpenClaw ComfyUI

by SalmonRK · GitHub ↗ · v1.0.4
cross-platform ✓ Security Clean
2452
Downloads
11
Stars
17
Active Installs
3
Versions
Install in OpenClaw
/install openclaw-comfyui
Description
Connect and control ComfyUI API efficiently using template mapping and auto-asset management for image generation and editing tasks.
README (SKILL.md)

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 \x3Ctemplate_id> "\x3Cprompt>" [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.
Usage Guidance
This skill appears to do what it claims, but check these before installing: 1) Verify the TOOLS.md host/port entry points to a trusted ComfyUI server (the script will upload local files to that host — if TOOLS.md points to an untrusted remote, sensitive files could be transmitted). 2) Only pass input files you intend to upload; the script will POST them to the configured host. 3) Inspect workflows/ for any embedded prompts (the included JSONs contain explicit sexual content and may violate usage policies). 4) Run the skill in a constrained environment (local or isolated VM/container) if you are unsure about the target ComfyUI host. 5) Ensure Python dependencies (requests) are installed from trusted sources. If you want additional assurance, review or run the Python script locally with a deliberately misconfigured or local-only TOOLS.md to observe behavior before enabling agent-autonomous calls.
Capability Analysis
Package: comfyui-skill (xpi) Version: 1.0.4 Description: Professional ComfyUI control skill for OpenClaw with token-saving architecture, auto-asset management (Image/Video/Audio), and dynamic security validation. The `comfyui-skill` package provides a Python client (`comfy_client.py`) to interact with a ComfyUI instance via its API. It supports dynamic workflow execution, including text-to-image and image-to-image tasks, with features like automatic asset upload and result downloading. The script reads ComfyUI host and port from `TOOLS.md`, ensuring user-controlled configuration. It implements a whitelist for file extensions (`.jpg`, `.png`, `.mp4`, etc.) during uploads, preventing arbitrary file execution or sensitive data exfiltration through the ComfyUI server. Generated output files are saved to a dedicated `outputs/comfy/` directory within the workspace. The script dynamically modifies ComfyUI workflow JSONs (located in `workflows/`) to inject prompts, input image filenames, and desired resolutions, which is standard behavior for ComfyUI automation. All network communication is directed solely to the user-configured ComfyUI endpoint. There is no evidence of arbitrary code execution, unauthorized network activity, or malicious file system manipulation. The package adheres to expected functionality for an agent skill interacting with a local or user-specified ComfyUI instance.
Capability Assessment
✓ Purpose & Capability
Name/description claim: connect to and control ComfyUI for image generation/editing. The repository contains workflow JSONs and a Python client that reads a ComfyUI host from workspace TOOLS.md and performs uploads, prompts, polling, and downloads — exactly what is needed to implement the described capability.
ℹ Instruction Scope
SKILL.md instructs the agent to run the bundled comfy_client.py with a template_id and prompt. The script reads workspace TOOLS.md for Host/Port, substitutes prompts into local workflow JSONs, uploads any provided local input files to the configured ComfyUI host, polls for results, and downloads generated files to outputs/comfy/. These actions are within scope for controlling a ComfyUI instance, but be aware the script will upload any input file you pass (allowed extensions include images, video, audio). Also the included workflow JSONs embed explicit/sexual prompt text — review content policy implications before use.
✓ Install Mechanism
Instruction-only skill with a visible Python script. No install spec or remote download/exec behavior is present. The only runtime dependency is the requests Python package (mentioned in README), which is reasonable for the task.
✓ Credentials
The skill requests no environment variables or credentials. It reads a local TOOLS.md file to get the ComfyUI host/port; this is reasonable for a tool intended to contact a ComfyUI server. There are no unrelated credentials or config paths requested.
✓ Persistence & Privilege
always:false and user-invocable:true. The skill does not alter other skills or system-wide configs. It runs only when invoked and only touches its own workflows and outputs directory.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-comfyui
  3. After installation, invoke the skill by name or use /openclaw-comfyui
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
openclaw-comfyui 1.0.4 - manifest.json updated for new release version. - Minor internal updates in comfy_client.py; documentation, structure, and references kept consistent. - No changes to workflows or CLI usage.
v1.0.3
openclaw-comfyui 1.0.3 Changelog - Rewrote SKILL.md in English for wider accessibility and professional clarity. - Added detailed explanations for parameters, workflows, and CLI usage. - Clarified procedures for adding new workflows. - Explained token-saving and efficiency strategies, emphasizing template mapping and direct file handling. - Updated terminology for better alignment with OpenClaw ecosystem.
v1.0.2
- เพิ่ม SKILL.md พร้อมวิธีใช้งานและโครงสร้าง Skill สำหรับเชื่อมต่อ ComfyUI API - รองรับระบบ Template Mapping และ Auto-Asset Management เพื่อประหยัด Token - อธิบายการใช้งาน CLI และ parameter orientation (portrait/landscape) - เพิ่มคำแนะนำในการเพิ่ม Workflow ใหม่และวิธีอัปเดต WORKFLOW_MAP - เน้นกลยุทธ์ลดการใช้ Token โดยไม่แปะ JSON ใน prompt และใช้ path-based messaging
Metadata
Slug openclaw-comfyui
Version 1.0.4
License —
All-time Installs 19
Active Installs 17
Total Versions 3
Frequently Asked Questions

What is OpenClaw ComfyUI?

Connect and control ComfyUI API efficiently using template mapping and auto-asset management for image generation and editing tasks. It is an AI Agent Skill for Claude Code / OpenClaw, with 2452 downloads so far.

How do I install OpenClaw ComfyUI?

Run "/install openclaw-comfyui" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is OpenClaw ComfyUI free?

Yes, OpenClaw ComfyUI is completely free (open-source). You can download, install and use it at no cost.

Which platforms does OpenClaw ComfyUI support?

OpenClaw ComfyUI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created OpenClaw ComfyUI?

It is built and maintained by SalmonRK (@salmonrk); the current version is v1.0.4.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments