需依次完成Node.js v22安装、启用browser_automation插件、手动安装Puppeteer/Playwright驱动、配置系统浏览器权限，并通过截图指令验证功能就绪。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望让Hermes Agent执行网页浏览、表单填写、数据抓取等操作，但浏览器自动化插件未启用或无法响应，则可能是由于插件未正确安装、Node.js环境缺失或权限配置异常。以下是解决此问题的步骤：
一、确认并安装Node.js运行时
浏览器自动化依赖Node.js v22提供Puppeteer与Playwright底层支持，Hermes Agent默认不自带该环境，需独立验证并补全。若系统中未检测到兼容版本，插件将无法加载。
1、在终端中执行命令 node --version 检查当前Node.js版本。
2、若返回错误或版本低于v22.0.0，访问 https://nodejs.org/dist/ 下载并安装Node.js v22.x LTS版本。
3、安装完成后重新打开终端，再次运行 node --version 与 npm --version 确认两者均正常输出。
二、启用内置浏览器自动化插件
Hermes Agent通过插件机制管理浏览器能力，默认不自动激活。需显式调用配置命令触发插件注册与初始化流程，否则相关工具函数不可用。
1、在项目根目录下执行命令 hermes tools 进入交互式插件配置界面。
2、使用方向键导航至 browser_automation 选项，按空格键勾选启用。
3、按回车确认提交，等待终端显示 Plugin browser_automation loaded successfully 提示。
4、执行 hermes config get tools.browser_automation.enabled 验证返回值为 true。
三、手动安装Puppeteer或Playwright驱动
当网络受限或国内镜像未生效时，自动安装可能失败，导致浏览器实例启动报错“no browser found”。此时需切换至离线安装模式，指定国内CDN源下载二进制文件。
1、进入Hermes Agent虚拟环境，执行 pip show hermes-agent 获取安装路径。
2、切换至 site-packages/hermes_agent/plugins/browser_automation/ 目录。
3、运行 PUPPETEER_DOWNLOAD_HOST=https://npmmirror.com/mirrors npm install puppeteer@22.5.0 强制使用淘宝镜像拉取Chromium。
4、若选用Playwright，执行 PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors npx playwright install chromium。
四、配置系统级浏览器权限（macOS / Windows）
macOS Gatekeeper与Windows SmartScreen会拦截未经签名的自动化浏览器进程，导致页面空白或启动超时。必须显式授权可执行文件，否则插件始终处于挂起状态。
1、macOS用户打开“访达”，进入 /Applications/Chromium.app 或对应浏览器应用目录。
2、右键点击应用图标，选择“显示简介”，勾选底部 “仍要打开” 选项。
3、Windows用户在首次运行时若弹出SmartScreen警告，点击 “更多信息” → “仍要运行”。
4、重启Hermes Agent服务使权限变更生效。
五、验证插件功能是否就绪
仅完成安装与配置不足以确认插件可用性，必须通过最小化任务流触发真实浏览器实例，捕获渲染结果与DOM交互日志，排除静默失败场景。
1、启动交互终端：hermes。
2、输入指令：请打开 https://example.com 并截图首页，保存为 screenshot.png。
3、观察终端是否输出 [browser] launched chromium with pid XXXX 及后续截图成功提示。
4、检查当前目录是否生成 screenshot.png 文件，且图像内容可正常查看。
