hermes agent自动化需完成四步:安装启用浏览器扩展、启用browser_automation工具集、配置本地服务与驱动(chromium/puppeteer/playwright)、绑定后端服务并授予目标网站权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让Hermes Agent自动打开网页、点击按钮、填写表单并提取结构化数据,而不是手动复制粘贴或写Python爬虫脚本。这需要打通浏览器扩展、本地服务、权限配置与工具链调用四个关键环节,缺一不可。
安装并启用Hermes浏览器扩展
浏览器扩展是所有自动化操作的入口,没有它,后续指令无法注入页面上下文。
访问Chrome Web Store 或 Hermes 官方发布页,下载最新版【.crx 文件】;在 chrome://extensions/ 页面开启“开发者模式”,将 .crx 文件直接拖入页面完成安装。
安装后检查工具栏右上角是否出现 Hermes 图标,点击图标确认状态为“已启用”——【若显示灰色或无响应,说明扩展未激活,所有 browser_* 指令都会静默失败】。
启用浏览器自动化工具集
扩展只是通道,真正执行操作的是内置的 browser_automation 工具集,必须显式启用才能调用 browser_navigate、browser_click 等函数。
在项目根目录下执行命令 hermes tools 进入交互式插件配置界面。
使用方向键导航至 browser_automation 选项,按空格键勾选启用,再按回车确认提交。
等待终端显示 Plugin browser_automation loaded successfully 提示;随后执行 hermes config get tools.browser_automation.enabled 验证返回值为 true。
配置本地服务与浏览器驱动
方法一:自动安装 Chromium(推荐新手)
运行 agent-browser install,该命令会自动下载并缓存无头 Chromium 二进制文件。国内网络不稳定时可能中断,此时需切换镜像源。
方法二:手动指定国内镜像安装 Puppeteer
进入 site-packages/hermes_agent/plugins/browser_automation/ 目录,执行:
PUPPETEER_DOWNLOAD_HOST=https://npmmirror.com/mirrors npm install puppeteer@22.5.0
方法三:改用 Playwright(更轻量、兼容性更好)
执行 PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors npx playwright install chromium。
启动后端服务并绑定扩展
第一步:在终端执行 hermes start,等待输出中出现 Listening on http://127.0.0.1:8080——这是默认监听地址,【端口号必须与扩展设置完全一致】。
第二步:进入 chrome://extensions/ → 点击 Hermes 扩展右侧“详情” → 滚动到底部点击“扩展选项” → 在“后端地址”栏填入 http://127.0.0.1:8080 → 点击“保存配置”。
第三步:看到绿色“连接成功”提示条后,关闭并重新打开一个新标签页,强制刷新扩展上下文。
授予目标网站访问权限
浏览器会拦截未经许可的 DOM 读写请求,这是安全机制,不是 bug。
① 在 chrome://extensions/ 页面中,找到 Hermes 扩展条目,点击“详情”。
② 向下滚动至“站点访问权限”区域。
③ 选择“在以下网址上启用”,手动添加目标域名,例如 https://example.com、https://news.example.com。
④ 关闭并重新打开任意网页标签页,使权限变更即时生效。
注意:不要选“在所有网站上启用”,否则扩展可能在银行、邮箱等敏感页面意外触发脚本。











