OpenClaw浏览器在Linux中的配置指南

科技前沿 • 2026-04-23 14:03 • 阅读 0

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

问题背景

在Linux/WSL环境中首次使用OpenClaw浏览器时，会遇到以下错误：

屏幕截图 2026-03-12 123359.png

Error: No supported browser found (Chrome/Brave/Edge/Chromium)

解决方案

方法一：安装Chromium（推荐，适用于Ubuntu/Debian）

# 1. 更新包列表并安装Chromium sudo apt update && sudo apt install -y chromium-browser

这会通过snap安装Chromium，安装完成后会创建符号链接：

/usr/bin/gnome-www-browser → /usr/bin/chromium-browser

方法二：安装Chrome（可选）

# 下载Chrome .deb包 wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb

# 安装 sudo dpkg -i google-chrome-stable_current_amd64.deb sudo apt -f install # 修复依赖问题

关键配置项（WSL环境必选）

# 1. 设置默认浏览器配置文件 openclaw config set browser.defaultProfile “openclaw”

2. 启用无头模式（WSL无显示环境时必需）

openclaw config set browser.headless true

3. 禁用沙箱（WSL环境通常需要）

openclaw config set browser.noSandbox true

4. 指定浏览器可执行路径

openclaw config set browser.executablePath ”/usr/bin/gnome-www-browser”

配置说明：

配置项作用适用场景 browser.defaultProfile 指定OpenClaw的浏览器配置文件名长期使用 browser.headless 无头模式，不显示GUI窗口 WSL/服务器环境 browser.noSandbox 禁用Chrome沙箱机制 WSL/容器环境 browser.executablePath 明确浏览器二进制文件路径自动检测失败时

验证和使用

# 检查浏览器状态 openclaw browser --browser-profile openclaw status

# 打开网页测试 openclaw browser open https://www.baidu.com

成功输出示例：

opened: https://www.baidu.com/ id: 321FE4EEF496FF35EB098F7E56B57CA1

屏幕截图 2026-03-12 130812.png

扩展：Chrome扩展方案（图形界面）

如果你有Linux桌面环境，可以使用Chrome扩展获得更好的控制体验：

# 获取扩展安装路径 openclaw browser extension install

输出示例：

# ~/.openclaw/browser/chrome-extension

然后在Chrome中：

# 1. 打开 chrome://extensions # 2. 启用“开发者模式” # 3. 点击“加载已解压的扩展程序” # 4. 选择上面的路径 # 5. 固定“OpenClaw Browser Relay”扩展

🎯 博客文章建议结构

引言：OpenClaw浏览器功能介绍
常见问题：错误信息及原因
安装步骤：选择浏览器（Chromium优先）
配置详解：四个关键配置项的作用
验证测试：如何确认配置成功
扩展选项：Chrome扩展的使用方法
故障排查：常见错误及解决方案

⚠️ 注意事项

WSL headless: true + noSandbox: true 的组合对服务器环境至关重要
Ubuntu 24.04的chromium-browser包通过snap安装，需要额外配置可执行路径
Docker容器环境需要额外的Docker配置（未在日志中体现，可作为扩展内容）