本文将详细讲解如何通过简单操作，让Hermes Agent直接操控本机已安装的Chrome浏览器。指南适配macOS、Windows + WSL两种主流环境，操作步骤清晰易懂、可直接落地，兼顾实操性与实用性，同时明确关键注意事项，帮助大家规避操作失误、顺利完成配置。

一、macOS 环境操作步骤

步骤1：启动Chrome调试模式

打开本机终端，复制并运行以下命令，启动Chrome远程调试模式：

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
 --remote-debugging-port=9222 \
 --user-data-dir="$HOME/.chrome-debug-profile" \
 --no-first-run \
 --no-default-browser-check

说明：--user-data-dir 参数会指定独立的浏览器配置文件，专门用于Hermes Agent操控，与日常使用的Chrome配置（书签、账号、插件等）完全隔离，互不影响。

等待Chrome浏览器窗口自动弹出后，即可进入下一步操作。

步骤2：Hermes 连接本地Chrome

打开Hermes Agent，在输入框中输入以下指令，完成与Chrome浏览器的连接：

/browser connect ws://localhost:9222

步骤3：验证连接有效性

连接成功后，可输入任意操控指令进行测试，示例指令如下：

打开 https://www.baidu.com，搜索"今天成都的天气怎么样？"，把搜索到的第一个结果告诉我。

---

二、Windows + WSL 环境操作步骤

步骤1：在PowerShell中启动Chrome调试模式

打开Windows系统的PowerShell（以管理员身份运行更佳），复制并执行以下命令，启动Chrome调试模式：

& "C:\Program Files\Google\Chrome\Application\chrome.exe" `
 --remote-debugging-port=9222 `
 --remote-debugging-address=0.0.0.0 `
 --user-data-dir="C:\ChromeForHermes"

步骤2：配置WSL镜像网络

为实现WSL环境与Windows本地Chrome的正常通信，需配置WSL镜像网络，该操作仅需执行一次，后续无需重复操作：

• 找到Windows用户目录（路径：C:\Users\<你的用户名>\），在该目录下查找或新建 .wslconfig 文件（注意文件无后缀名）；

• 打开 .wslconfig 文件，添加以下内容并保存：

[wsl2]
networkingMode=mirrored

3. 回到PowerShell，输入以下命令重启WSL，使网络配置生效：

wsl --shutdown

步骤3：Hermes 连接本地Chrome

启动WSL终端，打开Hermes Agent，输入以下指令，即可完成与Windows本地Chrome浏览器的连接：

/browser connect ws://localhost:9222

三、关键注意事项

• 两个环境中，--user-data-dir 参数均用于指定独立的Chrome配置目录，核心目的是隔离日常使用与Hermes操控的浏览器环境，防止二者相互干扰，确保原有浏览器配置不丢失、不被篡改。

• Windows系统环境下，必须添加 --remote-debugging-address=0.0.0.0 参数，该参数的作用是允许WSL环境正常访问Windows本地的Chrome调试端口。需注意，该配置仅在本机内部使用时安全，无需担心外部非法访问风险。

• WSL镜像网络配置为一次性操作，配置完成并重启WSL使设置生效后，后续每次进行连接操作时，无需重复配置该网络，直接执行Chrome调试模式启动指令和Hermes连接指令即可。

• 所有操作前，请确保Chrome浏览器已在本机正常安装，且实际安装路径与本文指令中的路径保持一致；若你的Chrome安装路径不同，请同步修改指令中对应的浏览器路径，避免因路径错误导致操作失败。