用途：帮助 Codex 在本地或远程网关上排查并运行 OpenClaw 浏览器，目标是用最短可靠路径让浏览器可用，并以真实页面交互验证，而不是只检查配置。
主要能力：区分本地与远程网关；启用内置浏览器插件；解决 pairing required / PAIRING_REQUIRED 配对与授权问题；处理 openclaw browser 命令缺失或插件未加载；选择合适浏览器配置；处理 Linux 无头环境与 CDP 启动失败；用真实操作验证。
使用方式：先确认目标网关，运行 openclaw gateway status --json、openclaw config get gateway.mode、openclaw config get gateway.remote.url，目标不明确时显式使用 --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。配对问题先运行 openclaw devices list 与 openclaw devices approve <requestId>；若重试后范围或认证变化，需重新列出设备。检查插件：openclaw config get plugins.allow、openclaw config get plugins.entries.browser.enabled、openclaw config get browser.enabled；plugins.allow 存在时须包含 browser，改动后运行 openclaw gateway restart。配置选择：openclaw 为隔离托管浏览器，user 为已登录 Chrome 会话，服务器、容器或无头 Linux 不要默认用 user。Linux 无头启动失败先看 openclaw logs --limit 120 --plain 与 openclaw browser status，常见修复为 openclaw config set browser.headless true 后重启网关再启动。验证用 open、snapshot、screenshot、tabs 真实循环。
适用场景：本地或 VPS 网关上的浏览器控制排障、插件启用、配对授权、无头 Linux 启动问题。
限制：资料未提供具体版本要求、支持平台清单、收费信息与性能数据；官方文档细节需查阅 references/official-docs.md。