Rule out antivirus and firewall interference
Last week I installed OpeClaw 1.4.2 on a Windows 11 23H2 office PC. Double-clicked the desktop icon — absolutely nothing happened. Checked Task Manager and saw the process spawn for 0.3 seconds before being killed.
Opened Windows Defender's "Protection history" and found OpeClaw.exe flagged as a "Potentially Unwanted App" and quarantined. Added it to the exclusion list, and it opened immediately.
If you're using a third-party antivirus like Norton, Kaspersky, or Bitdefender, check their quarantine or blocked apps list. Some antivirus tools silently intercept without showing any notification.
Missing runtime: .NET and Visual C++
OpeClaw's Windows build requires .NET Desktop Runtime and Visual C++ Redistributable. If your system is a fresh Windows install or a slimmed-down version, these components might be missing.
The error message is typically a popup saying something like "The application requires .NET Desktop Runtime 8.0" or "VCRUNTIME140.dll is missing." Download the exact version mentioned from Microsoft's official site, install it, restart, and try again.
On an LTSC slimmed-down Windows machine, I hit this exact issue. Installing .NET 8.0 Desktop Runtime was all it took — OpeClaw launched on the next attempt.
Permission issues: try "Run as administrator"
Corporate and school computers often restrict non-admin accounts. OpeClaw needs to write config files on first launch — without write permission, it fails silently.
Right-click the OpeClaw icon → "Run as administrator." If it opens this way, the issue is confirmed as permissions. Go to the icon's Properties → Compatibility → check "Run this program as an administrator" to make it permanent.
Corrupted or incomplete installer
Downloads interrupted by unstable connections, or installers grabbed from unofficial mirrors, can result in incomplete installations. The install process might not show errors, but the app won't start.
The fix is straightforward: go back to the OpeClaw download page and re-download. After downloading, compare the file size with what's listed on the download page before installing.
macOS: Gatekeeper and quarantine flags
macOS 14.5 and later are stricter about apps from outside the App Store. You might see "OpeClaw is damaged and can't be opened" or "OpeClaw can't be opened because the developer cannot be verified."
Open Terminal and type: xattr -cr /Applications/OpeClaw.app then press Enter. Try opening OpeClaw again. If it still doesn't work, go to System Settings → Privacy & Security → Security and look for a blocked app prompt — click "Open Anyway."
I hit this on a MacBook Air M2 running macOS 14.5. The xattr command fixed it in seconds.
Compatibility mode: last resort for older systems
If you're on an older Windows version (pre-Windows 10 1809), OpeClaw may not be fully compatible. Right-click → Properties → Compatibility → check "Run in compatibility mode" → select Windows 10.
Honestly though, if your OS is that outdated, updating your system is the better move. Many runtime dependencies and security patches also require newer OS versions.
Clean reinstall: remove leftover config files
If nothing above works, corrupted config files from a previous install might be the problem. After uninstalling OpeClaw, manually delete the config directories before reinstalling:
Windows: press Win+R, type %AppData%, find the OpeClaw folder and delete it. macOS: open Finder → Go → ~/Library/Application Support/OpeClaw and delete it. Then download the latest version from the download page and install fresh.
Won't Open After Install FAQ
I double-click OpeClaw and nothing happens — what should I check?
Check your antivirus quarantine first. Windows Defender or third-party antivirus might have silently blocked OpeClaw.exe. Add it to the exclusion list and try again.
OpeClaw says ".NET Runtime" or "VCRUNTIME140.dll" is missing — how to fix?
Download the required .NET Desktop Runtime and Visual C++ Redistributable from Microsoft's official site, install them, restart your PC, then launch OpeClaw.
macOS says OpeClaw is "damaged and can't be opened" — what does that mean?
That's macOS Gatekeeper blocking unsigned apps. Open Terminal and run: xattr -cr /Applications/OpeClaw.app then try opening it again.
I reinstalled OpeClaw but it still won't open — now what?
Delete leftover config files first. On Windows check %AppData%/OpeClaw, on macOS check ~/Library/Application Support/OpeClaw. Remove those folders, then download a fresh installer from the download page.
Use this with an OpeClaw workflow
Check the current OpeClaw download status first, then save this guide as part of your setup, review, or troubleshooting workflow.