openclaw - 💡(How to fix) Fix [Bug]: Windows 关于 [email protected] 版本在安装时报错:Error [ERR_UNSUPPORTED_ESM_URL_SCHEME] [4 comments, 5 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#61836Fetched 2026-04-08 02:53:48
View on GitHub
Comments
4
Participants
5
Timeline
7
Reactions
5
Author
Timeline (top)
commented ×4labeled ×2closed ×1

在 Windows 上执行安装脚本,配置好模型后到下一步时报错:Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]。

Error Message

在 Windows 上执行安装脚本,配置好模型后到下一步时报错:Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]。 在 Windows 上安装 OpenClaw,执行默认安装脚本 iwr -useb https://openclaw.ai/install.ps1 | iex,配置好模型后到下一步时报错:Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. On Windows, absolute paths must be valid file:// URLs. Received protocol 'c:' 安装过程中,配置好模型后到下一步时报错:Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. On Windows, absolute paths must be valid file:// URLs. Received protocol 'c:'

Root Cause

在 Windows 上执行安装脚本,配置好模型后到下一步时报错:Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]。

RAW_BUFFERClick to expand / collapse

Bug type

Regression (worked before, now fails)

Beta release blocker

No

Summary

在 Windows 上执行安装脚本,配置好模型后到下一步时报错:Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]。

Steps to reproduce

我的环境:

Node.js 版本:v24.14.1 OpenClaw 版本(主要原因):v2026.4.5 操作系统:Windows 11 x64 25H5

错误信息: 在 Windows 上安装 OpenClaw,执行默认安装脚本 iwr -useb https://openclaw.ai/install.ps1 | iex,配置好模型后到下一步时报错:Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. On Windows, absolute paths must be valid file:// URLs. Received protocol 'c:'

Expected behavior

安装应该继续,而不是报错崩溃。

Actual behavior

安装过程中,配置好模型后到下一步时报错:Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. On Windows, absolute paths must be valid file:// URLs. Received protocol 'c:'

OpenClaw version

[email protected]

Operating system

Windows 11 x64 25H5

Install method

以管理员身份运行 PowerShell 执行 iwr -useb https://openclaw.ai/install.ps1 | iex 命令

Model

MiniMax-M2.5

Provider / routing chain

openclaw

Additional provider/model setup details

No response

Logs, screenshots, and evidence

Impact and severity

受影响:新安装 OpenClaw 的 Windows 用户(默认使用了 [email protected] 版本)

Additional information

临时解决方案:从 [email protected] 降级到 [email protected] 可正常工作

  1. npm -g uninstall openclaw
  2. npm -g install [email protected]
  3. openclaw onboard --install-daemon
  4. openclaw gateway --port 18789 --verbose

extent analysis

TL;DR

Downgrade OpenClaw from version 2026.4.5 to 2026.4.2 to resolve the Error [ERR_UNSUPPORTED_ESM_URL_SCHEME] issue.

Guidance

  • The error is caused by an unsupported URL scheme in the default ESM loader, which can be resolved by downgrading OpenClaw.
  • To verify the fix, run the installation script again after downgrading OpenClaw and check if the installation proceeds without errors.
  • To mitigate the issue, avoid using absolute paths with the 'c:' protocol and instead use valid file:// URLs.
  • Consider reporting the issue to the OpenClaw developers to ensure a permanent fix is implemented in future versions.

Example

No code snippet is provided as the issue is resolved through version downgrading.

Notes

The provided solution is a temporary workaround, and a permanent fix should be implemented by the OpenClaw developers.

Recommendation

Apply workaround: Downgrade to OpenClaw version 2026.4.2, as it is a known working version that resolves the Error [ERR_UNSUPPORTED_ESM_URL_SCHEME] issue.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

安装应该继续,而不是报错崩溃。

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING