Fixing ECONNREFUSED on localhost:3000
The most common error in OpenClaw setup. Usually caused by port conflicts, incorrect Windows path escaping, or service binding issues.
Automated Diagnostic
Diagnose (read-only)
npx clawkit-doctor@latestScans 11 items. No changes made.
Diagnose + Auto-fix
npx clawkit-doctor@latest --fixAuto-repairs: align tokens, remove stale locks, fix permissions.
Read-Only by Default
Only modifies files with --fix flag.
No Data Upload
Everything stays on your machine.
Open Source
100% transparent. Inspect the code on npm.
1. Update Node.js Version
OpenClaw requires Node 18+. If you are on an older version, the local server may fail to bind to the port correctly. Use nvm install 20 to update instantly.
2. Host Binding Issues
Windows handles 0.0.0.0 differently than Unix. Try changing your host to 127.0.0.1in your configuration. Use our Config Wizard to generate valid path strings.
Still having trouble?
Our Config Wizard generates strict JSON that prevents path escaping errors and port conflicts automatically.
ClawKit is a community-driven initiative for OpenClaw reliability.