Cách Sửa Lỗi KeyError: CLIPTextEncode trong ComfyUI Workflows

Thông Báo Lỗi

Bạn đang tải một workflow trong ComfyUI — rồi lỗi này xuất hiện:

KeyError: 'CLIPTextEncode'

Backend cố tra cứu CLIPTextEncode trong registry node nhưng không tìm thấy. Vì đây là một trong những node lõi của ComfyUI, nếu định nghĩa bị thiếu thì gần như chắc chắn là do cài đặt bị hỏng, bản build cũ hoặc file workflow bị lỗi.

Nguyên Nhân Gây Ra Lỗi

Bốn nguyên nhân phổ biến nhất:

• Không tương thích phiên bản: Bạn đang chạy một workflow được tạo từ commit ComfyUI mới hơn. Bản local của bạn chưa có phần cập nhật mới cho node đó.
• Cài đặt bị hỏng: Các file bên trong comfy/ hoặc nodes.py đã bị chỉnh sửa, xóa một phần, hoặc bị ghi đè bởi một bản cập nhật lỗi.
• JSON bị biến dạng: Workflow sao chép từ các đoạn code trên web, pastebin hoặc tin nhắn chat thường bị hỏng trong quá trình truyền tải. Trường type có thể bị thành CLIPTextEncod — thiếu một ký tự là đủ để gây ra lỗi.
• Xung đột node tùy chỉnh: Một số node bên thứ ba cố ghi đè node lõi. Nếu node đó bị lỗi khi tải, nó có thể âm thầm hủy đăng ký CLIPTextEncode cùng với chính nó.

Cách Sửa 1: Cập Nhật ComfyUI Core

Không tương thích phiên bản là nguyên nhân phổ biến nhất. Hãy kéo các thay đổi mới nhất trước khi thử bất kỳ cách nào khác.

Mở terminal trong thư mục gốc ComfyUI và chạy:

git pull
pip install -r requirements.txt

Đang dùng bản Windows portable? Chạy update_comfyui.bat từ thư mục update/ thay thế. Khởi động lại server sau khi hoàn tất.

Cách Sửa 2: Dùng ComfyUI-Manager để Khôi Phục Node Bị Thiếu

Một số workflow phụ thuộc vào CLIP encoder tùy chỉnh — chẳng hạn node conditioning dành riêng cho SDXL — mà hệ thống của bạn chưa cài. ComfyUI-Manager có thể quét và tự động điền vào các chỗ còn thiếu.

• Mở ComfyUI trên trình duyệt.
• Nhấn Manager ở thanh bên.
• Chọn Install Missing Custom Nodes.
• Nếu CLIPTextEncode hoặc bất kỳ node conditioning nào xuất hiện trong danh sách, hãy cài và khởi động lại.

Cách Sửa 3: Phục Hồi File Workflow JSON

Đôi khi vấn đề không phải ở cài đặt của bạn — mà ở chính file. Workflow được chia sẻ dưới dạng chuỗi Base64 hoặc dán qua chat thường mất ký tự trong quá trình truyền. Chỉ cần một dấu nháy sai hoặc thiếu một dấu ngoặc là đủ khiến kiểu node không đọc được.

Hãy giải mã chuỗi thủ công và tìm "type": "CLIPTextEncode" bên trong mảng nodes. Tôi dùng công cụ Base64 này để giải mã và kiểm tra JSON thô. Nếu workflow đến dưới dạng chuỗi URL-encoded, hãy chạy qua URL decoder trước — các ký tự đặc biệt như + và %22 có thể làm hỏng tên trường một cách âm thầm.

Cách Sửa 4: Xóa và Kết Nối Lại Node

Workflow mở ra nhưng hiển thị hộp đỏ ở chỗ node prompt? ID node có thể đã bị mồ côi. Làm theo các bước sau:

• Ghi lại các dây kết nối vào node bị hỏng (đầu vào CLIP, đầu ra conditioning).
• Xóa node CLIPTextEncode màu đỏ đó.
• Nhấn chuột phải → Add Node → conditioning → CLIP Text Encode (Prompt).
• Kết nối lại các dây.
• Lưu workflow dưới dạng file JSON mới.

Phòng Ngừa

Một vài thói quen giúp lỗi này không quay lại:

• Kéo cập nhật hàng tuần: ComfyUI thường xuyên cập nhật định nghĩa node. git pull mỗi tuần giúp bạn luôn đồng bộ và tránh bị lệch phiên bản.
• Sao lưu workflow ổn định: Đừng chỉ dựa vào last_workflow.json. Lưu các setup đang hoạt động dưới dạng file JSON có tên riêng trong một thư mục chuyên dụng.
• Dùng virtual environment: Một môi trường venv hoặc Conda riêng biệt đảm bảo các project Python khác không âm thầm làm hỏng dependency của ComfyUI.

Kiểm Tra Sau Khi Sửa

Khởi động lại ComfyUI, sau đó hard-refresh trình duyệt bằng Ctrl+F5. Tải lại workflow. Một node CLIPTextEncode hoạt động tốt sẽ có header màu xanh lá hoặc tím — không có viền đỏ. Thêm một prompt vào hàng đợi. Nếu console in ra nội dung kiểu Prompt executed in 3.2 seconds, bạn đã xong.