1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | ComfyUI_Skills_OpenClaw |
| 项目自述名称 | ComfyUI Skills for OpenClaw（README 标题，与正式名称不同，仅记录不作名称使用） |
| 作者/维护者 | HuangYuChuh（个人开发者，GitHub 独立仓库） |
| 来源链接 | https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw |
| 许可证 | MIT（仓库 LICENSE 文件直接确认） |
| GitHub Stars / Forks | 344 / 35（GitHub API 确认，2026-07-13） |
| 最新版本 | v0.4.0（CHANGELOG 记录，发布于 2026-04-08；GitHub Releases 仅正式打标 v0.1.0，后续版本未打 tag） |
| 安装方式 | pip install -U comfyui-skill-cli + git clone 到对应 Agent 的 skills 目录 |
2. 功能介绍与亮点
这是一个把 ComfyUI 图像生成工作流封装成 Agent 可调用 CLI 技能的项目。核心机制是给每个工作流生成一份 schema.json，将底层节点参数映射成 prompt、seed 等业务语义字段，Agent 全程通过结构化命令（list / run / submit / status 等）操作，不直接接触 ComfyUI 原始节点图。
主要能力：
- 工作流导入（自动识别 API/编辑器两种导出格式）、多服务器路由（本地/远程 ComfyUI 实例间切换）、依赖自动检测与一键安装缺失自定义节点
- 支持 non-blocking 提交+轮询（适合对话场景实时反馈进度）与 blocking 一次性执行（适合脚本/CI）两种模式
- 支持图生图、局部重绘的图片/蒙版上传
- 可选接入云端 API 节点（Kling、Sora、Nano Banana 等），需用户主动在 Web UI 中配置 API Key 才启用
亮点：核心 CLI 逻辑独立成单独仓库（ComfyUI_Skill_CLI），本仓库是面向 Agent 生态的薄封装层；SKILL.md 文档详尽，含完整命令参考表、执行流程与故障排查；CHANGELOG 记录了可追溯的 issue/PR 编号，持续活跃维护；README 提供简中/繁中/日语三语版本；附带可视化 Web UI 供人工配置与调试。
3. 适用场景
所属固定分类：集成与工作流自动化
- 已部署本地或远程 ComfyUI 环境、希望通过对话方式而非手动摆弄节点图来调用已保存工作流出图的用户
- 需要把 AI 出图能力接入自动化流程的场景，如批量生成、脚本化出图、CI 中的素材生成
- 团队内设计师已沉淀好 ComfyUI 工作流，希望让非专业用户通过自然语言复用这些工作流
- 需要在多台 ComfyUI 服务器间路由任务、对比显存/性能的多服务器管理场景
4. 跨 Agent 兼容性
| Agent | 结论 | 判断依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | SKILL.md description 与 README 均明确列出，提供对应 skills 目录安装说明 |
| Codex | ✅ 原生支持 | 同上，README/SKILL.md 明确列出并给出安装路径 |
| OpenClaw | ✅ 原生支持 | 项目即面向 OpenClaw 设计，默认安装路径为 ~/.openclaw/workspace/skills，README 标题即为 “ComfyUI Skills for OpenClaw” |
| Hermes Agent | ✅ 原生支持 | README 徽章明确标注 “Hermes Agent: compatible”，SKILL.md metadata 中含专门的 hermes.tags 字段 |
以上结论均基于直接抓取 SKILL.md 与 README 原文得到的显式声明，非搜索摘要臆测。
5. 推荐理由
市面上 ComfyUI×Agent 整合方案多集中在两个极端：一端是重量级生产平台（配置与理解成本高，见第 7 章对比），另一端是把整个 ComfyUI graph JSON 直接丢给 Agent 操作，出错率高、Agent 容易误改内部参数。这个技能走了中间路线——用 schema 映射把工作流参数变成业务语义字段，Agent 全程不接触底层 node ID，兼顾了安全边界与轻量化：单条 pip install 即可安装，无需额外编排后端。它也是本次候选中少数在 SKILL.md 里对 Claude Code / Codex / OpenClaw / Hermes Agent 四个生态都给出明确安装路径的技能，跨生态复用成本低，并已通过第三方自动化安全扫描（SkillsLLM，2026-05-30，无高危问题）。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 344 stars / 35 forks，处于 200–1k 区间中段；在 LobeHub / SkillsLLM / ClawHub / aiskill.market / termo.ai 等多个第三方 skill 市场均有收录，但未发现独立的 Reddit/HN/X 讨论帖 |
| 可用性 | 8 | pip install 一条命令 + clone 目录即可安装，但依赖已运行的 ComfyUI 服务与 Python 3.10+，属“步骤清晰但需少量环境配置”；文档详尽、多语言、维护记录可追溯（issue/PR 编号），最近一次功能更新 2026-04-08，距今约 3 个月，处于临界区间保守计分 |
| 安全性 | 8 | 见下方检查清单 |
| 综合 | 7.3 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 有——通过独立 CLI 工具 comfyui-skill 执行，命令集合固定且文档化，未见任意 shell 执行入口 |
| ② 运行时联网外发数据 | 有——与本地/远程 ComfyUI 服务器通信（HTTP）；可选云端 API 节点需用户主动配置才会外发，默认仅与自建服务器通信，外联目标透明 |
| ③ API key/凭据要求 | 可选——仅使用云端付费节点时需要，通过 Web UI 的 Server Settings 填写存储，未见硬编码明文存储 |
| ④ SKILL.md/脚本可疑指令 | 未发现——直接抓取 SKILL.md 原文逐段审阅，全部为图像生成工作流操作指令，无诱导性或隐藏指令 |
| ⑤ 作者/组织信誉 | 个人开发者，单一仓库主导，无机构背书；但已通过 SkillsLLM 第三方自动化安全扫描（依赖漏洞审计+提示注入启发式检测），结果为 “PASSED / No high-severity issues” |
| ⑥ License 是否明确 | 仓库 LICENSE 文件为 MIT，清晰；但 SKILL.md frontmatter 内自称 license 为 Apache-2.0，与实际不一致，属文档疏漏 |
| ⑦ 最近维护时间 | 最近功能性更新 2026-04-08（CHANGELOG v0.4.0），repo 最后 push 2026-04-21，距今约 3 个月 |
扣分说明：安全性未给满分，主要因作者信誉为个人开发者缺乏机构背书（⑤），以及 License 声明存在内部不一致（⑥），其余各项经审阅原始 SKILL.md 均无实质问题。
7. 跟同类 Skills 相比的优势
| 方案 | 定位/体量 | 跨 Agent 支持 | 核心机制 |
|---|---|---|---|
| ComfyUI_Skills_OpenClaw（本次推荐） | 轻量 CLI-first Agent 技能，pip 安装 |
Claude Code / Codex / OpenClaw / Hermes Agent 均原生支持 | schema.json 参数化，Agent 不接触底层节点 |
| ComfyUI-OpenClaw（rookiestar28，550 stars） | 完整生产级编排平台，含 RBAC/HMAC/SSRF 防护、多租户 | 未明确面向四个生态的轻量 Agent 技能形态 | 安全边界治理 + Telegram/Discord/WhatsApp 等多平台连接器 |
| 直接使用 ComfyUI 原始 graph JSON | 无封装层 | 需自行编写适配代码 | Agent 直接操作原始节点图，出错率高、需自行处理鉴权 |
核心差异化：ComfyUI-OpenClaw 面向需要生产级安全治理和多租户的团队后端场景，配置与理解成本显著更高；直接甩原始 graph JSON 给 Agent 则缺乏参数化保护层，容易误改。本次推荐的技能介于两者之间——足够轻量到一条 pip 命令安装，又通过 schema 映射规避了 Agent 直接摸节点图的风险，是目前少数明确覆盖四个 Agent 生态的 ComfyUI 集成方案。
8. 用户评价
本次通过 SkillsLLM（skillsllm.com/skill/comfyui-skills-openclaw）与 LobeHub 两个第三方 skill 市场页面核实用户评价。SkillsLLM 页面成功抓取，显示“暂无评论”（No comments yet），仅提供 2026-05-30 的自动化安全扫描结果，非用户评价；LobeHub 页面抓取失败（HTTP 403）。未发现 Reddit / Hacker News / X 等平台上关于该技能的独立讨论帖。如实说明：本次未收集到已验证的用户评价，不做凑数。
9. 其他补充
核心 CLI 逻辑已独立为单独仓库 ComfyUI_Skill_CLI（对应 pip 包 comfyui-skill-cli），本仓库是面向 Agent 生态的 SKILL.md 封装层，两者由同一作者维护，关注更新需同时留意两个仓库。README 提供简体中文、繁体中文、日语三语版本，并附带独立的 GitHub Pages 文档站点。
10. 安装使用方式
前置依赖：Python 3.10+，一个可访问的 ComfyUI 服务实例（本地或远程）。
- 安装 CLI：
pip install -U comfyui-skill-cli - 将本仓库 clone 到对应 Agent 的 skills 目录（Claude Code / Codex 参照 SKILL.md 对应路径；OpenClaw 默认为
~/.openclaw/workspace/skills） - 复制
config.example.json为config.json并填入 ComfyUI 服务器地址 - 执行
comfyui-skill server status验证连通性 - （可选）需调用 Kling/Sora 等云端节点时，在 ComfyUI Web UI 的 Server Settings 中填入对应 API Key
安装后注意事项：所有命令须在仓库根目录（SKILL.md 所在目录）下执行，CLI 读取当前目录的 config.json 与 data/，跨目录调用会导致 list 返回空；首次执行某工作流前建议先运行 deps check，避免因缺失自定义节点/模型而执行失败；安装后无需重启 Agent CLI，技能按描述中的触发词（如“生成图片”）自动加载，也可显式要求调用。
11. 注意事项
- 本身不提供图像生成能力，仅作调用层，依赖用户已部署且可访问的 ComfyUI 服务，未搭建环境则无法直接使用
- 受欢迎程度处于中等区间（344 stars），社区独立讨论较少，第三方市场页面尚无用户评价积累，建议先小范围试用
- SKILL.md frontmatter 中的 license 字段（Apache-2.0）与仓库实际 LICENSE 文件（MIT）不一致，请以仓库 LICENSE 为准，此处反映项目文档维护存在疏漏
- 可选的云端 API 节点功能涉及第三方付费服务与 API Key 配置，启用前应确认数据出境与隐私政策是否符合自身合规要求
- 核心 CLI 逻辑拆分在独立仓库（
ComfyUI_Skill_CLI），版本更新需同时关注两个仓库的发布节奏