--- read_when: - Vous souhaitez utiliser des workflows ComfyUI locaux avec OpenClaw - Vous souhaitez utiliser Comfy Cloud avec des workflows d’image, de vidéo ou de musique - Vous avez besoin des clés de configuration du plugin Comfy intégré. summary: Configuration de la génération d’images, de vidéos et de musique avec les workflows ComfyUI dans OpenClaw title: ComfyUI x-i18n: generated_at: "2026-07-12T03:14:18Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 74150d202a422de8e0f4b2b82d5d12bd42eb46991e8ef688832208e1a2ff7793 source_path: providers/comfy.md workflow: 16 --- OpenClaw inclut un Plugin `comfy` intégré pour exécuter des workflows ComfyUI. Le Plugin repose entièrement sur les workflows : OpenClaw ne transpose pas de contrôles génériques tels que `size`, `aspectRatio`, `resolution`, `durationSeconds` ou des contrôles de type TTS dans votre graphe. | Propriété | Détail | | ------------------ | ------------------------------------------------------------------------------------------ | | Fournisseur | `comfy` | | Modèle | `comfy/workflow` | | Outils partagés | `image_generate`, `video_generate`, `music_generate` | | Authentification | Aucune pour ComfyUI local ; `COMFY_API_KEY` ou `COMFY_CLOUD_API_KEY` pour Comfy Cloud | | API | ComfyUI `/prompt` / `/history` / `/view` ; Comfy Cloud `/api/*` | ## Fonctionnalités prises en charge - Génération et modification d’images à partir d’un workflow JSON (la modification accepte 1 image de référence téléversée) - Génération de vidéos à partir d’un workflow JSON, de texte en vidéo ou d’image en vidéo (1 image de référence) - Génération de musique ou d’audio au moyen de l’outil partagé `music_generate`, avec 1 image de référence facultative - Téléchargement de la sortie depuis un Node configuré, ou depuis tous les Nodes de sortie correspondants lorsqu’aucun n’est configuré ## Prise en main Choisissez entre l’exécution de ComfyUI sur votre propre machine et l’utilisation de Comfy Cloud. **Idéal pour :** exécuter votre propre instance ComfyUI sur votre machine ou votre réseau local. Vérifiez que votre instance ComfyUI locale est en cours d’exécution (adresse par défaut : `http://127.0.0.1:8188`). Exportez ou créez un fichier JSON de workflow ComfyUI. Notez les identifiants des Nodes correspondant au Node d’entrée de l’invite et au Node de sortie depuis lequel OpenClaw doit lire. Définissez `mode: "local"` et indiquez le chemin de votre fichier de workflow. Exemple minimal pour les images : ```json5 { plugins: { entries: { comfy: { config: { mode: "local", baseUrl: "http://127.0.0.1:8188", image: { workflowPath: "./workflows/flux-api.json", promptNodeId: "6", outputNodeId: "9", }, }, }, }, }, } ``` Configurez OpenClaw pour utiliser le modèle `comfy/workflow` pour la fonctionnalité que vous avez configurée : ```json5 { agents: { defaults: { imageGenerationModel: { primary: "comfy/workflow", }, }, }, } ``` ```bash openclaw models list --provider comfy ``` **Idéal pour :** exécuter des workflows sur Comfy Cloud sans gérer de ressources GPU locales. Inscrivez-vous sur [comfy.org](https://comfy.org) et générez une clé API depuis le tableau de bord de votre compte. Fournissez votre clé à l’aide de l’une des méthodes suivantes : ```bash # Onboarding flag openclaw onboard --comfy-api-key "your-key" # Environment variable (preferred for daemons) export COMFY_API_KEY="your-key" # Alternative environment variable export COMFY_CLOUD_API_KEY="your-key" # Or inline in config openclaw config set plugins.entries.comfy.config.apiKey "your-key" ``` Exportez ou créez un fichier JSON de workflow ComfyUI. Notez les identifiants des Nodes correspondant au Node d’entrée de l’invite et au Node de sortie. Définissez `mode: "cloud"` et indiquez le chemin de votre fichier de workflow : ```json5 { plugins: { entries: { comfy: { config: { mode: "cloud", image: { workflowPath: "./workflows/flux-api.json", promptNodeId: "6", outputNodeId: "9", }, }, }, }, }, } ``` En mode cloud, `baseUrl` utilise par défaut `https://cloud.comfy.org`. Définissez `baseUrl` uniquement pour un point de terminaison cloud personnalisé. ```json5 { agents: { defaults: { imageGenerationModel: { primary: "comfy/workflow", }, }, }, } ``` ```bash openclaw models list --provider comfy ``` ## Configuration Comfy prend en charge des paramètres de connexion partagés au niveau supérieur ainsi que des sections de workflow propres à chaque fonctionnalité (`image`, `video`, `music`) : ```json5 { plugins: { entries: { comfy: { config: { mode: "local", baseUrl: "http://127.0.0.1:8188", image: { workflowPath: "./workflows/flux-api.json", promptNodeId: "6", outputNodeId: "9", }, video: { workflowPath: "./workflows/video-api.json", promptNodeId: "12", outputNodeId: "21", }, music: { workflowPath: "./workflows/music-api.json", promptNodeId: "3", outputNodeId: "18", }, }, }, }, }, } ``` ### Clés partagées | Clé | Type | Description | | --------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------- | | `mode` | `"local"` ou `"cloud"` | Mode de connexion. Valeur par défaut : `"local"`. | | `baseUrl` | chaîne | Valeur par défaut : `http://127.0.0.1:8188` en local ou `https://cloud.comfy.org` dans le cloud. | | `apiKey` | chaîne | Clé intégrée facultative, en remplacement des variables d’environnement `COMFY_API_KEY` / `COMFY_CLOUD_API_KEY`. | | `allowPrivateNetwork` | booléen | Autorise une `baseUrl` privée ou sur le réseau local en mode cloud, ou un nom de domaine complet DNS privé local. | En mode `local`, les adresses IP littérales de bouclage ou privées et les noms de service à une seule étiquette tels que `http://comfyui:8188` fonctionnent sans `allowPrivateNetwork`. Les noms de domaine complets DNS privés qui semblent publics, tels que `https://comfy.local.example.com`, nécessitent `allowPrivateNetwork: true`. La confiance accordée à l’origine privée reste limitée au schéma, au nom d’hôte et au port configurés ; les redirections locales ne peuvent pas quitter le nom d’hôte configuré, tandis que les redirections cloud vers des CDN publics sont vérifiées selon la politique SSRF par défaut. ### Clés propres à chaque fonctionnalité Ces clés s’appliquent dans les sections `image`, `video` ou `music` : | Clé | Obligatoire | Valeur par défaut | Description | | ---------------------------- | ----------- | ----------------- | ------------------------------------------------------------------------------------------------ | | `workflow` ou `workflowPath` | Oui | -- | Workflow JSON intégré ou chemin du fichier JSON de workflow ComfyUI. | | `promptNodeId` | Oui | -- | Identifiant du Node qui reçoit l’invite textuelle. | | `promptInputName` | Non | `"text"` | Nom de l’entrée sur le Node d’invite. | | `outputNodeId` | Non | -- | Identifiant du Node depuis lequel lire la sortie. S’il est omis, tous les Nodes de sortie correspondants sont utilisés. | | `pollIntervalMs` | Non | `1500` | Intervalle d’interrogation en millisecondes pour vérifier l’achèvement de la tâche. | | `timeoutMs` | Non | `300000` | Délai d’expiration en millisecondes pour l’exécution du workflow. | Les sections `image` et `video` prennent également en charge un Node d’entrée pour l’image de référence : | Clé | Obligatoire | Valeur par défaut | Description | | --------------------- | ------------------------------------------------ | ----------------- | --------------------------------------------------------------- | | `inputImageNodeId` | Oui (lorsqu’une image de référence est transmise) | -- | Identifiant du Node qui reçoit l’image de référence téléversée. | | `inputImageInputName` | Non | `"image"` | Nom de l’entrée sur le Node d’image. | `apiKey` accepte soit une chaîne littérale, soit un objet de [référence de secret](/fr/gateway/configuration-reference#secrets). ## Détails des workflows Définissez le modèle d’image par défaut sur `comfy/workflow` : ```json5 { agents: { defaults: { imageGenerationModel: { primary: "comfy/workflow", }, }, }, } ``` **Exemple de modification avec une image de référence :** Pour permettre la modification d’une image à l’aide d’une image de référence téléversée, ajoutez `inputImageNodeId` à votre configuration d’image : ```json5 { plugins: { entries: { comfy: { config: { image: { workflowPath: "./workflows/edit-api.json", promptNodeId: "6", inputImageNodeId: "7", inputImageInputName: "image", outputNodeId: "9", }, }, }, }, }, } ``` Définissez le modèle vidéo par défaut sur `comfy/workflow` : ```json5 { agents: { defaults: { videoGenerationModel: { primary: "comfy/workflow", }, }, }, } ``` Les workflows vidéo Comfy prennent en charge la génération de texte en vidéo et d’image en vidéo au moyen du graphe configuré. OpenClaw ne transmet pas de vidéos d’entrée aux workflows Comfy. Seules les invites textuelles et les images de référence uniques sont prises en charge comme entrées. Le Plugin intégré enregistre un fournisseur de génération musicale pour les sorties audio ou musicales définies par un workflow, accessible au moyen de l’outil partagé `music_generate`. Il accepte une image de référence facultative (1 au maximum) : ```text /tool music_generate prompt="Warm ambient synth loop with soft tape texture" ``` Utilisez la section de configuration `music` pour indiquer le fichier JSON de votre workflow audio et le Node de sortie. La configuration d’image existante au niveau supérieur (sans section `image` imbriquée) continue de fonctionner : ```json5 { plugins: { entries: { comfy: { config: { workflowPath: "./workflows/flux-api.json", promptNodeId: "6", outputNodeId: "9", }, }, }, }, } ``` OpenClaw traite cette ancienne structure comme la configuration du workflow d’image. Vous n’avez pas besoin d’effectuer une migration immédiatement, mais les sections imbriquées `image` / `video` / `music` sont recommandées pour les nouvelles installations. Si vous utilisez uniquement la génération d’images, l’ancienne configuration à plat et la nouvelle section `image` imbriquée sont fonctionnellement équivalentes. Une couverture de tests en conditions réelles, activable explicitement, est disponible pour le Plugin intégré : ```bash OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts ``` Le test en conditions réelles ignore les cas individuels d’image, de vidéo ou de musique, sauf si la section correspondante du flux de travail Comfy est configurée. ## Pages connexes Configuration et utilisation de l’outil de génération d’images. Configuration et utilisation de l’outil de génération de vidéos. Configuration de l’outil de génération de musique et de contenu audio. Présentation de tous les fournisseurs et de toutes les références de modèles. Référence complète de la configuration, y compris les valeurs par défaut des agents.