Ubuntu 24.04 默认的 Chromium 为 snap 沙箱包，其严格的权限隔离会阻止 OpenClaw 拉起带窗口的浏览器进程；即使手动安装了 Google Chrome，若未配置系统环境变量，终端也无法直接调用浏览器命令，导致 OpenClaw 无法找到可执行文件路径。

browser.headless 配置被意外设为 true，浏览器仅在后台以无头模式运行，不渲染任何窗口界面，这是 “进程正常但无窗口” 的最常见诱因。

浏览器配置目录存在残留锁文件，导致 OpenClaw 无法正常初始化窗口实例，仅能维持后台进程运行。

1. 验证浏览器是否安装：在应用菜单搜索 “Google Chrome”，确认图标存在（如图所示）。
2. 获取浏览器可执行路径，终端执行： 正常输出应为 /usr/bin/google-chrome，若为空则说明未正确配置环境变量，可手动创建软链接：

   sudo ln -s /usr/bin/google-chrome-stable /usr/bin/google-chrome
   

将 Chrome 路径写入 OpenClaw 配置，关闭无头模式并添加沙箱兼容参数：

# 设置浏览器可执行路径
openclaw config set browser.executablePath /usr/bin/google-chrome
# 关闭无头模式，启用窗口显示
openclaw config set browser.headless false
# 添加无沙箱参数，兼容 Ubuntu 权限限制
openclaw config set browser.noSandbox true

# 重启 OpenClaw 网关，使配置生效
openclaw gateway restart
# 执行诊断命令，确认所有检测项正常
openclaw browser --browser-profile openclaw doctor
# 测试打开网页，验证窗口是否弹出
openclaw browser --browser-profile openclaw open https://baidu.com

若上述方法仍无法弹出窗口，可手动启动带调试端口的 Chrome，再让 OpenClaw 接管：

1. 终端执行启动命令：

   google-chrome --no-sandbox --remote-debugging-port=18800
   

2. 保持该终端窗口运行，新开终端执行 OpenClaw 命令，即可自动接管已启动的浏览器窗口。

1. 优先使用 deb 版 Chrome，避免 snap 包限制：snap 包的沙箱机制会频繁导致自动化工具的窗口拉起失败，建议直接安装官方 deb 版 Chrome。
2. 避免误改无头模式配置：OpenClaw 升级或重置配置时，可能会将 headless 重置为 true，遇到窗口不显示问题时，优先检查该配置项。
3. 配置文件锁清理：若问题反复出现，可删除 ~/.config/openclaw/browser/ 目录下的锁文件（SingletonLock 等），再重启网关。
4. 命令行工具路径验证：修改配置后，务必通过 which 命令验证浏览器可执行路径，避免因软链接失效导致的调用失败。

将以下命令复制到终端执行，自动完成配置修改、网关重启与验证：

#!/bin/bash
# OpenClaw 浏览器窗口问题一键修复脚本

# 1. 配置浏览器路径与参数
openclaw config set browser.executablePath /usr/bin/google-chrome
openclaw config set browser.headless false
openclaw config set browser.noSandbox true

# 2. 重启网关
openclaw gateway restart

# 3. 验证配置
echo "正在执行浏览器诊断..."
openclaw browser --browser-profile openclaw doctor

# 4. 测试打开网页
echo "正在测试打开百度..."
openclaw browser --browser-profile openclaw open https://baidu.com

保存为 fix-openclaw-browser.sh，执行 chmod +x fix-openclaw-browser.sh && ./fix-openclaw-browser.sh 即可完成全部操作。

需要我帮你把这篇博客改成 Markdown 格式，方便直接复制到你的笔记或博客平台吗？