跳到主要内容

以下是翻译后的内容:

针对 Windows 上 WSL 用户的注意事项

OpenHands 仅通过 WSL 支持 Windows。 请确保在您的 WSL 终端内运行所有命令。

故障排除​

建议: 不要以 root 用户身份运行​

出于安全原因,强烈建议不要以 root 用户身份运行 OpenHands,而是以具有非零 UID 的用户身份运行。

参考:

错误: 在此 WSL 2 发行版中找不到 'docker'。​

如果您正在使用 Docker Desktop,请确保在从 WSL 内部调用任何 docker 命令之前启动它。 Docker 还需要激活 WSL 集成选项。

Poetry 安装​

  • 如果您在构建过程中安装 Poetry 后仍然面临运行 Poetry 的问题,您可能需要将其二进制路径添加到环境中:
export PATH="$HOME/.local/bin:$PATH"
  • 如果 make build 在如下错误上停止:
ModuleNotFoundError: no module named <module-name>

这可能是 Poetry 缓存的问题。 尝试依次运行这两个命令:

rm -r ~/.cache/pypoetry
make build

NoneType 对象没有属性 'request'​

如果您在执行 make run 时遇到与网络相关的问题,例如 NoneType 对象没有属性 'request',您可能需要配置 WSL2 网络设置。请按照以下步骤操作:

  • 在 Windows 主机上打开或创建位于 C:\Users\%username%\.wslconfig 的 .wslconfig 文件。
  • 将以下配置添加到 .wslconfig 文件中:
[wsl2]
networkingMode=mirrored
localhostForwarding=true
  • 保存 .wslconfig 文件。
  • 通过退出任何正在运行的 WSL2 实例并在命令提示符或终端中执行 wsl --shutdown 命令来完全重启 WSL2。
  • 重新启动 WSL 后,再次尝试执行 make run。 网络问题应该得到解决。