OpenClaw 浏览器调试模式配置：保留登录状态与自动化控制

这个脚本会启动一个 ARM64 架构的 Chrome 实例（适用于 M1/M2/M3 Mac），监听 9222 端口，并使用刚才创建的独立数据目录。

3. 配置 OpenClaw

修改 OpenClaw 的配置文件 ~/.openclaw/config.json，添加浏览器调试配置。

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

这告诉 OpenClaw 有一个名为 mydebug 的配置，其调试地址为本地 9222 端口。

使用方法

启动与验证

1. 启动浏览器：双击 /Applications/Chrome Debug.app 或在终端运行 open /Applications/Chrome Debug.app。
2. 验证连接：

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

   如果返回 JSON 数据，说明调试端口正常。

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

对话集成

在与 OpenClaw 对话时，它会自动识别并优先使用 mydebug 配置。例如：

你： '帮我搜索一下 GPT-5.3 Codex 的最新讨论'

OpenClaw： （自动打开 Chrome Debug，访问 X.com，搜索，截图，分析）

整个过程无需手动点击插件，也无需重新登录。

常见问题

Q1: 两个 Chrome 可以同时运行吗？

可以。它们使用不同的数据目录，互不干扰。建议日常开发直接使用 Chrome Debug 版本，避免状态同步问题。

Q2: 登录状态会同步吗？

不会自动同步。如果在普通 Chrome 中登录了新账号，需要重新复制 Cookies 文件到 Chrome-Debug 目录，或者直接在 Debug 版中登录。

Q3: 安全性如何？

调试端口仅监听 127.0.0.1，外网无法访问。只要本机环境安全，该方案是可靠的。不建议在公共电脑或不信任的环境中使用。

Q4: 为什么不用 Chrome 插件？

插件方案依赖手动触发，稳定性较差，容易因页面刷新或重启而断开。CDP 直连方式更稳定，适合自动化流程。

Q5: 支持其他浏览器吗？

理论上支持所有基于 Chromium 内核的浏览器（如 Edge、Brave）。只需修改启动脚本中的浏览器路径即可。

一键脚本

如果觉得上述步骤繁琐，可以使用以下脚本快速配置：

#!/bin/bash
# setup-chrome-debug.sh

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"

保存为 setup-chrome-debug.sh，赋予权限后运行：

chmod +x setup-chrome-debug.sh
./setup-chrome-debug.sh

结语

真正的自动化应当是无感的。通过 Chrome Debug 模式，我们实现了从'人机协作'到'完全自主'的转变。保留登录状态、消除手动操作、实现重启无忧，这才是 AI 助手应有的工作流。

配置一次，长期使用。如果你希望 OpenClaw 在联网调研时优先使用此浏览器实例，可在 IDENTITY.md 或 TOOLS.md 中添加相关提示词，引导模型优先调用 --browser-profile mydebug 参数。

参考资料：OpenClaw 官方文档