2026年OpenClaw 在 Windows 上的完整安装指南

OpenClaw 在 Windows 上的完整安装指南div id navCategory div p style text align center p

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 
  
    
    

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)。

检查 配置是否正确,并确保执行了 。

  1. 确认 Windows 防火墙规则已添加
  2. 检查 WSL IP 地址是否正确:
  3. 使用 查看当前转发规则

运行诊断工具:

项目地址:https://github.com/openclaw/openclaw

到此这篇关于OpenClaw 在 Windows 上的完整安装教指南的文章就介绍到这了,更多相关Windows OpenClaw安装内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!

小讯
上一篇 2026-03-16 20:17
下一篇 2026-03-16 20:15

相关推荐

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