WSL Hermes → Windows cua-driver MCP 桥接方案（精简版）

版本：v1.1 | 最后更新：2026-06-29 | 作者：徐砚

⚠️ 本方案尚在验证中。以下只记录已确认的操作步骤，未经验证的流程已全部移除。

背景

WSL 内的 cua-driver（Linux 版）只能操控 WSLg/Weston 虚拟显示，无法控制 Windows 原生桌面。需要在 Windows 上原生跑 cua-driver，从 WSL 的 Hermes 调用。

前提条件

阶段一：Windows 端安装 cua-driver

1. 安装（通过 Hermes 安装脚本）

以 管理员身份 打开 PowerShell，执行：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

如需指定安装路径，先设环境变量：

$env:HERMES_HOME = "D:\Soft\Hermes"
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

此脚本会安装 Hermes CLI + cua-driver Windows 构建。

2. 验证安装

cua-driver --version          # 确认 0.6.8+
cua-driver doctor             # 确认所有检查项通过

3. 设为开机自启

cua-driver autostart enable   # 注册 Windows 计划任务，登录时自动启动 serve daemon
cua-driver autostart kick     # 立即启动，不用注销

4. 验证 daemon 运行

cua-driver status             # 输出 running，表示 daemon 正常运行

5. 停止 daemon

cua-driver stop               # 停止 daemon

已知信息

• cua-driver daemon 运行后监听 命名管道\\.\pipe\cua-driver
• cua-driver serve不支持--host / --port 参数开启 TCP 模式
• cua-driver 二进制位置：C:\Users\<用户名>\.cua-driver\packages\releases\0.6.8-x86_64-pc-windows-msvc\cua-driver.exe

待验证：WSL ↔ Windows 通信桥接

目前卡点： cua-driver Windows 版只走命名管道（\\.\pipe\cua-driver），WSL 无法直接访问 Windows 命名管道。需要中间桥接层将命名管道转为 TCP。

已尝试但失败的路：

• ❌ winget install socat — 安装失败
• ❌ cua-driver serve --host 127.0.0.1 --port 8311 — 该参数不存在
• ❌ WSL 侧 socat TCP-LISTEN 自循环 — 仅在 WSL 内本地转发，未到达 Windows

待验证的候选方案：

• PowerShell 原生桥接脚本（零安装依赖，利用 .NET 的 TcpListener + NamedPipeClientStream）
• Windows Python 桥接脚本（利用 Python ctypes 调用 Win32 API 连接命名管道）
• ncat 或其他 Windows 原生 TCP 工具

此部分确认可行后会更新文档。

版本历史

本文由 admin 原创，转载请注明出处。