mcpField
O
openclaw-browser-setup

openclaw-browser-setup

github.com/arthurzakirovAgent 工作流1163 次安装2 周前更新
代码仓库

关于 openclaw-browser-setup

这项排障技能帮助 OpenClaw 用户启用浏览器控制，并通过实际页面操作验证结果。内容涵盖网关目标、设备配对、插件检查、浏览器配置文件选择及 Linux 无头环境的常见启动问题。

主要功能

  1. 01确认本地或远程网关目标
  2. 02处理设备配对与认证问题
  3. 03检查浏览器插件配置
  4. 04选择托管或用户配置文件
  5. 05排查 Linux 无头启动问题
  6. 06用页面操作验证控制

适用场景

  1. 01配置 OpenClaw 浏览器控制
  2. 02诊断需要配对的错误
  3. 03排查 Linux 无头环境中的浏览器启动

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/arthurzakirov/agentdesk --skill openclaw-browser-setup

安装后在 Claude Code 中输入/openclaw-browser-setup确认已加载。

附带文件agents/openai.yamlreferences/official-docs.md

详细介绍

OpenClaw 浏览器设置

概述

以最短且可靠的路径让 OpenClaw 浏览器正常工作，然后通过实际网页交互验证，而不是只检查配置就停下。

需要了解某项修复背后的官方说明时，请阅读 references/official-docs.md。

选择目标

更改任何内容之前，先确认用户指的是本地网关还是远程网关。

运行：

openclaw gateway status --json
openclaw config get gateway.mode
openclaw config get gateway.remote.url

如果用户同时有本地和 VPS 实例，且目标不明确，请显式使用 --url。

快速路径

先尝试文档中记录的本地流程：

openclaw browser profiles
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

成功执行 open，并成功获取 snapshot 或 screenshot，即可证明浏览器控制正常。status 可能会延迟更新或显示过时状态。

先解决配对和身份验证问题

如果浏览器命令因 pairing required 或 PAIRING_REQUIRED 而失败，请先批准设备，再排查浏览器内部问题。

运行：

openclaw devices list
openclaw devices approve <requestId>

如果连接重试时使用了更广泛的权限范围或更改了身份验证详情，请在批准前再次列出设备，因为待处理的 requestId 可能已经改变。

如果需要使用共享令牌身份验证，请检查已配置的令牌，不要猜测：

openclaw config get gateway.auth.token

解决浏览器命令缺失或插件状态问题

如果缺少 openclaw browser，或 Agent 报告浏览器工具不可用，请先检查插件加载情况，再处理浏览器配置文件。

检查：

openclaw config get plugins.allow
openclaw config get plugins.entries.browser.enabled
openclaw config get browser.enabled

如果存在 plugins.allow，请确保其中包含 browser。如果更改了浏览器插件或浏览器配置，请重启网关：

openclaw gateway restart

选择合适的配置文件

使用：

  • 隔离的托管浏览器使用 openclaw。
  • 登录状态很重要且用户在场以批准附加提示时，使用现有的 Chrome 登录会话 user。

在服务器、容器或无头 Linux 主机上，不要默认使用 user。

处理 Linux 无头环境和 CDP 启动失败

如果 openclaw browser start 失败，请先检查日志，再更改配置：

openclaw logs --limit 120 --plain
openclaw browser status

对于没有桌面会话的 Linux 服务器，常见修复方法：

openclaw config set browser.headless true
openclaw gateway restart
openclaw browser --browser-profile openclaw start

如果配置的浏览器二进制文件有误或缺失，请检查已安装的内容：

which google-chrome-stable
google-chrome-stable --version
which chromium-browser

如果日志提到 snap Chromium 或 CDP 启动失败，请阅读 references/official-docs.md，了解官方的 executablePath、attachOnly 和手动 CDP 指引。

通过实际操作验证

启动成功后，务必执行实际操作流程：

openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot
openclaw browser --browser-profile openclaw screenshot
openclaw browser --browser-profile openclaw tabs

如果 open 成功，但 tabs 显示异常，请继续执行实时网页操作。只要 snapshot 或 screenshot 能返回有用的页面状态，浏览器流程就正常。

按步骤排查

首次尝试失败时，按以下顺序处理：

  1. 确认目标网关。
  2. 使用 openclaw devices list 和 approve 解决 pairing required。
  3. 确认浏览器插件已加载。
  4. 重试托管的 openclaw 配置文件。
  5. 在没有图形界面的 Linux 主机上切换到无头模式。
  6. 检查浏览器二进制文件路径，或排查 snap／仅附加模式的问题。
  7. 最后再尝试 user 或远程 CDP 配置文件。

评论

支持 Markdown