HolaClaw
Download

HolaClaw VM won't boot

If the HolaClaw VM fails to start with a "launchctl bootstrap failed" or "timed out waiting for VF daemon" error, restart your Mac to recover.

2 min read Updated June 1, 2026 TroubleshootingVM

Sometimes the HolaClaw app fails to boot its virtual machine and shows an error like one of these:

VM backend failed to initialize: VM backend error: launchctl bootstrap failed:
Bootstrap failed: 5: Input/output error
	Try re-running the command as root for richer errors.

VM backend failed to initialize: VM backend error: timed out waiting for
VF daemon to start

Both messages come from the same underlying cause: macOS's Virtualization framework is in an unstable state, and the helper daemon that HolaClaw needs to start the VM cannot be brought up.

The fix: restart your Mac

A full restart of macOS resets the Virtualization framework and clears the stuck daemon state:

  1. Quit the HolaClaw app.
  2. Restart your Mac from the Apple menu (Apple menu -> Restart...). A sleep/wake cycle is not enough.
  3. Open HolaClaw again once you're back on the desktop.

The VM should boot normally. Any existing assistants, memory, and channel configuration are preserved — the restart only fixes the macOS side of virtualization, not your VM data.

Why this happens

macOS can leave the Virtualization framework in an inconsistent state after long uptimes or interrupted system events — for example, a restart that didn't go through cleanly because an app blocked it, the Mac waking from sleep into a bad state, or any other situation that leaves the VF daemon half-initialized. HolaClaw uses this framework to run the OpenClaw VM, so when it gets stuck, HolaClaw can't talk to it.

This is a macOS-level issue, not a HolaClaw misconfiguration. There is nothing to reinstall or reset inside HolaClaw.

If a restart doesn't fix it

If the VM still fails to boot after a clean restart:

  • Make sure the Mac actually completed the restart — if an app blocked shutdown, macOS may have cancelled it. Quit any apps with unsaved work and try again.
  • If it still fails, share the exact error message in the HolaClaw Discord along with your macOS version so we can take a look.
Was this page helpful?