
OpenClaw 推荐在 Windows 上通过 WSL2(Windows Subsystem for Linux 2) 运行,建议使用 Ubuntu 发行版。CLI 和 Gateway 运行在 Linux 环境中,这样可以保持运行时的一致性,并使工具链(Node/Bun/pnpm、Linux 二进制文件、技能包)具有更好的兼容性。
虽然原生 Windows 支持可能会更复杂,但 WSL2 为您提供了完整的 Linux 体验——只需一条命令即可安装。
注意: 原生 Windows 配套应用正在计划中。
以管理员身份打开 PowerShell,执行:
如果想指定特定的发行版(推荐 Ubuntu 24.04):
如果 Windows 提示需要重启,请重启计算机以完成 WSL2 安装。
重启后,从开始菜单启动 Ubuntu,系统会要求您:
- 创建 Linux 用户名
- 设置密码
完成后,您就进入了 Ubuntu 终端环境。
OpenClaw 的 Gateway 服务需要 systemd 支持。
在 Ubuntu 终端中执行:
回到 Windows PowerShell 执行:
重新打开 Ubuntu 终端,验证 systemd 是否正常运行:
如果看到服务列表输出,说明配置成功。
在 WSL Ubuntu 终端中执行:
按照交互式提示完成初始配置。
Gateway 是 OpenClaw 的核心服务组件。有多种安装方式:
在提示时选择 “Gateway service”。
如果遇到问题,可以运行诊断工具:
WSL2 拥有独立的虚拟网络。如果您需要从其他设备访问 WSL 内运行的服务(如 SSH、本地 TTS 服务器或 Gateway),必须将 Windows 端口转发到 WSL 的 IP 地址。
注意: WSL 的 IP 地址在每次重启后会变化,因此可能需要刷新转发规则。
以管理员身份打开 PowerShell,执行以下脚本:
每次 WSL 重启后,需要刷新端口转发规则:
- 局域网访问: 使用 允许局域网访问;使用 仅限本机访问
- 远程连接示例: (使用 Windows 主机的 IP 地址)
- Gateway 配置: 远程节点必须指向可访问的 Gateway URL(不能是 ),使用 确认配置
- 自动化: 可以创建 Windows 计划任务,在登录时自动运行刷新脚本
确保您的 Windows 版本支持 WSL2(Windows 10 版本 2004 及更高版本,或 Windows 11)。
检查 配置是否正确,并确保执行了 。
- 确认 Windows 防火墙规则已添加
- 检查 WSL IP 地址是否正确:
- 使用 查看当前转发规则
运行诊断工具:
项目地址:https://github.com/openclaw/openclaw
到此这篇关于OpenClaw 在 Windows 上的完整安装教指南的文章就介绍到这了,更多相关Windows OpenClaw安装内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/238667.html