宝塔 OpenClaw 怎么看图和浏览网页?多模态模型与 Chrome 浏览器配置
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,装完重启浏览器即可。