Skip to content

[Bug][Core] OpenClaw runtime fails to start on Windows (Path not found), causing Controller WS loop #1134

@shangxinyu1

Description

@shangxinyu1

Environment

Platform: Windows
Version: 0.1.12-nightly.20260416
Component: OpenClaw Runtime / Controller Orchestrator

Steps to Reproduce

  1. Launch Nexu Desktop on Windows.
  2. Open the nexu local cold-start control room dashboard.
  3. Observe the status of the OpenClaw and Controller components.

Actual Behavior

  • The OpenClaw component remains in a STOPPED state.
  • The Controller is RUNNING (e.g., bound to port 50800), but is completely non-functional. It is stuck in an infinite loop: openclaw_ws_connecting -> openclaw_ws_error.
  • The Controller stderr outputs garbled text: ϵͳÕҲ»µ½Ö¸¶¨µÄ·¾¶, which is GBK encoding for "系统找不到指定的路径" (The system cannot find the path specified).
  • openclaw-2026-04-16.log shows: WARNING: could not find openclaw global installation, symlink not created.

Expected Behavior

  • The orchestrator should correctly resolve the executable paths for the OpenClaw runtime unit on Windows (handling \\ vs / and spaces in paths correctly).
  • If OpenClaw fails to start, the Controller should not silently hang in a WS loop, but rather surface a clear "Engine missing/failed to start" error to the frontend UI.

Impact

Severity: P0 (Critical)

  • Core engine fails to start on Windows.
  • Completely blocks users from using the agent.
  • Garbled GBK logs make debugging extremely difficult for average users.

Root Cause Speculation

  1. Path Resolution Bug on Windows: The spawn/exec command for OpenClaw in the orchestrator is likely passing an invalid path (e.g., missing quotes around C:\Users\Amy\AppData\Local\Programs\... or incorrect binary extension like missing .exe or .cmd).
  2. Antivirus/Defender Isolation: Windows Defender might have quarantined the OpenClaw binary during the nightly update.
  3. Missing Symlink Logic: The script relies on a global symlink that fails to create on Windows due to strict permission requirements (requires Admin for symlinks on older Windows versions).

Screenshots

Image Image

Metadata

Metadata

Assignees

Labels

bugSomething isn't workingpriority:p0P0-critical: Blocking users, must fix immediately

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions