立即可以尝试的解决方案(最常见)
-
结束进程并重试:

- 打开任务管理器(Windows:
Ctrl+Shift+Esc;macOS:Command+Option+Esc)。 - 在“进程”或“应用程序”中,找到所有名为 OpenClaw 或 Clash 的进程,彻底结束它们。
- 重新双击 OpenClaw 图标打开。
- 打开任务管理器(Windows:
-
检查端口冲突: OpenClaw(Clash)的核心服务需要占用特定的端口(如 7890, 7891, 9090 等),如果这些端口被其他程序(如旧版Clash、V2RayN、其它代理工具、某些游戏加速器)占用,就会启动失败。
- 方法一:重启电脑,这能强制释放所有被占用的端口,最简单直接。
- 方法二:在 OpenClaw 的 设置/首选项 中,尝试修改监听端口(例如将 HTTP 端口从 7890 改为 7892,Socks 端口从 7891 改为 7893),保存并重启应用。
第二步:清理环境与配置文件
-
清除应用缓存和残留配置:
- Windows: 打开文件资源管理器,在地址栏输入
%APPDATA%并回车,找到并删除 OpenClaw 或 clash 文件夹,然后重新启动 OpenClaw。 - macOS: 打开 Finder,按
Command+Shift+G,输入~/.config,找到并删除 openclaw 或 clash 文件夹,或者输入/Library/Preferences查找相关文件删除。 - 注意:删除前,如果你有自定义的配置文件(
.yaml),请先备份。
- Windows: 打开文件资源管理器,在地址栏输入
-
检查系统代理/网络设置: 有时系统代理被锁死会导致客户端无法启动。
- Windows: 进入
设置 > 网络和Internet > 代理,确保“使用代理服务器”处于关闭状态(让OpenClaw来管理)。 - macOS: 进入
系统设置 > 网络 > Wi-Fi/以太网 > 详细信息... > 代理,确保所有代理协议都未被勾选。
- Windows: 进入
第三步:检查运行环境
-
确认 Java 环境(如果依赖): 部分版本的 OpenClaw 可能需要 Java 运行环境,打开命令提示符(CMD)或终端,输入:
java -version
如果显示版本信息(如
openjdk version "17.x.x"),则环境正常,如果提示找不到命令,需要去官网安装 Java Runtime Environment。 -
以管理员/root权限运行:
- Windows: 右键点击 OpenClaw 图标,选择“以管理员身份运行”。
- macOS: 通过终端用
sudo命令运行(需谨慎,先尝试其他方法)。
第四步:终极解决方案
-
完全卸载后重新安装:
- 使用系统自带的卸载程序或第三方工具彻底卸载 OpenClaw。
- 删除第一步中提到的所有配置文件夹。
- 从 官方GitHub仓库发布页 或可信渠道下载最新的安装包。
- 右键安装包,选择“以管理员身份运行”(Windows)或直接安装(macOS)。
- 首次运行时,可以尝试右键“以管理员身份运行”。
-
查看错误日志: 如果以上方法都无效,查看日志是定位问题的关键。
- 在 OpenClaw 的界面中寻找“日志”或“Logs”标签页。
- 或者在配置文件所在目录(第一步中提到的路径)查找以
.log结尾的文件。 - 将最近的错误信息复制出来,可以更精确地搜索解决方案或向社区求助。
其他可能情况
- 安全软件拦截:暂时关闭 Windows Defender 实时防护、防火墙或第三方杀毒软件(如360、腾讯电脑管家),再尝试打开。
- 系统兼容性:右键点击程序,选择“属性 > 兼容性”,尝试以兼容模式运行(Windows 8)。
- 版本问题:如果你刚刚更新了系统(如 Windows 大版本更新),可能需要等待 OpenClaw 发布兼容的新版本。
总结排查顺序建议: 重启电脑 → 结束进程并重开 → 清理配置文件夹 → 修改端口 → 检查代理设置 → 重装最新版 → 查看日志
如果问题依旧,请提供以下信息以便进一步分析:
- 你的操作系统版本(如 Windows 11 23H2, macOS Sonoma 14.5)。
- OpenClaw 的具体版本号。
- 执行了上述哪些步骤后有什么具体现象或错误提示(特别是日志中的错误信息)。