ComfyUIワークフローでのKeyError: CLIPTextEncodeの修正方法

beginner🧠 AI Tools2026-05-17| ComfyUI(全バージョン)、Windows 10/11、Linux(Ubuntu/Debian)、macOS、Python 3.10以降

Error Message

KeyError: CLIPTextEncode
#comfyui#ワークフロー#clip#ノード

エラーメッセージ

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 Nodeconditioning → **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のような表示が出れば完了です。

Related Error Notes