WSL + Windows 跨系统 spawn 失败

[yjc6456]

Title: [Bug] Bridge cannot spawn agent CLI on WSL when agent binary is Windows executable

Environment:

• Bridge runs in WSL2 (Ubuntu)
• OpenClaw CLI installed on Windows (npm, C:\Users\xxx\AppData\Roaming\npm\openclaw.cmd)
• Bridge config: command: openclaw

Expected: Bridge spawns OpenClaw ACP agent successfully
Actual: spawn fails silently, alive=0, no error in bridge log

Root cause: asyncio.create_subprocess_exec cannot execute Windows .cmd from WSL

[xiwan]

感谢反馈！这个问题的根因是操作系统层面的限制：

原因

WSL2 中的 Linux 进程（asyncio.create_subprocess_exec）无法直接执行 Windows 的 .cmd 文件。这不是 Bridge 的 bug，而是 WSL/Windows 进程模型不兼容。

解决方案

推荐：在 WSL 内安装 agent CLI

# WSL 内安装 OpenClaw
npm install -g openclaw

# 验证
which openclaw  # 应该指向 /usr/local/bin/openclaw 或类似路径

这样 Bridge 和所有 agent 都在同一个 Linux 环境中运行，不存在跨系统调用问题。

备选：通过 cmd.exe 包装调用

如果必须用 Windows 侧的 CLI，可以在 config.yaml 中这样配置：

openclaw:
  command: "cmd.exe"
  acp_args: ["/c", "openclaw", "mcp", "serve", "--url", "ws://..."]

但这条路比较 hacky，可能有 stdin/stdout 编码问题，不推荐。

关于静默失败

Bridge 目前在 spawn 失败时日志不够明确，这个可以改进——加一条 warning 日志输出具体的错误原因。后续版本会优化这里的错误提示。

如果在 WSL 内安装 CLI 后还有问题，欢迎继续反馈！