Browser Chrome

常用操作

# 打开网页
browser action=open targetUrl=https://www.douyin.com

# 截图
browser action=screenshot targetId=<tab-id>

# 页面快照（获取 DOM 结构）
browser action=snapshot targetId=<tab-id>

# 执行 JavaScript
browser action=act targetId=<tab-id> kind=evaluate fn="document.title"

# 点击元素
browser action=act targetId=<tab-id> kind=click ref=<element-ref>

# 键盘输入
browser action=act targetId=<tab-id> kind=type text="hello"

获取 Tab ID

browser action=tabs

返回示例：

{
  "tabs": [
    {
      "targetId": "297493F38A57B1E9873822C2A3A15DF7",
      "title": "douyin.com/jingxuan",
      "url": "https://www.douyin.com/jingxuan"
    }
  ]
}

User-Agent 问题

默认的 --headless 模式会使用 HeadlessChrome User-Agent，容易被网站检测。

伪装方案

在 openclaw.json 中配置（无效，不生效）：

{
  "browser": {
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/120.0.0.0 Safari/537.36"
  }
}

结论：OpenClaw browser 插件不支持自定义 User-Agent，headless 模式始终使用 HeadlessChrome。

替代方案：

1. 使用 google-chrome CLI 启动时手动指定 --user-agent
2. 或者用 Playwright/Selenium 等专业浏览器自动化工具

持久化登录状态

浏览器使用 --user-data-dir 指定目录存储 cookie 和 session：

google-chrome \
  --user-data-dir=/root/.openclaw/browser/openclaw/user-data

重启后登录状态会保留（除非网站强制重新验证）。

常见问题

1. "Running as root without --no-sandbox is not supported"

{ "browser": { "noSandbox": true } }

2. "Missing X server or $DISPLAY"

这是因为默认启动带 GUI 的 Chrome。设置 headless: true 可以解决：

{ "browser": { "headless": true } }

3. 浏览器启动超时

OpenClaw 的 browser 插件在 Linux 无头模式下可能超时。可以手动启动 Chrome 后再连接：

# 先杀掉已有 Chrome
pkill -9 chrome

# 手动启动
google-chrome --headless=new --no-sandbox --disable-gpu \
  --remote-debugging-port=18800 \
  --user-data-dir=/root/.openclaw/browser/openclaw/user-data &

sleep 3

# 再让 OpenClaw 连接
browser action=start

4. 访问抖音等国内网站

国内网站（抖音、B站等）在服务器环境中可能无法加载（需要国内网络或代理）。确保：

• mihomo 代理正常运行
• 或者目标网站可从服务器直接访问