---
title: "HolaClaw VM won't boot"
description: "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."
updated: 2026-06-01
canonical: https://holaclaw.ai/docs/more/vm-wont-boot
---

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](https://discord.gg/FbxAbS5sGQ) along with your macOS version so we can take a look.

## Related

- [Access the HolaClaw virtual machine](/docs/advanced/access-the-virtual-machine) — for advanced users who need to inspect the VM directly after it's back up.