在无头 Linux 环境下配置 OpenClaw 浏览器的排障记录

背景

在纯命令行（Headless）的 Linux 服务器或 WSL 环境中部署 OpenClaw 时，运行 openclaw browser status 经常会遇到状态为 running: false 且无法正常启动浏览器的情况。本文记录了从零安装浏览器到解决 OpenClaw 配置报错的完整排障过程。

问题排查与解决步骤

1. 安装官方 Google Chrome 及修复依赖报错

在 Linux 终端下，直接使用包管理器安装的 Chromium 可能会受到系统沙盒机制（如 snap 的 AppArmor）的限制，导致 OpenClaw 无法调用。推荐直接安装官方的 .deb 包。

下载安装包：

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb

直接使用 dpkg 安装通常会因为缺少桌面端字体（如 fonts-liberation）等依赖而中断。此时不需要手动逐个寻找依赖，直接使用 apt 的修复命令即可自动补齐缺失文件并完成 Chrome 的安装：

sudo apt --fix-broken install -y

2. 配置 OpenClaw 基础参数

安装完成后，需要告诉 OpenClaw 浏览器的确切位置，并开启无头（Headless）和无沙盒（No-sandbox）模式，以适应无桌面且可能有权限限制的运行环境。

在终端中依次执行以下命令：

# 指定 Chrome 可执行文件路径
openclaw config set browser.executablePath "/usr/bin/google-chrome-stable"

# 开启无桌面环境运行模式
openclaw config set browser.headless true

# 禁用沙盒模式（Linux 下常用选项）
openclaw config set browser.noSandbox true

3. 解决 “no tab is connected” 报错

在完成上述配置后，如果直接运行 openclaw browser start，可能会遇到以下报错：
Error: Chrome extension relay is running, but no tab is connected.

这是因为 OpenClaw 默认启用了 chrome 配置文件。该模式属于“扩展中继模式”，需要人工在图形化界面的浏览器中点击插件才能建立连接。在无界面的 Linux 环境中，必须将其切换为 OpenClaw 自动托管的独立配置文件。

执行以下命令切换默认配置文件：

openclaw config set browser.defaultProfile "openclaw"

4. 重启服务与验证

修改配置后，必须重启 OpenClaw 的 Gateway 服务才能使各项设置生效。

# 重启网关服务
openclaw gateway restart

# 启动浏览器组件
openclaw browser start

# 检查运行状态
openclaw browser status

当终端输出 profile: openclaw 且 running: true，说明无头浏览器已经成功启动并由 OpenClaw 接管。