宝塔面板博客官方技术博客
宝塔面板

宝塔 OpenClaw 怎么看图和浏览网页?多模态模型与 Chrome 浏览器配置

OpenClaw(昵称「龙虾」)刚装好时是个「睁眼瞎」:你发张截图让它分析,它回一句「我无法查看图片」;让它去截图宝塔官网,它说「无法使用浏览器功能」。这不是它笨,而是两个能力默认都没开——看懂图片要靠多模态模型,浏览网页要靠浏览器组件。下面按官方养成教程,讲清这两步分别怎么配。

看懂图片:切换多模态视觉模型

默认模型是纯文字的,只能读字不能看图。解决办法不是改配置文件,而是直接对话——OpenClaw 支持让它自己改配置。

第一步:问它当前模型支不支持图片

在飞书直接问:

你:你现在用的是什么模型?支持图片吗?

问 OpenClaw 当前模型是否支持图片

龙虾会告诉你当前配置,并检查是否支持图片。支持就直接跳到测试那一步,不支持则继续下一步。

第二步:让它切换到支持图片的模型

继续对话:

你:帮我切换到一个支持图片的模型

龙虾会列出可用的多模态模型(qwen-vl、qwen3.5-plus、gpt-4v 等),问你要哪个,然后自动改配置并重启。也可以更直接:

你:切换到 qwen3.5-plus,支持图片的那个

官方给出的常见模型对照如下:

模型 支持图片 备注
qwen-vl ✅ 通义千问视觉版
qwen3.5-plus ✅ 新版支持
gpt-4v ✅ OpenAI 视觉版
gpt-4-turbo ✅ 支持图片
claude-3 ✅ Claude 视觉版
gpt-3.5-turbo ❌ 仅文字
qwen-turbo ❌ 仅文字

第三步:发图测试

切换完成后发一张图、让它分析。能分析就成功了;还是看不懂,就继续问它:

你:为什么你看不懂这张图片?分析下原因,再自我检查,要怎么让你可以看懂图片。

龙虾会自己诊断问题并给出解法。

浏览网页:装 Chrome 并配置浏览器组件

看懂图片解决的是「分析你发来的图」,但让它主动上网截图、抓动态内容,需要装浏览器组件。官方教程把这一步叫「给龙虾装上眼睛」。

先检测当前状态

openclaw browser status
  • 显示 running: true:浏览器已装好,直接去用;
  • 显示 running: false 或 browser: unknown:需要安装,往下看;
  • 报 openclaw: command not found:OpenClaw 本身没装好,先回去看安装教程。

装 Chrome:按系统选包

先确认系统类型:

cat /etc/os-release

Ubuntu/Debian 用 .deb 包,CentOS/OpenCloudOS/Fedora 用 .rpm 包。

装依赖(浏览器需要的系统库):

# Ubuntu/Debian
apt update
apt install -y fonts-liberation xdg-utils fonts-noto-cjk

# CentOS/OpenCloudOS
yum install -y liberation-fonts xdg-utils google-noto-sans-cjk-fonts

这三个包里,fonts-noto-cjk(或 google-noto-sans-cjk-fonts)最容易漏——不装的话浏览器能启动,但中文网页全是方框。

下载并安装 Chrome:

# Ubuntu/Debian
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
dpkg -i google-chrome-stable_current_amd64.deb
apt --fix-broken install -y

# CentOS/OpenCloudOS
wget https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm
yum localinstall -y ./google-chrome-stable_current_x86_64.rpm

谷歌下载服务器在国内可能较慢,wget 卡住时用国内镜像:华为云镜像(rpm)https://repo.huaweicloud.com/chrome/rpm/google-chrome-stable_current_x86_64.rpm,阿里云镜像(deb)https://mirrors.aliyun.com/google-chrome/google-chrome-stable_current_amd64.deb。

验证安装:

which google-chrome

正常应返回 /usr/bin/google-chrome,没有返回说明装失败了。

配置 OpenClaw:4 条命令

Chrome 装好了,还要告诉 OpenClaw 它在哪、怎么跑:

# 1. 设置默认浏览器模式
openclaw config set browser.defaultProfile "openclaw"

# 2. 开启无头模式(服务器没有图形界面)
openclaw config set browser.headless true

# 3. 允许 root 用户运行(必需)
openclaw config set browser.noSandbox true

# 4. 设置 Chrome 路径
openclaw config set browser.executablePath "/usr/bin/google-chrome"

然后重启 Gateway 并启动浏览器:

openclaw gateway restart
openclaw browser start
openclaw browser status

浏览器配置成功后的状态输出

看到 running: true 就成功了。

headless 不配会报 “Unable to open X display”,noSandbox 不配会报 “Running as root without –no-sandbox is not supported”,executablePath 不配会报 “Chrome executable not found”。配置改完必须重启 Gateway,否则不生效。

装好后能做什么

浏览器就绪后,龙虾能做的远超「聊天」:

  • 截图网页:让它「截图宝塔官方首页」,包括需要登录的页面;
  • 抓动态内容:抓取 JavaScript 渲染后的内容,之前 web_fetch 摸不到的严格网站(宝塔首页、公众号、GitHub)也能看了;
  • 自动化操作:打开网页、搜索、点击、填表;
  • 监控变化:定时检查商品库存、公告页更新并通知你。

如果飞书里让机器人截图它还是说「无法使用浏览器」,多半是配置文件的 browser.profile 字段不对——应设为 openclaw 或 full,而不是 messaging:

openclaw config set browser.defaultProfile "openclaw"
openclaw gateway restart

常见报错速查

报错/现象 原因 解决
中文网页显示方框 缺中文字体 装 fonts-noto-cjk 或 google-noto-sans-cjk-fonts
Unable to open X display 服务器无图形界面 browser.headless true
Running as root without –no-sandbox root 跑 Chrome 未关沙箱 browser.noSandbox true
which google-chrome 无返回 安装路径不是默认路径 find / -name "google-chrome" 找到后配 executablePath
status 一直是 running: false Gateway 没加载新配置 openclaw gateway restart 再 start
飞书说「无法使用浏览器」 profile 字段不对 设 browser.defaultProfile "openclaw"

(以上命令与参数均出自宝塔官方 OpenClaw 养成教程 Day4、Day7,见 docs.bt.cn。)

常见问题

OpenClaw 发截图说「我无法查看图片」怎么办?

当前模型是纯文字模型。直接对话让它切换:问「你现在用的是什么模型?支持图片吗?」,不支持就让它「切换到一个支持图片的模型」,例如 qwen-vl、qwen3.5-plus、gpt-4v,切换后发图测试即可。

切换模型必须手动改配置文件吗?

不用。OpenClaw 支持对话改配置:让它列出可用模型、选一个支持图片的,它会自动修改配置并重启,全程不用手改文件。

OpenClaw 能上网浏览网页吗?

默认不能。刚装好时浏览器组件是关闭的,只能靠 web_fetch 摸网页。装好 Chrome 并配置浏览器组件后,就能截图网页、抓取 JS 动态渲染内容、自动点击填表、监控页面变化。

怎么检查 OpenClaw 浏览器装没装好?

运行 openclaw browser status。输出 running: true 说明已就绪;running: false 或 browser: unknown 需要安装;命令报 command not found 说明 OpenClaw 本身没装好。

装浏览器报错 Running as root without --no-sandbox 怎么办?

用 root 运行 Chrome 必须关沙箱:执行 openclaw config set browser.noSandbox true,再 openclaw gateway restart 重启,最后 openclaw browser start。

浏览器能启动但中文网页全是方框怎么办?

缺中文字体。Ubuntu/Debian 装 fonts-noto-cjk,CentOS/OpenCloudOS 装 google-noto-sans-cjk-fonts,装完重启浏览器即可。