OpenClaw 在无桌面 Linux 上浏览器识别不了?别急,装个 Chromium 加配置参数,轻松搞定.

哈喽，大家好，我是寂寞的熊猫。

先给个省流版结论：

1. 核心问题：OpenClaw 在无桌面环境下 browser status 显示 unknown
2. 解决方案：安装 Chromium/Chrome 并配置正确的启动参数
3. 关键参数：--no-sandbox 和 --disable-dev-shm-usage 必须有
4. 支持 RHEL/CentOS 系和 Debian/Ubuntu 系两大流派

一、这是个什么问题？

你买了一台腾讯云 Lighthouse，兴冲冲装上 OpenClaw，想让它替你浏览网页、自动操作。

结果一查状态：

openclaw browser status

返回的是：

running: falsebrowser: unknowndetectedBrowser: unknown

有点小遗憾。

服务器没有桌面环境，就像给一个盲人配了副眼镜——眼镜有了，但他看不见。

怎么办？装浏览器，配参数。

RHEL/CentOS 系（OpenCloudOS 9 适用）

适用场景：腾讯云 Lighthouse OpenCloudOS 9、CentOS Stream 9 等。

Step 1：装依赖

sudo dnf update -y

浏览器跑起来需要一堆图形库，别嫌多，慢慢装：

sudo dnf install -y atk at-spi2-atk cups-libs libdrm libxcomposite libxdamage \    libxrandr mesa-libgbm pango alsa-lib nss-mdns xorg-x11-fonts-100dpi \    xorg-x11-fonts-75dpi xorg-x11-fonts-cyrillic xorg-x11-fonts-misc \    xorg-x11-fonts-Type1 xorg-x11-utils

Step 2：装 Chromium

sudo dnf install -y epel-releasesudo dnf install -y chromium

验证一下：

which chromium-browserchromium-browser --version

Step 3：配置 OpenClaw

创建配置文件：

mkdir -p ~/.config/openclaw/profiles

写入配置：

{"browser": "chromium","executablePath": "/usr/bin/chromium-browser","args": ["--headless","--no-sandbox","--disable-setuid-sandbox","--disable-dev-shm-usage","--disable-gpu","--remote-debugging-port=0"  ]}

这几个参数什么意思？

Step 4：启动验证

openclaw browser startopenclaw browser status

成功的话你会看到：

running: truebrowser: chromiumcdpUrl: http://127.0.0.1:18792

真争气。

三、Debian/Ubuntu 系

适用场景：Ubuntu 20.04/22.04、Debian 11/12 等。

Step 1：更新并装依赖

sudo apt updatesudo apt install -y wget gnupg ca-certificates \    fonts-liberation libasound2 libatk-bridge2.0-0 libatk1.0-0 \    libatspi2.0-0 libcups2 libdbus-1-3 libdrm2 libgbm1 \    libgtk-3-0 libnspr4 libnss3 libwayland-client0 libxcomposite1 \    libxdamage1 libxfixes3 libxkbcommon0 libxrandr2 xdg-utils

Step 2：装 Chromium

Ubuntu 系直接用 apt 装最省心：

sudo apt install -y chromium-browser

如果是 Debian，可能需要用 snap：

sudo apt install -y snapdsudo snap install chromium

验证安装：

which chromium-browserchromium-browser --version

Step 3：配置 OpenClaw

和 RHEL 系配置一样，创建目录：

mkdir -p ~/.config/openclaw/profiles

写入配置（注意路径可能不同）：

{"browser": "chromium","executablePath": "/usr/bin/chromium-browser","args": ["--headless","--no-sandbox","--disable-setuid-sandbox","--disable-dev-shm-usage","--disable-gpu","--remote-debugging-port=0"  ]}

如果是 snap 安装的 Chromium，路径可能是：

"executablePath": "/snap/bin/chromium"

Step 4：启动验证

openclaw browser startopenclaw browser status

四、一键安装脚本

RHEL/CentOS 系（OpenCloudOS 9）

#!/bin/bashset -eecho"=== 安装 Chromium 及依赖 ==="sudo dnf install -y epel-releasesudo dnf install -y chromium \    atk at-spi2-atk cups-libs libdrm libxcomposite \    libxdamage libxrandr mesa-libgbm pango alsa-lib \    xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi \    xorg-x11-fonts-misc xorg-x11-fonts-Type1echo"=== 验证安装 ==="chromium-browser --versionecho"=== 配置 OpenClaw 浏览器配置 ==="mkdir -p ~/.config/openclaw/profilescat > ~/.config/openclaw/profiles/chrome.json << 'EOF'{"browser": "chromium","executablePath": "/usr/bin/chromium-browser","args": ["--headless","--no-sandbox","--disable-setuid-sandbox","--disable-dev-shm-usage","--disable-gpu","--remote-debugging-port=0"  ]}EOFecho"=== 安装完成，请运行: openclaw browser start ==="

Debian/Ubuntu 系

#!/bin/bashset -eecho"=== 安装 Chromium 及依赖 ==="sudo apt updatesudo apt install -y chromium-browser \    wget gnupg ca-certificates fonts-liberation \    libasound2 libatk-bridge2.0-0 libatk1.0-0 \    libatspi2.0-0 libcups2 libdbus-1-3 libdrm2 \    libgbm1 libgtk-3-0 libnspr4 libnss3 \    libwayland-client0 libxcomposite1 libxdamage1 \    libxfixes3 libxkbcommon0 libxrandr2 xdg-utilsecho"=== 验证安装 ==="chromium-browser --versionecho"=== 配置 OpenClaw 浏览器配置 ==="mkdir -p ~/.config/openclaw/profilescat > ~/.config/openclaw/profiles/chrome.json << 'EOF'{"browser": "chromium","executablePath": "/usr/bin/chromium-browser","args": ["--headless","--no-sandbox","--disable-setuid-sandbox","--disable-dev-shm-usage","--disable-gpu","--remote-debugging-port=0"  ]}EOFecho"=== 安装完成，请运行: openclaw browser start ==="

五、常见问题排错

装完之后，OpenClaw 就能在 Lighthouse 上正常调用浏览器了，AI Agent 这才真正有了"眼睛"。