openclaw - 💡(How to fix) Fix [Bug]: [Bug]: Windows: Missing changelog.js causes CLI failure (pi-coding-agent module) [1 comments, 1 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#49418Fetched 2026-04-08 00:55:26
View on GitHub
Comments
1
Participants
1
Timeline
5
Reactions
0
Author
Participants
Timeline (top)
labeled ×2commented ×1mentioned ×1subscribed ×1

After Windows installation, CLI fails to start due to missing changelog.js file in @mariozechner/pi-coding-agent module causing import errors.

Error Message

markdown

编辑

PS C:\Users\123> openclaw gateway start

[openclaw] Failed to start CLI: file:///C:/Users/123/AppData/Local/Programs/OpenClaw/node_modules/@mariozechner/pi-coding-agent/dist/modes/interactive/interactive-mode.js:19 import { getChangelogPath, getNewEntries, parseChangelog } from "../../utils/changelog.js"; ^^^^^^^^^^^^^^^^ SyntaxError: The requested module '../../utils/changelog.js' does not provide an export named 'getChangelogPath' at ModuleJob._instantiate (node:internal/modules/esm/module_job:226:21) at async ModuleJob.run (node:internal/modules/esm/module_job:335:5) at async onImport.tracePromise.proto (node:internal/modules/esm/loader:665:26) File path confirmation: Missing file: C:\Users\123\AppData\Local\Programs\OpenClaw\node_modules@mariozechner\pi-coding-agent\dist\utils\changelog.js Calling file: dist/modes/interactive/interactive-mode.js:19

Root Cause

After Windows installation, CLI fails to start due to missing changelog.js file in @mariozechner/pi-coding-agent module causing import errors.

Fix Action

Fix / Workaround

Temporary workaround: CLI works normally after manually creating a stub changelog.js file with the required export functions.

Code Example

markdown

编辑




PS C:\Users\123> openclaw gateway start

[openclaw] Failed to start CLI: file:///C:/Users/123/AppData/Local/Programs/OpenClaw/node_modules/@mariozechner/pi-coding-agent/dist/modes/interactive/interactive-mode.js:19
import { getChangelogPath, getNewEntries, parseChangelog } from "../../utils/changelog.js";
         ^^^^^^^^^^^^^^^^
SyntaxError: The requested module '../../utils/changelog.js' does not provide an export named 'getChangelogPath'
    at ModuleJob._instantiate (node:internal/modules/esm/module_job:226:21)
    at async ModuleJob.run (node:internal/modules/esm/module_job:335:5)
    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:665:26)
File path confirmation:
Missing file: C:\Users\123\AppData\Local\Programs\OpenClaw\node_modules\@mariozechner\pi-coding-agent\dist\utils\changelog.js
Calling file: dist/modes/interactive/interactive-mode.js:19
RAW_BUFFERClick to expand / collapse

Bug type

Regression (worked before, now fails)

Summary

After Windows installation, CLI fails to start due to missing changelog.js file in @mariozechner/pi-coding-agent module causing import errors.

Steps to reproduce

  1. Install OpenClaw 2026.3.13 on Windows 11 using the official installer
  2. Open PowerShell and run any CLI command: openclaw --version or openclaw gateway start
  3. CLI crashes with module import error

Expected behavior

CLI commands should execute normally, and the gateway service should start successfully and be connectable.

Actual behavior

CLI fails to start with SyntaxError:

OpenClaw version

2026.3.13 (f6e5b67)

Operating system

Windows 11

Install method

Official Windows installer

Model

N/A (CLI fails before model initialization)

Provider / routing chain

N/A (CLI cannot start)

Config file / key location

C:\Users\123.openclaw\openclaw.json

Additional provider/model setup details

N/A - This issue occurs during CLI initialization, before any model or provider configuration is loaded.

Logs, screenshots, and evidence

markdown

编辑




PS C:\Users\123> openclaw gateway start

[openclaw] Failed to start CLI: file:///C:/Users/123/AppData/Local/Programs/OpenClaw/node_modules/@mariozechner/pi-coding-agent/dist/modes/interactive/interactive-mode.js:19
import { getChangelogPath, getNewEntries, parseChangelog } from "../../utils/changelog.js";
         ^^^^^^^^^^^^^^^^
SyntaxError: The requested module '../../utils/changelog.js' does not provide an export named 'getChangelogPath'
    at ModuleJob._instantiate (node:internal/modules/esm/module_job:226:21)
    at async ModuleJob.run (node:internal/modules/esm/module_job:335:5)
    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:665:26)
File path confirmation:
Missing file: C:\Users\123\AppData\Local\Programs\OpenClaw\node_modules\@mariozechner\pi-coding-agent\dist\utils\changelog.js
Calling file: dist/modes/interactive/interactive-mode.js:19

Impact and severity

No response

Additional information

Temporary workaround: CLI works normally after manually creating a stub changelog.js file with the required export functions.

Possible cause: The changelog.js file is not included in the published version of the @mariozechner/pi-coding-agent package, or the file does not properly export the required functions.

Suggested fix:

  1. Add changelog.js to the package's files field
  2. Ensure the following functions are exported: getChangelogPath, getNewEntries, parseChangelog, getLatestVersion, getChangelog
  3. Add Windows installation testing to CI pipeline

Last known good version: Unknown (issue present on first installation)

extent analysis

Fix Plan

To resolve the issue, follow these steps:

  • Update the @mariozechner/pi-coding-agent package to include the missing changelog.js file.
  • Ensure the changelog.js file exports the required functions:
    • getChangelogPath
    • getNewEntries
    • parseChangelog
    • getLatestVersion
    • getChangelog
  • Example changelog.js file:
// utils/changelog.js
export function getChangelogPath() {
  // implementation
}

export function getNewEntries() {
  // implementation
}

export function parseChangelog() {
  // implementation
}

export function getLatestVersion() {
  // implementation
}

export function getChangelog() {
  // implementation
}
  • Update the package's files field in package.json to include changelog.js:
// package.json
"files": [
  "dist",
  "utils/changelog.js"
]
  • Add Windows installation testing to the CI pipeline to prevent similar issues in the future.

Verification

To verify the fix, install the updated @mariozechner/pi-coding-agent package and run the OpenClaw CLI commands. The CLI should start successfully, and the gateway service should be connectable.

Extra Tips

  • Ensure that the changelog.js file is properly committed and included in the package's repository.
  • Consider adding automated tests for the changelog.js file to prevent regressions.
  • Review the CI pipeline configuration to ensure that Windows installation testing is properly integrated and executed.

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

CLI commands should execute normally, and the gateway service should start successfully and be connectable.

Still need to ship something?

×6

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

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix [Bug]: [Bug]: Windows: Missing changelog.js causes CLI failure (pi-coding-agent module) [1 comments, 1 participants]