openclaw browser 浏览器控制命令教程

命令概述

openclaw browser 命令用于管理 OpenClaw 的内置无头浏览器功能。AI 助手可以通过浏览器工具访问网页、提取内容、截图和执行自动化操作。

启用浏览器

openclaw browser enable

这会安装必要的浏览器引擎（Chromium）并配置浏览器工具。

基本操作

打开网页

openclaw browser open "https://example.com"

截图

openclaw browser screenshot "https://example.com" --output screenshot.png
openclaw browser screenshot "https://example.com" --output screenshot.png --full-page

提取内容

openclaw browser extract "https://example.com" --format text
openclaw browser extract "https://example.com" --format markdown
openclaw browser extract "https://example.com" --format html

配置浏览器

{
  "browser": {
    "enabled": true,
    "engine": "chromium",
    "headless": true,
    "timeout": 30000,
    "viewport": {
      "width": 1280,
      "height": 720
    },
    "userAgent": "OpenClaw Bot/1.0",
    "proxy": null,
    "blockedDomains": [
      "ads.example.com"
    ]
  }
}

在 AI 对话中使用

配置浏览器作为 AI 工具后，用户可以通过自然语言让 AI 访问网页：

{
  "channels": {
    "telegram-main": {
      "tools": ["browser"]
    }
  }
}

用户对话示例：

用户: 帮我看看 GitHub 上 OpenClaw 的最新 Release
AI: 我来帮你查看... [使用浏览器访问 GitHub]
    OpenClaw 最新版本是 v1.2.3，发布于 2026-03-15，
    主要更新包括...

浏览器状态

openclaw browser status

Browser Status:
  Engine: Chromium 122
  Status: Running
  Active pages: 2
  Memory usage: 85MB
  Uptime: 2h 15m

管理浏览器实例

# 重启浏览器
openclaw browser restart

# 停止浏览器
openclaw browser stop

# 清除缓存和 Cookie
openclaw browser clear-cache
openclaw browser clear-cookies

安全限制

配置浏览器的安全限制：

{
  "browser": {
    "security": {
      "allowedDomains": ["*.example.com", "github.com"],
      "blockedDomains": ["malware.com"],
      "maxPagesPerMinute": 10,
      "maxConcurrentPages": 3,
      "disableJavaScript": false,
      "disableImages": false
    }
  }
}

代理配置

openclaw browser set-proxy "http://proxy:8080"
openclaw browser set-proxy "socks5://proxy:1080"

调试模式

# 非无头模式运行（会显示浏览器窗口）
openclaw browser --no-headless open "https://example.com"

总结

openclaw browser 为 AI 助手添加了网页访问能力，使其能够获取实时信息和处理基于网页的任务。合理配置安全限制和资源限制，可以安全高效地运行浏览器工具。