先排除杀毒软件和防火墙
上周我在一台 Windows 11 23H2 的办公电脑上装了 OpeClaw 1.4.2，双击桌面图标完全没反应。任务管理器里看了一眼——进程启动了 0.3 秒就被杀掉了。
打开 Windows Defender 的"保护历史记录"，果然看到 OpeClaw.exe 被标记成"可能不需要的应用"然后隔离了。把它加到排除列表，马上就能正常打开。
如果你用的是 360、火绒、卡巴斯基之类的第三方杀毒，也去隔离区看看。有些杀毒软件不会弹窗通知你，直接静默拦截。
缺少运行时组件：.NET 和 VC++
OpeClaw 的 Windows 版依赖 .NET Desktop Runtime 和 Visual C++ Redistributable。如果你的系统是刚装的 Windows 或者做过精简优化，这些组件可能没有。
报错信息通常是一个弹窗，内容类似"The application requires .NET Desktop Runtime 8.0"或者"VCRUNTIME140.dll is missing"。按照弹窗提示的版本号去微软官网下载对应的安装包，装完重启再试。
我在一台用了 LTSC 精简版 Windows 的电脑上就遇到过：装了 .NET 8.0 Desktop Runtime 之后，OpeClaw 立刻就能启动了。
权限问题：右键"以管理员身份运行"
有些公司或学校的电脑对非管理员账户有权限限制。OpeClaw 第一次启动时需要写入配置文件，如果没有写入权限，就会静默启动失败。
右键 OpeClaw 图标 → 选"以管理员身份运行"试一下。如果这样能打开，说明是权限问题。可以在图标属性 → 兼容性 → 勾选"以管理员身份运行此程序"，以后就不用每次右键了。
安装包损坏或不完整
下载中断、网络不稳、用了来源不明的镜像站，都可能导致安装包不完整。这种情况下安装过程可能不报错，但装完的 app 根本跑不起来。
解决办法很简单：回到 OpeClaw 的下载页重新下载一次。下载完成后可以对比一下文件大小，跟下载页标注的大小对得上再安装。
macOS：Gatekeeper 和 Quarantine
macOS 14.5 及以上版本对非 App Store 来源的应用审查更严格。你可能会看到"OpeClaw 已损坏，无法打开"或者"无法验证开发者"的提示。
打开终端，输入 xattr -cr /Applications/OpeClaw.app 然后回车，再重新打开。如果还不行，去系统设置 → 隐私与安全 → 安全性，看看有没有被阻止的应用提示，点"仍要打开"。
我在 macOS 14.5 的 MacBook Air M2 上装 OpeClaw 时就碰到了这个问题，xattr 命令一敲就解决了。
兼容模式：旧系统的最后手段
如果你的 Windows 版本比较旧（Windows 10 1809 以下），OpeClaw 可能不完全兼容。右键图标 → 属性 → 兼容性 → 勾选"以兼容模式运行"→ 选 Windows 10。
不过说实话，如果系统版本太旧，更好的做法是先更新系统。很多运行库和安全补丁也需要较新的系统版本。
清理残留文件后重装
如果上面的方法都没用，可能是之前的安装残留了损坏的配置文件。卸载 OpeClaw 之后，手动删除配置目录再重装：
Windows：按 Win+R 输入 %AppData% 回车，找到 OpeClaw 文件夹删掉。macOS：打开 Finder → 前往 → ~/Library/Application Support/OpeClaw 删掉。然后从下载页重新下载最新版安装。
安装后打不开排查常见问题
OpeClaw 安装完双击没反应怎么办？
先检查是不是被杀毒软件拦了。打开 Windows Defender 或第三方杀毒的隔离区看看有没有 OpeClaw 的文件。如果有，加入白名单后重新打开。
OpeClaw 提示缺少 .NET 或 VC++ 运行库怎么处理？
去微软官网下载对应版本的 .NET Desktop Runtime 和 Visual C++ Redistributable 安装，重启电脑后再打开 OpeClaw。
macOS 上 OpeClaw 显示"已损坏，无法打开"是什么意思？
这是 macOS Gatekeeper 的安全提示。打开终端输入 xattr -cr /Applications/OpeClaw.app 回车，然后重新打开。
重装 OpeClaw 之后还是打不开怎么办？
先删干净残留文件（Windows 查 %AppData%/OpeClaw，macOS 查 ~/Library/Application Support/OpeClaw），再从下载页重新获取最新安装包。