Windows 从源代码部署 OpenClaw

Windows 从源代码部署 OpenClaw

这是一份基于真实踩坑经历的 OpenClaw Windows 部署指南。如果你也卡在 “Missing A2UI bundle assets” 或不知道怎么在 Windows 上守护进程,这篇博客应该能帮到你。


🦞 OpenClaw — 个人人工智能助手

OpenClaw安装排错笔记

彻底解决 Node.js 报错:Assertion failed: new_time >= loop->time, file srcwincore.c, line 327

本文目标:在 Windows 本地(非 WSL)完成源码编译部署,并实现开机自启 + 后台守护。


在开始之前,确保你的环境满足以下条件:

  • 操作系统:Windows 10/11(本文基于 Windows 11)
  • Node.js:v22+(推荐使用 nvm-windows 管理)
  • 包管理器:pnpm(必须,)
  • Python:3.11+(用于可选 Skills,建议创建 venv)
  • Git:用于克隆源码

建议:使用 Visual Studio 2022 Developer Command PromptPowerShell 作为终端,避免权限问题。


1. 克隆项目


2. 安装依赖


注意:如果遇到 ,运行:



这是最坑的一步。运行 或 时,大概率会报错:


问题根源

OpenClaw 使用了一个叫 的前端组件,需要通过 Bash 脚本 编译。但 Windows CMD/PowerShell 无法直接执行 Bash 脚本,且脚本内部调用了 WSL 路径(),导致各种路径报错:


解决方案:手动执行 Rolldown

既然 Bash 脚本在 Windows 上跑不起来,我们手动执行它原本的命令:


验证:检查 是否生成(约 536KB)。


解决了 A2UI 问题后,后续就顺畅了:


Onboarding 流程

  • 选择 QuickStart 模式
  • 配置默认模型(支持 OpenAI、Claude、Ollama 本地模型等)

openclaw 部署在这里插入图片描述
在这里插入图片描述

  • 选择聊天渠道(Telm/D*d 等,可先 Skip)
  • 完成配置后会显示 Dashboard URL

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

在这里插入图片描述

在这里插入图片描述
在这里插入图片描述

OpenClaw 是一个常驻服务(Gateway),需要保持运行。我们不能一直开着 那个黑窗口。

1. 安装 PM2(本地安装)

注意:pnpm 的全局安装在 Windows 上配置复杂,建议在项目本地安装:


2. 使用 PM2 启动


预期看到:


3. 保存配置


4. 设置 Windows 开机自启(关键)

坑点: 在 Windows 上会报错 ,因为 PM2 的 startup 脚本是为 Linux systemd 设计的。

解决方案:使用 Windows 任务计划程序(Task Scheduler)。

管理员身份运行 PowerShell:


效果

  • 开机后自动启动 OpenClaw
  • 后台运行,无黑窗口(WindowStyle Hidden)
  • 使用 PM2 守护,崩溃自动重启

1. 检查服务状态


2. 访问控制面板

浏览器打开:


或使用 CLI 打开:


3. 配置聊天渠道(可选)

以 Telegram 为例:



OpenClaw 在 Windows 上的部署主要有三个痛点:

  1. A2UI Bundle 编译:Bash 脚本不兼容 Windows,需手动执行 +
  2. 进程守护:不要尝试 或 Windows Service,用 PM2 本地安装 + 任务计划程序 最稳
  3. 路径问题:项目放在非系统盘(如 J 盘)完全没问题,但确保所有命令都在项目目录下执行

最终架构

  • Gateway: PM2 守护()
  • 自启: Windows Task Scheduler 调用
  • 访问: Web UI

现在你可以关闭所有终端,重启电脑,OpenClaw 会自动在后台运行。打开浏览器,开始你的 AI 代理之旅吧!🦞


参考资料

  • OpenClaw 官方文档:https://docs.openclaw.ai
  • PM2 Windows 部署:https://pm2.keymetrics.io/docs/usage/startup/
  • Rolldown 配置修复:手动指定 参数绕过 Bash 脚本
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/252757.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 下午4:30
下一篇 2026年3月13日 下午4:31


相关推荐

关注全栈程序员社区公众号