OpenClaw 浏览器控制方案：让 AI 助手随时控制浏览器

该启动器将使用独立数据目录并开启远程调试端口（9222）。

第三步：配置 OpenClaw

在 ~/.openclaw/config.json 中添加浏览器配置：

{
  "browser": {
    "profiles": {
      "mydebug": {
        "cdpUrl": "http://127.0.0.1:9222",
        "color": "#00AA00"
      }
    }
  }
}

这告诉 OpenClaw 使用名为 mydebug 的配置连接本地调试端口。

使用方法

1. 启动浏览器

   open "/Applications/Chrome Debug.app"
   

2. 验证连接

   curl -s http://127.0.0.1:9222/json/version
   

   若返回 JSON 数据则连接成功。

3. OpenClaw 控制浏览器

   # 查看所有标签页
   openclaw browser --browser-profile mydebug tabs
   
   # 打开网页
   openclaw browser --browser-profile mydebug open "https://x.com"
   
   # 截图
   openclaw browser --browser-profile mydebug screenshot
   
   # 执行操作（点击、输入等）
   openclaw browser --browser-profile mydebug act
   

4. 对话中使用 在与 OpenClaw 对话时，它会自动使用 mydebug 配置，无需手动干预。

效果对比

一键脚本

可保存以下脚本为 setup-chrome-debug.sh 并运行：

#!/bin/bash
echo "🚀 设置 Chrome Debug 环境..."

# 1. 创建数据目录
mkdir -p "$HOME/Library/Application Support/Google/Chrome-Debug/Default"

# 2. 复制登录文件
cd "$HOME/Library/Application Support/Google/Chrome/Default"
cp Cookies "Login Data" "Web Data" Preferences "Secure Preferences" \
  "$HOME/Library/Application Support/Google/Chrome-Debug/Default/" 2>/dev/null
cp "$HOME/Library/Application Support/Google/Chrome/Local State" \
  "$HOME/Library/Application Support/Google/Chrome-Debug/" 2>/dev/null

# 3. 创建启动器
mkdir -p "/Applications/Chrome Debug.app/Contents/MacOS"
cat > "/Applications/Chrome Debug.app/Contents/MacOS/Chrome Debug" << 'EOF'
#!/usr/bin/env bash
exec arch -arm64 "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --remote-debugging-port=9222 \
  --user-data-dir="$HOME/Library/Application Support/Google/Chrome-Debug" \
  "$@"
EOF
chmod +x "/Applications/Chrome Debug.app/Contents/MacOS/Chrome Debug"

echo "✅ 设置完成！"
echo "👉 现在可以打开 /Applications/Chrome Debug.app 启动浏览器"
echo "👉 OpenClaw 会自动连接到 http://127.0.0.1:9222"

常见问题

Q1: 两个 Chrome 可以同时运行吗？ 可以。它们使用不同的数据目录。建议只用 Chrome Debug，因为它包含所有登录状态且支持 OpenClaw 控制。

Q2: 登录状态会同步吗？ 不会自动同步。如果在普通 Chrome 中登录了新账号，需重新复制 Cookies 文件到 Chrome-Debug 目录。

Q3: 安全吗？ 相对安全。调试端口只监听 127.0.0.1，外网无法访问。仅信任的程序（如 OpenClaw）会连接。不建议在公共电脑使用。

Q4: 为什么不用 Chrome 插件？ 插件需手动点击连接，重启后需重新配置，且有时失效。Chrome Debug 完全自动化，更稳定。

Q5: 支持其他浏览器吗？ 理论上支持所有基于 Chromium 的浏览器（Edge, Brave, Vivaldi 等），只需修改启动脚本中的路径。

进阶配置

在 OpenClaw 的配置中（如 IDENTITY.md 或 TOOLS.md），可设置优先使用已打开的可调试浏览器实例进行联网调研：

# 查看浏览器标签页
openclaw browser --browser-profile mydebug tabs

# 打开网页
openclaw browser --browser-profile mydebug open "https://x.com"

# 截图查看
openclaw browser --browser-profile mydebug snapshot

# 执行操作
openclaw browser --browser-profile mydebug act

通过这种方式，AI 将优先调用已登录的浏览器实例，而非每次启动新浏览器或调用 API。