IPAdapter 报 ClipVision model not found：CLIP Vision 是独立文件，需放进 models/clip_vision

ClipVision model not found.
（注：以上为转述文本，非逐字原文。）

现象与触发场景

常见触发场景：

• 首次使用 IPAdapter 系列节点，只装了节点没下 CLIP Vision 权重
• 把 CLIP Vision 文件放进了 models/clip 或 models/text_encoders，而节点搜索的是 models/clip_vision
• 用了非 IPAdapter 官方的 CLIP Vision 变体，文件名与节点期望的不一致

根因

• CLIP Vision（图像编码器）与文本用的 CLIP 是两类不同模型，存放目录也不同：前者 models/clip_vision，后者 models/text_encoders（旧名 models/clip）。放错目录时节点扫描不到，就报 model not found。
• CLIP Vision 不属于 checkpoint 的一部分，加载 checkpoint 不会顺带带来它，必须单独下载。
• IPAdapter 官方要求使用 CLIP-ViT-H-14-laion2B-s32B-b79K 这类特定模型；换用其它 CLIP Vision 权重会因为维度/结构不符而失败。

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

1. 第一步：把 CLIP Vision 权重放进 models/clip_vision
   下载 IPAdapter 要求的 CLIP Vision 模型（常见为 CLIP-ViT-H-14-laion2B-s32B-b79K 的 safetensors 版本），放到 ComfyUI/models/clip_vision/ 下。不要放在 models/clip、models/text_encoders 或 models/checkpoints 里。放好后按 R 刷新页面或重启 ComfyUI 让列表更新。
   ComfyUI/models/clip_vision/
2. 第二步：在 CLIPVisionLoader 节点里选中该文件
   IPAdapter 工作流里通常有一个独立的 CLIPVisionLoader（或统一加载器）节点，需要把 clip_name 手动指向刚放入的文件。用统一加载器（IPAdapter Unified Loader）时，如果 preset 与 clipvision 权重不配套，会直接抛 KeyError: 'clipvision'，此时改用分离式加载器（IPAdapter Model Loader + CLIPVisionLoader）手动指定路径更稳。
3. 第三步：仍找不到时检查自定义节点与目录扫描
   确认 ComfyUI_IPAdapter_plus 已正确安装（重启日志里能看到节点注册），并确认没有用 extra_model_paths.yaml 把 clip_vision 指到一个空目录。若确实配置过额外路径，检查该 yaml 里 clip_vision 一项指向的目录里是否真有文件。
   comfyui:
   base_path: /path/to/comfyui/
   clip_vision: models/clip_vision/

验证是否修好

补充说明

报错原文“ClipVision model not found.”来自中文社区转述（我要自学网、CSDN 相关文章），未在官方 issue 中逐字确认，故 error_text_verbatim 标为 false；同现象在 GitHub 上的表现形式为 KeyError: 'clipvision'（cubiq/ComfyUI_IPAdapter_plus issue #627）。

来源

1. [104] （节点仓库 issue）　IPAdapter Unified Loader throw KeyError: 'clipvision' and my solution 　https://github.com/cubiq/ComfyUI_IPAdapter_plus/issues/627
2. [105] （中文社区）　Comfyui运行工作流提示IPAdapter加载器ClipVision model not found.　https://www.51zxw.net/TechArticleDetails.aspx?zid=129&Id=2754
3. [98] （官方文档）　Model Paths Configuration - ComfyUI（clip_vision 目录定义）　https://mintlify.wiki/Comfy-Org/ComfyUI/configuration/model-paths

本条报错提到的目录

本条报错的原文或解决步骤里出现了下面这些 models/ 子目录。 权重库里放在这些目录下的文件已按目录列好，可对照确认自己缺的是哪几个。

本条报错提到的节点仓库

下面这些节点仓库的名字出现在本条报错的正文里。这里只说「名字出现过」，没有断定问题就是它引起的； 点进去可以看这个包的用途、适配模型与下载量。

这条报错要用到的东西

按本条报错所属的类别（模型与权重文件加载）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

同一类别的其他条目

返回报错库