@openclaw/comfy-provider 2026.9.3 → 2026.9.5

package/assets/activity.svg

@@ -0,0 +1,32 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+<!--
+Adapted from OpenClaw ui/public/provider-icons/ProviderIcon-comfy.svg.
+Source: @lobehub/icons-static-svg@1.94.0, comfyui.svg
+https://www.npmjs.com/package/@lobehub/icons-static-svg/v/1.94.0
+https://github.com/lobehub/lobe-icons
+
+MIT License
+Copyright (c) 2023 LobeHub
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Names and marks remain the property of their respective owners.
+-->
+  <path fill="currentColor" fill-rule="evenodd" stroke="none" d="M5.485 23.76c-.568 0-1.026-.207-1.325-.598-.307-.402-.387-.964-.22-1.54l.672-2.315a.605.605 0 00-.1-.536.622.622 0 00-.494-.243H2.085c-.568 0-1.026-.207-1.325-.598-.307-.403-.387-.964-.22-1.54l2.31-7.917.255-.87c.343-1.18 1.592-2.14 2.786-2.14h2.313c.276 0 .519-.18.595-.442l.764-2.633C9.906 1.208 11.155.249 12.35.249l4.945-.008h3.62c.568 0 1.027.206 1.325.597.307.402.387.964.22 1.54l-1.035 3.566c-.343 1.178-1.593 2.137-2.787 2.137l-4.956.01H11.37a.618.618 0 00-.594.441l-1.928 6.604a.605.605 0 00.1.537c.118.153.3.243.495.243l3.275-.006h3.61c.568 0 1.026.206 1.325.598.307.402.387.964.22 1.54l-1.036 3.565c-.342 1.179-1.592 2.138-2.786 2.138l-4.957.01h-3.61z" />
+</svg>

package/dist/workflow-runtime.js

@@ -28,9 +28,15 @@ function readConfigInteger(config, key) {
 }
 function getComfyConfig(cfg) {
 	const pluginConfig = cfg?.plugins?.entries?.comfy?.config;
-	if (isRecord(pluginConfig)) return pluginConfig;
+	if (isRecord(pluginConfig)) return {
+		config: pluginConfig,
+		path: "plugins.entries.comfy.config"
+	};
 	const legacyConfig = cfg?.models?.providers?.comfy;
-	return isRecord(legacyConfig) ? legacyConfig : {};
+	return {
+		config: isRecord(legacyConfig) ? legacyConfig : {},
+		path: "models.providers.comfy"
+	};
 }
 function stripNestedCapabilityConfig(config) {
 	const next = { ...config };
@@ -110,22 +116,11 @@ function setWorkflowInput(params) {
 	if (!isRecord(inputs)) throw new Error(`Comfy workflow node "${params.nodeId}" is missing an inputs object`);
 	inputs[params.inputName] = params.value;
 }
-async function resolveComfyHeadersConfig(value, cfg) {
+async function resolveComfyHeadersConfig(value, cfg, configPath) {
 	const headers = new Headers();
 	if (!isRecord(value)) return headers;
 	for (const [name, headerValue] of Object.entries(value)) {
-		const path = `plugins.entries.comfy.config.headers.${name}`;
-		const inspected = resolveSecretInputString({
-			value: headerValue,
-			path,
-			defaults: cfg.secrets?.defaults,
-			mode: "inspect"
-		});
-		if (inspected.status === "available") {
-			headers.set(name, inspected.value);
-			continue;
-		}
-		if (inspected.status === "missing") continue;
+		const path = `${configPath}.headers[${JSON.stringify(name)}]`;
 		const resolved = await resolveConfiguredSecretInputString({
 			config: cfg,
 			env: process.env,
@@ -217,49 +212,32 @@ function extractHistoryEntry(history, promptId) {
 	if (isRecord(nested)) return nested;
 	return null;
 }
-async function waitForLocalHistory(params) {
-	const deadline = Date.now() + params.timeoutMs;
-	for (;;) {
-		const requestTimeoutMs = resolveComfyRemainingMs(deadline, params.timeoutMs);
-		const entry = extractHistoryEntry(await readJsonResponse({
-			url: `${params.baseUrl}/history/${params.promptId}`,
-			init: {
-				method: "GET",
-				headers: params.headers
-			},
-			timeoutMs: requestTimeoutMs,
-			policy: params.policy,
-			dispatcherPolicy: params.dispatcherPolicy,
-			auditContext: "comfy-history",
-			errorPrefix: "Comfy history lookup failed"
-		}), params.promptId);
-		if (entry?.outputs && Object.keys(entry.outputs).length > 0) return entry;
-		const pollDelayMs = resolveComfyRemainingMs(deadline, params.timeoutMs, params.pollIntervalMs);
-		await new Promise((resolve) => {
-			setTimeout(resolve, pollDelayMs);
-		});
-	}
-}
-async function waitForCloudCompletion(params) {
+async function waitForComfyHistory(params) {
 	const deadline = Date.now() + params.timeoutMs;
+	const read = (path, kind, timeoutMs) => readJsonResponse({
+		url: `${params.baseUrl}${path}`,
+		init: {
+			method: "GET",
+			headers: params.headers
+		},
+		timeoutMs,
+		policy: params.policy,
+		dispatcherPolicy: params.dispatcherPolicy,
+		auditContext: `comfy-${kind}`,
+		errorPrefix: `Comfy ${kind} lookup failed`
+	});
 	for (;;) {
 		const requestTimeoutMs = resolveComfyRemainingMs(deadline, params.timeoutMs);
-		const status = await readJsonResponse({
-			url: `${params.baseUrl}/api/job/${params.promptId}/status`,
-			init: {
-				method: "GET",
-				headers: params.headers
-			},
-			timeoutMs: requestTimeoutMs,
-			policy: params.policy,
-			dispatcherPolicy: params.dispatcherPolicy,
-			auditContext: "comfy-status",
-			errorPrefix: "Comfy status lookup failed"
-		});
-		if (status.status === "completed") return;
-		if (status.status === "failed" || status.status === "cancelled") {
-			const detail = redactProviderResponseErrorText(status.error ?? status.message ?? params.promptId, params.headers);
-			throw new Error(`Comfy workflow ${status.status}: ${detail}`);
+		if (params.mode === "cloud") {
+			const status = await read(`/api/job/${params.promptId}/status`, "status", requestTimeoutMs);
+			if (status.status === "completed") return await read(`/api/history_v2/${params.promptId}`, "history", params.timeoutMs);
+			if (status.status === "failed" || status.status === "cancelled") {
+				const detail = redactProviderResponseErrorText(status.error ?? status.message ?? params.promptId, params.headers);
+				throw new Error(`Comfy workflow ${status.status}: ${detail}`);
+			}
+		} else {
+			const entry = extractHistoryEntry(await read(`/history/${params.promptId}`, "history", requestTimeoutMs), params.promptId);
+			if (entry?.outputs && Object.keys(entry.outputs).length > 0) return entry;
 		}
 		const pollDelayMs = resolveComfyRemainingMs(deadline, params.timeoutMs, params.pollIntervalMs);
 		await new Promise((resolve) => {
@@ -355,7 +333,8 @@ function hasUnavailableComfyHeaderSecret(value, cfg) {
 	});
 }
 function isComfyCapabilityConfigured(params) {
-	const capabilityConfig = getComfyCapabilityConfig(getComfyConfig(params.cfg), params.capability);
+	const { config } = getComfyConfig(params.cfg);
+	const capabilityConfig = getComfyCapabilityConfig(config, params.capability);
 	const hasWorkflow = Boolean(resolveComfyWorkflowSource(capabilityConfig).workflow || normalizeOptionalString(capabilityConfig.workflowPath));
 	const hasPromptNode = Boolean(normalizeOptionalString(capabilityConfig.promptNodeId));
 	if (!hasWorkflow || !hasPromptNode) return false;
@@ -371,7 +350,8 @@ function isComfyCapabilityConfigured(params) {
 	});
 }
 async function runComfyWorkflow(params) {
-	const capabilityConfig = getComfyCapabilityConfig(getComfyConfig(params.cfg), params.capability);
+	const { config, path: configPath } = getComfyConfig(params.cfg);
+	const capabilityConfig = getComfyCapabilityConfig(config, params.capability);
 	const mode = resolveComfyMode(capabilityConfig);
 	const workflow = await loadComfyWorkflow(capabilityConfig);
 	const promptNodeId = getRequiredConfigString(capabilityConfig, "promptNodeId");
@@ -413,7 +393,7 @@ async function runComfyWorkflow(params) {
 		baseUrl: normalizeOptionalString(capabilityConfig.baseUrl),
 		defaultBaseUrl: mode === "cloud" ? DEFAULT_COMFY_CLOUD_BASE_URL : DEFAULT_COMFY_LOCAL_BASE_URL,
 		allowPrivateNetwork: mode === "local" || explicitAllowPrivateNetwork,
-		headers: await resolveComfyHeadersConfig(capabilityConfig.headers, params.cfg),
+		headers: await resolveComfyHeadersConfig(capabilityConfig.headers, params.cfg, configPath),
 		defaultHeaders: mode === "cloud" ? {
 			"X-API-Key": resolvedAuth?.apiKey ?? "",
 			"Content-Type": "application/json"
@@ -466,36 +446,15 @@ async function runComfyWorkflow(params) {
 	});
 	const promptId = normalizeOptionalString(promptResponse.prompt_id);
 	if (!promptId) throw new Error("Comfy workflow submit response missing prompt_id");
-	const historyEntry = extractHistoryEntry(mode === "cloud" ? await (async () => {
-		await waitForCloudCompletion({
-			baseUrl: normalizedBaseUrl,
-			promptId,
-			headers: new Headers(headers),
-			timeoutMs,
-			pollIntervalMs,
-			policy: networkPolicy.apiPolicy,
-			dispatcherPolicy
-		});
-		return await readJsonResponse({
-			url: `${normalizedBaseUrl}/api/history_v2/${promptId}`,
-			init: {
-				method: "GET",
-				headers: new Headers(headers)
-			},
-			timeoutMs,
-			policy: networkPolicy.apiPolicy,
-			dispatcherPolicy,
-			auditContext: "comfy-history",
-			errorPrefix: "Comfy history lookup failed"
-		});
-	})() : await waitForLocalHistory({
+	const historyEntry = extractHistoryEntry(await waitForComfyHistory({
 		baseUrl: normalizedBaseUrl,
 		promptId,
 		headers: new Headers(headers),
 		timeoutMs,
 		pollIntervalMs,
 		policy: networkPolicy.apiPolicy,
-		dispatcherPolicy
+		dispatcherPolicy,
+		mode
 	}), promptId);
 	if (!historyEntry) throw new Error(`Comfy history response missing outputs for prompt ${promptId}`);
 	const outputFiles = collectOutputFiles({

package/openclaw.plugin.json

@@ -1,5 +1,6 @@
 {
   "id": "comfy",
+  "categories": ["media"],
   "activation": {
     "onStartup": false
   },
@@ -184,6 +185,54 @@
       ]
     }
   },
+  "configGroups": [
+    {
+      "id": "comfy-connection",
+      "title": "Comfy connection",
+      "order": 10,
+      "properties": ["mode", "baseUrl", "apiKey", "allowPrivateNetwork", "headers"]
+    },
+    {
+      "id": "shared-workflow",
+      "title": "Shared workflow",
+      "order": 20,
+      "properties": [
+        "workflowPath",
+        "workflow",
+        "promptNodeId",
+        "promptInputName",
+        "seedNodeId",
+        "seedInputName",
+        "inputImageNodeId",
+        "inputImageInputName",
+        "outputNodeId"
+      ]
+    },
+    {
+      "id": "image-workflow",
+      "title": "Image workflow",
+      "order": 30,
+      "properties": ["image"]
+    },
+    {
+      "id": "video-workflow",
+      "title": "Video workflow",
+      "order": 40,
+      "properties": ["video"]
+    },
+    {
+      "id": "music-workflow",
+      "title": "Music workflow",
+      "order": 50,
+      "properties": ["music"]
+    },
+    {
+      "id": "execution-limits",
+      "title": "Execution limits",
+      "order": 60,
+      "properties": ["pollIntervalMs", "timeoutMs"]
+    }
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/comfy-provider",
-  "version": "2026.9.3",
+  "version": "2026.9.5",
   "description": "OpenClaw ComfyUI provider plugin.",
   "repository": {
     "type": "git",
@@ -18,10 +18,10 @@
       "minHostVersion": ">=2026.7.2"
     },
     "compat": {
-      "pluginApi": ">=2026.9.3"
+      "pluginApi": ">=2026.9.5"
     },
     "build": {
-      "openclawVersion": "2026.9.3",
+      "openclawVersion": "2026.9.5",
       "bundledDist": false
     },
     "release": {
@@ -35,10 +35,12 @@
   "files": [
     "dist/**",
     "openclaw.plugin.json",
-    "README.md"
+    "README.md",
+    "assets/icon.png",
+    "assets/activity.svg"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.9.3"
+    "openclaw": ">=2026.9.5"
   },
   "peerDependenciesMeta": {
     "openclaw": {