夜雨聆风Agent-Browser插件是Openclaw实现浏览器自动化的核心组件，分为“Openclaw插件包安装”和“Chrome浏览器扩展安装”两部分（目前仅支持Chrome及基于Chromium内核的浏览器，如Edge、Brave等），全程操作无需复杂代码基础，跟着步骤执行即可完成。
一、安装前准备（必做）
在安装插件前，需确认以下3点，避免安装失败或功能异常：
1确认Openclaw已正常运行：打开终端（Windows快捷键Win+R，输入cmd；Mac/Linux打开终端），输入命令 openclaw --version，若能正常显示版本号（如2026.3.2），说明Openclaw已安装且可正常使用；若提示“命令不存在”，需重新配置Openclaw环境变量，或重新安装Openclaw。
1安装Chrome浏览器（或Chromium内核浏览器）：确保设备已安装Chrome，版本建议90.0及以上；若使用Edge、Brave等浏览器，操作流程与Chrome一致，仅需在对应浏览器的扩展页面操作即可。
1网络环境通畅：插件安装过程中需拉取相关资源，建议保持网络稳定；若网络受限（如无法访问Chrome应用商店），可选择离线安装方式（下文会详细说明）。
二、分步安装Agent-Browser插件（核心步骤）
Agent-Browser插件安装分为两个核心环节：先通过终端安装Openclaw对应的插件包，再在Chrome浏览器中安装扩展程序，两步完成后即可完成配置。
步骤1：安装Openclaw Agent-Browser插件包
此步骤需通过终端执行命令，将Agent-Browser插件包安装到Openclaw的指定目录，全程自动完成，无需手动干预：
1打开终端（Windows cmd、Mac终端、Linux终端），确保终端可正常执行Openclaw命令（可通过openclaw --version再次验证）。
1输入核心安装命令，按下回车执行： clawhub install agent-browser（该命令会自动从ClawHub仓库拉取Agent-Browser插件包，并完成安装）。
1等待安装完成：终端会显示安装进度，若出现“Install successfully”（安装成功）的提示，说明插件包已安装到位；若提示“网络超时”，可重试命令，或检查网络连接后再次执行。
1（可选）验证插件包安装：输入命令openclaw plugins list，查看已安装的插件列表，若能找到“agent-browser”相关条目，说明插件包安装成功；若未找到，可重新执行安装命令。
步骤2：安装Chrome浏览器扩展（Agent-Browser中继组件）
Agent-Browser插件需配合Chrome扩展（OpenClaw Browser Relay）使用，才能实现浏览器控制功能，扩展安装分为“在线安装”和“离线安装”两种方式，可根据自身网络环境选择：
方式1：在线安装（推荐，网络通畅时使用）
1打开Chrome浏览器，访问Chrome应用商店，搜索“OpenClaw Browser Relay”，或直接访问扩展链接： https://chromewebstore.google.com/detail/openclaw-browser-relay/nglingapjinhecnfejdcpihlpneeadjp?pli=1。
1点击“添加至Chrome”，在弹出的确认窗口中选择“添加扩展程序”，等待1-2秒，扩展即可安装完成。
1固定扩展图标：安装完成后，点击Chrome浏览器右上角的“扩展程序”图标（拼图形状），找到“OpenClaw Browser Relay”，点击其右侧的“固定”按钮，将扩展图标固定到浏览器工具栏，方便后续操作。
方式2：离线安装（网络受限，无法访问Chrome应用商店时使用）
1打开终端，输入命令，获取扩展程序的本地目录路径： openclaw browser extension path，执行后终端会输出一个路径（如Windows：C:\Users\用户名\.openclaw\browser\chrome-extension；Mac/Linux：~/.openclaw/browser/chrome-extension）。
1先安装扩展基础文件：输入命令 openclaw browser extension install，执行后会自动下载扩展所需文件到上述路径中，等待执行完成即可。
1打开Chrome浏览器，在地址栏输入 chrome://extensions，进入扩展管理页面。
1启用“开发者模式”：点击页面右上角的“开发者模式”开关，使其处于开启状态（开关变蓝）。
1加载已解压的扩展程序：点击页面左上角的“加载已解压的扩展程序”，在弹出的文件选择窗口中，找到步骤1中获取的扩展目录，选中该目录并点击“选择文件夹”。
1验证安装：加载完成后，扩展管理页面会显示“OpenClaw Browser Relay”插件，且状态为“已启用”，同时浏览器工具栏会出现该扩展图标，固定图标后即可使用。
步骤3：插件配置与生效
插件安装完成后，需简单配置，确保Openclaw与浏览器扩展正常通信：
1获取Openclaw网关令牌：打开浏览器，访问 http://127.0.0.1:18789/overview，进入Openclaw控制台，找到“网关令牌”并复制（若无法访问该地址，需先启动Openclaw网关）。
1配置扩展令牌：点击Chrome工具栏中的“OpenClaw Browser Relay”扩展图标，在弹出的配置页面中，粘贴刚才复制的网关令牌，点击“保存”。
1重启Openclaw网关：回到终端，输入命令 openclaw gateway restart，重启网关使配置生效；若未启动网关，需先输入 openclaw gateway --port 18789 启动网关（默认端口为18789）。
三、安装验证（必做，确认插件可用）
安装完成后，通过以下操作验证插件是否正常工作，避免后续使用时出现问题：
1打开Chrome浏览器，任意打开一个网页（如百度首页）。
1点击浏览器工具栏中的“OpenClaw Browser Relay”扩展图标，此时扩展会显示状态：若显示“ON”，说明已附加当前标签页，Openclaw可正常控制该网页；若显示“…”，说明正在连接本地中继，等待1-2秒即可；若显示“!”，说明中继不可达，需检查网关是否已启动、令牌配置是否正确。
1终端验证：回到终端，输入命令openclaw browser --browser-profile chrome tabs，若能正常列出当前Chrome浏览器的所有标签页，说明Agent-Browser插件已成功生效，Openclaw可正常控制浏览器。
四、常见问题及解决方案（避坑指南）
安装过程中可能遇到以下问题，可对照解决方案快速排查，无需重新安装：
1问题1：执行 clawhub install agent-browser 提示“clawhub: 命令不存在” 解决方案：先安装Clawhub工具（Agent-Browser插件依赖Clawhub仓库），输入命令 npm install -g clawhub，安装完成后再重新执行插件安装命令；若已安装Clawhub，检查环境变量是否配置正确。
1问题2：Chrome扩展加载失败，提示“扩展程序无效” 解决方案：确认扩展目录路径正确（通过 openclaw browser extension path 重新获取），且已启用“开发者模式”；若路径正确仍失败，重新执行 openclaw browser extension install 命令，刷新扩展文件后再加载。
1问题3：扩展状态显示“!”，中继不可达 解决方案：① 检查Openclaw网关是否已启动，输入 openclaw gateway start 启动网关；② 确认网关端口未被占用（默认18789），若占用，可通过 openclaw gateway --port 18790 更换端口；③ 检查令牌配置是否正确，重新复制网关令牌并保存配置。
1问题4：终端执行浏览器控制命令，提示“tab not found”（标签页未找到） 解决方案：一次只附加一个标签页，关闭其他标签页的扩展（点击扩展图标切换为“OFF”），仅保留一个标签页并切换为“ON”，再重新执行命令；若使用的是2026.1.29之前的版本，建议升级Openclaw至最新版（npm install -g openclaw@latest），官方已修复该问题。
1问题5：Sandbox会话中无法使用扩展中继 解决方案：在Openclaw配置文件（~/.openclaw/openclaw.json）中添加配置，允许host浏览器控制，具体配置如下： { "agents": { "defaults": { "sandbox": { "browser": { "allowHostControl": true } } } }，添加后重启网关即可生效。
五、后续使用注意事项
1升级Openclaw后，需重新刷新扩展：执行openclaw browser extension install 刷新扩展文件，再在Chrome扩展管理页面点击“重新加载”，避免版本不兼容。
1插件仅支持Chrome及Chromium内核浏览器，暂不支持Firefox、Safari等其他浏览器，若需使用其他浏览器，需更换为支持的浏览器版本。
1不要将账号密码等敏感信息提供给Openclaw模型，官方明确警告“Do not give the model your credentials”，自动登录可能触发反爬虫机制，导致账号被锁定。
1若需远程控制浏览器，需建立SSH隧道（如 ssh -L 18792:127.0.0.1:18792 root@服务器IP），且隧道需保持开启，可配置后台启动方案避免终端关闭后隧道断开。
总结：已安装Openclaw的前提下，Agent-Browser插件的安装核心是“终端安装插件包+浏览器安装扩展”，两步操作即可完成，验证过程简单直观。若遇到问题，优先检查网关状态、扩展配置和网络连接，对照常见问题解决方案可快速排查。安装完成后，Openclaw即可实现浏览器自动化控制，复用已登录网页状态，大幅提升AI助手的网页操作效率。
