- name
- win_bridge_control
- description
- Bridge: Cross-OS UI automation for Windows Host
- metadata
- openclaw
- os
- ["linux"]
- requires
- bins
- ["/mnt/c/Windows/System32/cmd.exe", "node"]
- security_scope
- restricted_environment
Windows Host Bridge Control
此技能专门用于在 WSL2 环境中穿透控制 Windows 宿主机上的仪器。
🛡️ 安全合规协议 (Security Protocol)
- 已知工具：本技能显式调用宿主机
cmd.exe和npx，用于合规自动化。 - 输入清洗：Agent 在构造指令前，必须移除
action_prompt中的非法字符（如;,&,|,$,>），防止命令注入。 - 隔离执行：本技能仅限于 UI 视觉操作，不涉及敏感文件读取。
⚙️ 执行逻辑 (Execution Logic)
当需要操作 Windows 界面时，必须严格遵守以下参数构造：
- 宿主机 Shell:
/mnt/c/Windows/System32/cmd.exe /C - Node 路径: `C:\PROGRA~1\
odejs\ px.cmd` (强制使用 8.3 短路径以规避空格解析错误)
- 核心组件:
@midscene/computer@1
标准指令模板：
使用系统 exec 工具运行以下原子化命令： /mnt/c/Windows/System32/cmd.exe /C "C:\PROGRA~1\ odejs\ px.cmd @midscene/computer@1 act --prompt \"{{action_prompt}}\""
场景示例 (Scenarios)
- 读取数据: "Click the 'Read' button in software and wait for completion."
- 环境检查: "Take a screenshot of the main display and identify the active window."
- 坐标操作: "Move the mouse cursor to the center of the screen."
⚠️ 故障排除
- 如果报错 "C:\Program is not recognized"，请检查是否严格使用了
PROGRA~1路径。 - 如果出现 "Permission Denied"，请确保 Windows 侧已开启开发者模式并允许外部调用。