comfyui-skill-openclaw

分类: 工具与效率 | 上传者: HuangYuChuh | 下载: 0 | 版本: v1.0（最新）

通过单个 CLI 从任何 AI 代理（Claude Code、OpenClaw、Codex）运行 ComfyUI 工作流程。导入工作流程、管理依赖项、跨多个服务器执行以及跟踪历史记录 — 全部通过 shell 命令完成。 **在以下情况下使用此技能：** (1) 用户请求“生成图像”、“绘制图片”或“执行 ComfyUI 工作流程”。 (2) 用户对图像生成有特定的风格、特征或场景要求。 (3) 用户要求您导入、注册、同步或配置已保存的 ComfyUI 工作流程以供以后重用。

更新日志: Source: GitHub https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw

目录结构

当前层级: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 ci.yml 682 B
  - 📄 sync-frontend.yml 3.6 KB
📁 asset/
- 📄 banner.png 838.1 KB
📁 data/
- 📄 .gitkeep 0 B
📁 docs/
- 📁 _data/
  - 📄 faq.yml 3.0 KB
- 📁 _includes/
  - 📄 jsonld.html 1.6 KB
- 📁 _layouts/
  - 📄 default.html 1.9 KB
- 📁 assets/
  - 📄 logo.png 898.4 KB
  - 📄 site.css 10.3 KB
- 📄 _config.yml 745 B
- 📄 architecture.md 4.3 KB
- 📄 comfyui-native-routes.md 9.0 KB
- 📄 comfyui-native-routes.zh.md 2.0 KB
- 📄 faq.md 1.1 KB
- 📄 Gemfile 140 B
- 📄 Gemfile.lock 11.3 KB
- 📄 getting-started.md 4.7 KB
- 📄 index.md 1.3 KB
- 📄 llms-full.txt 2.3 KB
- 📄 llms.txt 1.1 KB
- 📄 PROJECT_DISCOVERY_CHECKLIST.md 3.0 KB
- 📄 robots.txt 342 B
- 📄 use-cases.md 3.4 KB
📁 outputs/
- 📄 .gitkeep 0 B
📁 references/
- 📄 workflow-import.md 2.6 KB
📁 scripts/
- 📁 shared/
  - 📄 __init__.py 38 B
  - 📄 config.py 2.3 KB
  - 📄 execution_history.py 4.4 KB
  - 📄 frontend_update.py 7.5 KB
  - 📄 health.py 1.4 KB
  - 📄 json_utils.py 495 B
  - 📄 runtime_config.py 4.9 KB
  - 📄 transfer_bundle.py 30.6 KB
  - 📄 updater.py 8.5 KB
- 📄 clean_generated_ui.sh 1.7 KB
- 📄 serve_pages.sh 407 B
- 📄 update_frontend.sh 1.9 KB
📁 tests/
- 📁 ui/
  - 📄 test_dependency_checker.py 12.8 KB
  - 📄 test_subgraph_compat.py 9.7 KB
📁 ui/
- 📁 static/
  - 📁 assets/
    
    📄 index-BJ5B3YBY.js 424.2 KB
    
    📄 index-CljwB4pu.css 58.5 KB
    
    📄 versionUpgrade-Y0m-Lc1G.js 378 B
  - 📄 index.html 4.8 KB
  - 📄 logo.png 898.4 KB
  - 📄 version.json 84 B
- 📄 app.py 25.5 KB
- 📄 comfyui_userdata.py 4.8 KB
- 📄 dependency_checker.py 22.5 KB
- 📄 dependency_installer.py 17.1 KB
- 📄 dependency_registry.py 8.7 KB
- 📄 models.py 6.6 KB
- 📄 open_ui.py 3.8 KB
- 📄 run_ui.bat 3.4 KB
- 📄 run_ui.command 85 B
- 📄 run_ui.sh 3.6 KB
- 📄 services.py 27.1 KB
- 📄 settings.py 1.3 KB
- 📄 workflow_format.py 20.1 KB
- 📄 workflow_import.py 12.8 KB
📄 .gitignore 720 B
📄 CHANGELOG.md 3.3 KB
📄 CHANGELOG.zh.md 2.9 KB
📄 config.example.json 269 B
📄 CONTRIBUTING.md 5.9 KB
📄 LICENSE 1.0 KB
📄 README.ja.md 19.8 KB
📄 README.md 16.1 KB
📄 README.zh-TW.md 15.8 KB
📄 README.zh.md 15.8 KB
📄 requirements.txt 90 B
📄 SKILL.md 7.0 KB
📄 update.sh 463 B

SKILL.md

---
name: comfyui-skill-openclaw
description: |
  Run ComfyUI workflows from any AI agent (Claude Code, OpenClaw, Codex) via a single CLI.
  Import workflows, manage dependencies, execute across multiple servers, and track history
  — all through shell commands.

  **Use this Skill when:**
  (1) The user requests to "generate an image", "draw a picture", or "execute a ComfyUI workflow".
  (2) The user has specific stylistic, character, or scene requirements for image generation.
  (3) The user asks you to import, register, sync, or configure saved ComfyUI workflows for later reuse.
metadata:
  requires:
    bins: ["comfyui-skill"]
  cliHelp: "comfyui-skill --help"
---

# ComfyUI Agent SKILL

> **Prerequisites**: Install the CLI: `pip install -U comfyui-skill-cli`. All commands must run from this project's root directory (where this `SKILL.md` is located).
>
> [!IMPORTANT]
> **Directory Sensitivity**: The CLI reads `config.json` and `data/` from the current directory.
> You **MUST** `cd` into the project root before running any command.
> **Symptom**: `list` returns `[]` or `server status` reports not found → you are in the wrong directory.

## Quick Decision

- User says "generate image / draw a picture" → **Execution Flow (Step 1–4)**
- User says "import workflow / add workflow" → `comfyui-skill --json workflow import <path>`
- User says "img2img / use this image" → first `comfyui-skill --json upload <image>`, then execute
- User says "show previous results" → `comfyui-skill --json history list <id>`
- User says "open management UI" → `python3 ./ui/open_ui.py`

## Core Concepts

- **Skill ID**: `<server_id>/<workflow_id>` (e.g., `local/txt2img`). If server is omitted, the default server is used.
- **Schema**: Each workflow has a `schema.json` that maps business parameter names (e.g., `prompt`, `seed`) to internal ComfyUI node fields. Never expose node IDs to the user.
- **Server**: One or more ComfyUI instances configured in `config.json`. Check health with `server status`.

## Command Reference

| Command | Purpose |
|---------|---------|
| `comfyui-skill --json server status` | Check if ComfyUI server is online |
| `comfyui-skill --json list` | List all available workflows and parameters |
| `comfyui-skill --json info <id>` | Show workflow details and parameter schema |
| `comfyui-skill --json submit <id> --args '{...}'` | Submit a workflow (non-blocking) |
| `comfyui-skill --json status <prompt_id>` | Check execution status |
| `comfyui-skill --json run <id> --args '{...}'` | Execute a workflow (blocking) |
| `comfyui-skill --json upload <image_path>` | Upload image to ComfyUI (for img2img workflows) |
| `comfyui-skill --json deps check <id>` | Check missing dependencies |
| `comfyui-skill --json deps install <id> --repos '[...]'` | Install missing custom nodes |
| `comfyui-skill --json workflow import <path>` | Import workflow (auto-detect format, auto-generate schema) |
| `comfyui-skill --json history list <id>` | List execution history for a workflow |
| `comfyui-skill --json history show <id> <run_id>` | Show details of a specific run |

---

## Execution Flow

### Step 1: Query Available Workflows

```bash
comfyui-skill --json list
```

Returns a JSON array of all enabled workflows with their parameters.

- `required: true` parameters → **ask the user** if not provided.
- `required: false` parameters → infer from context (e.g., `seed` = random number), or omit.
- Never expose node IDs; only use business parameter names (e.g., prompt, style).
- If multiple workflows match, pick the most relevant one or list candidates.

### Step 2: Parameter Assembly

Assemble parameters into a JSON string. Example:
```
{"prompt": "A beautiful landscape, high quality, masterpiece", "seed": 40128491}
```

If critical parameters are missing, ask the user (e.g., "What visual style would you like?").

### Step 3: Pre-flight Dependency Check

**Always** run before first execution of a workflow:

```bash
comfyui-skill --json deps check <server_id>/<workflow_id>
```

- If `is_ready` is `true` → proceed to Step 4.
- If `is_ready` is `false`:
  1. Present missing nodes and models to the user.
  2. If user agrees to install, run:
     ```bash
     comfyui-skill --json deps install <id> --repos '["https://github.com/repo1"]'
     ```
     Use `source_repo` URLs from the check report as `--repos` values.
  3. If `needs_restart` is `true`, inform the user to restart ComfyUI, then re-check.
  4. Missing models must be downloaded manually — tell the user which folder to place them in (e.g., `checkpoints`).

### Step 4: Execute the Workflow

> **Note**: JSON args must be wrapped in single quotes to prevent bash from parsing double quotes.

Choose the execution mode based on your environment:

#### Interactive mode: `submit` + `status` (recommended for chat)

**Step 4a — Submit:**
```bash
comfyui-skill --json submit <id> --args '{"prompt": "..."}'
```
Returns: `{"status": "submitted", "prompt_id": "..."}`. Tell the user generation has started.

**Step 4b — Poll:**
```bash
comfyui-skill --json status <prompt_id>
```

Status values: `queued` (with `position`) → `running` → `success` (with `outputs`) or `error`.

**Polling pattern — critical for real-time feedback:**

Each `status` call must be a **separate tool invocation** (a separate bash command). Do NOT write a shell loop. The correct pattern is:

1. Run `status` as a standalone bash command.
2. Read the returned JSON.
3. If `queued` or `running`: **send a text message to the user** with progress, then run `status` again.
4. If `success`: proceed to Step 5.
5. If `error`: report the error.

#### Non-interactive mode: one-shot blocking (for scripts/CI)

```bash
comfyui-skill --json run <id> --args '{"prompt": "..."}'
```
Blocks until finished. Returns the same result format as `status` with `success`.

### Step 5: Present Results

On success, the result contains an `outputs` array with file references (`filename`, `subfolder`, `type`).
Use your native capabilities to present the files to the user (e.g., image preview, file path).

---

## Workflow Import

When the user wants to add new workflows (not execute existing ones):

```bash
comfyui-skill --json workflow import <json_path> --check-deps
```

- Supports both API format and editor format (auto-detected, auto-converted).
- Automatically generates `schema.json` with smart parameter extraction.
- Use `--check-deps` to verify dependencies immediately after import.

For bulk import from ComfyUI server or local folders, see [`references/workflow-import.md`](./references/workflow-import.md).

## Troubleshooting

1. **ComfyUI Offline**: Run `comfyui-skill --json server status`. If offline, ask the user to start ComfyUI.
2. **Workflow Not Found**: Run `comfyui-skill --json list` to see available workflows. If missing, the user needs to import it first.
3. **Parameter Format Error**: Ensure `--args` is valid JSON wrapped in single quotes.
4. **Cloud Node Unauthorized**: Workflow uses cloud API nodes (Kling, Sora, etc.). Guide user to: (1) Generate an API Key at https://platform.comfy.org, (2) Open Web UI → Server Settings → fill in "ComfyUI API Key".

登录后下载/点赞/收藏 ❤ 204 | ★ 0

comfyui-skill-openclaw

目录结构

SKILL.md

举报内容

提示