OpenClaw AI 助手浏览器自动化功能配置实战

下载安装包

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

安装 Chrome

sudo dpkg -i google-chrome-stable_current_amd64.deb 

大概率会遇到依赖问题，例如缺少 fonts-liberation 或 libgtk-3-0。

修复缺失依赖

sudo apt --fix-broken install -y 

此命令会自动检测并安装所有缺失的依赖包（约 93 个包），包括字体库、GTK 图形库等。

验证安装

which google-chrome-stable 
google-chrome-stable --version 

确保路径指向 /usr/bin/google-chrome-stable 且版本号正常。

第三步：安装中文字体

服务器默认无中文字体，直接截图中文网页会出现乱码方块。

sudo apt install -y fonts-noto-cjk fonts-wqy-zenhei 

• fonts-noto-cjk：Google Noto 字体，覆盖中日韩文字。
• fonts-wqy-zenhei：文泉驿正黑，作为补充确保生僻字显示。

安装后无需重启系统，但需重启浏览器服务生效。

第四步：配置 OpenClaw 浏览器设置

编辑配置文件：

nano ~/.openclaw/openclaw.json 

找到或添加 browser 配置段：

{
  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/google-chrome-stable",
    "headless": true,
    "noSandbox": true,
    "defaultProfile": "openclaw"
  }
}

关键配置项解析

• executablePath：指定 Chrome 路径，避免使用 Snap 版。
• headless：无头模式。服务器无显示器，必须开启，浏览器会在后台运行。
• noSandbox：禁用沙盒。服务器或容器环境中，Chrome 默认沙盒可能因权限问题失效，需关闭以保证稳定运行。
• defaultProfile：使用 OpenClaw 托管的独立实例，不影响个人浏览数据。

第五步：重启服务并测试

重启 Gateway

openclaw gateway restart 

检查浏览器状态

openclaw browser --browser-profile openclaw status 

关注 detectedPath 是否指向你安装的 Google Chrome。

启动与测试

openclaw browser --browser-profile openclaw start 
openclaw browser --browser-profile openclaw open https://www.baidu.com 
openclaw browser --browser-profile openclaw screenshot 

截图将保存在 ~/.openclaw/media/browser/ 目录下，可用 scp 下载到本地查看中文显示是否正常。

第六步：在 TUI 中通过对话控制浏览器

重置会话

openclaw sessions reset main 

注意：修改配置后必须重置会话，否则 AI 缓存了旧的工具列表，无法识别新启用的浏览器功能。

进入 TUI 对话界面

openclaw tui 

测试对话

输入指令：

用浏览器打开百度的首页，然后截个图，并把图片存储在 /home/ubuntu/screenshots/ 路径中

AI 应回复成功完成请求，并告知图片保存位置。

常见问题排查

1. Snap Chromium 无法使用

现象：Gateway 日志正常，但启动浏览器失败。 原因：Snap 版本隔离了 CDP 端口。 解决：安装官方 Chrome 并指定 executablePath。

2. 中文显示为方块

现象：截图中中文全是 □□□□。 原因：服务器未安装中文字体。 解决：安装 fonts-noto-cjk 和 fonts-wqy-zenhei。

3. 修改配置后 AI 仍无法使用

现象：CLI 测试正常，TUI 报错。 原因：会话缓存了旧工具列表。 解决：执行 openclaw sessions reset main。

4. Chrome 依赖缺失

现象：dpkg -i 时报错。 原因：Server 版精简了 GUI 相关库。 解决：执行 sudo apt --fix-broken install -y。

应用场景

配置完成后，你可以让 AI 助手处理繁琐任务：

1. 自动化数据采集：搜索 arXiv 并提取论文标题链接。
2. 定时监控：结合 cron 每小时截图 TensorBoard 训练曲线。
3. 批量表单填写：读取 Excel 数据填入报销系统。
4. 内容提取：提取网页表格数据保存为 CSV。
5. 自动化测试：依次测试登录、创建项目等功能并截图。

总结

通过配置，我们为 OpenClaw 添加了强大的浏览器自动化能力：

• 🌐 网页浏览：支持 JavaScript 渲染。
• 📸 截图保存：全页或元素级截图。
• 🖱️ 自动操作：点击、输入、滚动。
• 🗣️ 自然语言控制：对话指挥浏览器。

核心收获：理解了 Snap 与原生应用的区别，掌握了无头服务器环境下的浏览器配置，以及 OpenClaw 的关键参数含义。