エラーメッセージ
ComfyUIでワークフローを読み込もうとすると、次のエラーが発生します:
KeyError: 'CLIPTextEncode'
バックエンドがノードレジストリでCLIPTextEncodeを検索しましたが、見つかりませんでした。これはComfyUIのコアノードの一つであるため、定義が見当たらない場合はほぼ確実に、インストールの破損、古いビルド、またはワークフローファイルの破損が原因です。
発生原因
ほとんどのケースは次の4つの原因によるものです:
- **バージョンの不一致:**新しいComfyUIのコミットで作られたワークフローを実行しています。ローカルのコピーがそのノードの最新実装をまだ認識していません。
- インストールの破損:
comfy/内のファイルやnodes.pyが変更、部分的に削除、または不正なアップデートによって上書きされています。 - **JSONの破損:**ウェブのスニペット、pastebin、チャットメッセージからコピーしたワークフローは、転送中に文字化けすることがよくあります。
typeフィールドがCLIPTextEncod(1文字欠落)になっているだけでエラーが発生します。 - **カスタムノードの競合:**一部のサードパーティノードがコアノードを上書きしようとします。そのようなノードが読み込み時にクラッシュすると、
CLIPTextEncodeも一緒に登録解除されてしまうことがあります。
修正方法1:ComfyUIコアを更新する
バージョンの不一致が最も一般的な原因です。他の方法を試す前に、最新の変更を取得してください。
ComfyUIのルートフォルダでターミナルを開き、次のコマンドを実行します:
git pull
pip install -r requirements.txt
Windowsのポータブルビルドをお使いの場合は、代わりにupdate/フォルダ内のupdate_comfyui.batを実行してください。完了後にサーバーを再起動します。
修正方法2:ComfyUI-Managerで欠落ノードを復元する
ワークフローによっては、カスタムのCLIPエンコーダー(例:SDXL専用のコンディショニングノード)が必要な場合があり、それがインストールされていない可能性があります。ComfyUI-Managerで不足しているノードをスキャンして補完できます。
- ブラウザでComfyUIを開きます。
- サイドパネルのManagerをクリックします。
- Install Missing Custom Nodesを選択します。
- リストに
CLIPTextEncodeまたはコンディショニングノードが表示された場合は、インストールして再起動します。
修正方法3:ワークフローJSONを修復する
問題がインストールではなく、ファイル自体にある場合もあります。Base64文字列として共有されたり、チャット経由でペーストされたワークフローは、転送中に文字が失われることがよくあります。引用符の欠落や括弧の削除一つで、ノードタイプが読み取れなくなります。
文字列を手動でデコードし、ノード配列の中に"type": "CLIPTextEncode"があるか確認してください。生のJSONのデコードと検査にはこのBase64ツールを使用しています。ワークフローがURLエンコードされた文字列として届いた場合は、先にURLデコーダーを通してください。+や%22などの特殊文字がフィールド名を静かに破損させることがあります。
修正方法4:ノードを削除して再接続する
ワークフローは開けるが、プロンプトノードがあるはずの場所に赤いボックスが表示される場合は、ノードIDが孤立している可能性があります。以下の手順で対処してください:
- 壊れたノードに接続されているワイヤー(CLIP入力、コンディショニング出力)を確認します。
- 赤い
CLIPTextEncodeノードを削除します。 - 右クリック → Add Node → conditioning → **CLIP Text Encode (Prompt)**を選択します。
- ワイヤーを再接続します。
- ワークフローを新しいJSONファイルとして保存します。
予防策
この問題が再発しないようにするためのいくつかの習慣:
- **週次で更新する:**ComfyUIはノード定義の変更を頻繁に行っています。週次の
git pullで同期を保ち、バージョンのずれを防ぎましょう。 - 安定したワークフローをバックアップする:
last_workflow.jsonに頼らないでください。動作する設定は専用フォルダに名前付きJSONファイルとして保存してください。 - **仮想環境を使用する:**専用の
venvまたはConda環境を使うことで、他のPythonプロジェクトがComfyUIの依存関係を静かに壊すのを防げます。
修正の確認
ComfyUIを再起動し、ブラウザでCtrl+F5を押して強制リフレッシュします。ワークフローを読み込んでください。正常なCLIPTextEncodeノードは緑または紫のヘッダーが表示され、赤い枠線はありません。プロンプトをキューに追加します。コンソールにPrompt executed in 3.2 secondsのような表示が出れば完了です。

