ComfyUI-OpenClaw/docs/deploy/windows.md

Windows Deployment Notes

Running ComfyUI + OpenClaw on Windows, especially with the Portable version.

Environment Variables

Portable Version (run_nvidia_gpu.bat)

To set OpenClaw security tokens in the portable version, edit your run_nvidia_gpu.bat (or create a wrapper run_openclaw.bat):

@echo off
:: Security Tokens
set OPENCLAW_ADMIN_TOKEN=my-secret-token
set OPENCLAW_ALLOW_REMOTE_ADMIN=1
set OPENCLAW_OBSERVABILITY_TOKEN=observability-token
set OPENCLAW_LOG_TRUNCATE_ON_START=1

:: Run ComfyUI
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build
pause

PowerShell

$env:OPENCLAW_ADMIN_TOKEN="my-secret-token"
$env:OPENCLAW_ALLOW_REMOTE_ADMIN="1"
$env:OPENCLAW_LOG_TRUNCATE_ON_START="1"
./python_embeded/python.exe -s ComfyUI/main.py

LAN / Mobile Remote Admin Startup

If you want to open the standalone remote admin page from another device in your LAN:

$env:OPENCLAW_ADMIN_TOKEN="my-secret-token"
$env:OPENCLAW_ALLOW_REMOTE_ADMIN="1"
$env:OPENCLAW_LOG_TRUNCATE_ON_START="1"
./python_embeded/python.exe -s ComfyUI/main.py --listen 0.0.0.0 --port 8188

Then open from phone/tablet browser:

http://<WINDOWS_LAN_IP>:8188/openclaw/admin

Find your LAN IP:

ipconfig

Service Mode (NSSM)

If you want to run ComfyUI as a background service, use NSSM (Non-Sucking Service Manager).

1. Download NSSM.
2. nssm install ComfyUI
3. Application: Path to python.exe (or bat file).
4. Environment: Add tokens here in the Environment tab (Input: KEY=VALUE per line).
5. I/O: Redirect stdout/stderr to logs so you can debug startup issues.

Caveats

• Permissions: Services run as SYSTEM by default. It is safer to create a dedicated user and set the service to Log On as that user.
• GPU Access: Ensure the user running the service has access to the GPU driver context (usually fine for logged-in users, tricky for headless services).

Common Startup Failure: WinError 10013

Symptom:

PermissionError: [WinError 10013] ... bind on address ('0.0.0.0', 8188)

Typical causes:

• Port is already occupied by another process.
• Firewall/security policy blocks this bind.
• Reserved/excluded port range on Windows.

Deterministic remediation:

1. Retry with another port (for example --port 8200).
2. Ensure no duplicate ComfyUI instance is already listening.
3. Verify inbound firewall rule allows the selected port for LocalSubnet.
4. If still failing, check excluded ranges and avoid those ports:

netsh int ipv4 show excludedportrange protocol=tcp