Back to issues
Medium priorityTested by MilanVerified fix

Agent Crashes on Skill Load

OpenClaw starts, logs 'Loading skills...' and then crashes immediately with a module error or syntax failure.

Likely Cause

A skill dependency is broken, a package was installed under the wrong Node.js version, or the skill code is not compatible with the running runtime.

Tags

SkillsCrash

Recovery Steps

  1. 1Set LOG_LEVEL=debug and reproduce the crash.
  2. 2Identify the last skill name logged before exit.
  3. 3Open that skill folder and reinstall its dependencies.
  4. 4Remove and reinstall the skill if the crash persists.
  5. 5Run openclaw doctor to catch any other dependency mismatches.

Still blocked?

If the steps above do not clear it, review the full fixes index or book direct troubleshooting help.