【开源】2 分钟在 Windows 上搭建 AI Agent 运行环境:MachineY Engine 使用指南

【开源】2 分钟在 Windows 上搭建 AI Agent 运行环境:MachineY Engine 使用指南

最近在 Windows 上用 OpenClaw 跑 AI Agent,光是搭环境就折腾了大半天。相信不少 Windows 开发者也有同样的痛苦——AI Agent 框架基本都活在 Linux 生态里,Windows 用户永远是二等公民。

于是我做了 MachineY Engine,一个预装 OpenClaw 的 WSL2 发行版,把环境搭建从 30 分钟压缩到 2 分钟。项目已开源。

手动搭建需要 9 步:

步骤 操作 耗时 出错率 1 启用 WSL2 2min 可能要重启 2 安装 Ubuntu 5min 下载 600MB 3 更新系统 apt update 3min 4 安装 Node.js 22 5min 版本容易搞错 5 npm install -g openclaw 5min 原生模块编译失败率极高 6 安装 build-essential 重试 5min 7 创建专用用户加配权限 3min 安全最佳实践 8 配置 systemd 服务 3min 9 配置 API Key 1min

其中第 5 步是重灾区——OpenClaw 依赖原生 Node.js 模块,没有 build-essential、python3、cmake 就编不过。

前置条件

  • Windows 10/11(需启用 WSL2)
  • Docker Desktop(已安装)

步骤 1:拉取镜像并导出

步骤 2:安装

双击 machiney-engine.wsl 文件,Windows 会自动识别并安装。

或命令行安装:

OOBE 会自动完成:创建受限用户、初始化 OpenClaw、生成 Gateway Token、启动服务。

步骤 3:配置 API Key

整个过程:2 分钟,零手动配置。

诚实说明安全来自两部分:

OpenClaw 自带(非 MachineY 的功劳)

  • Token 认证:Gateway API 必须携带 Token
  • 回环绑定:Gateway 只监听 127.0.0.1

MachineY 额外提供

  • WSL 文件隔离:automount=false,Agent 看不到 Windows C 盘
  • WSL 进程隔离:interop=false,Agent 无法调用 .exe
  • 用户限制:claw_agent 受限用户,无法 sudo 安装软件

总结:OpenClaw 保护 API 安全,MachineY 保护 system 隔离。

Docker 容器默认是临时的、不支持 systemd。WSL2 发行版天然持久、原生 systemd、双击安装、自动创建开始菜单快捷方式。

Mac/Linux 用户可以直接 docker run machiney/engine 使用,不需要 WSL。

  • GitHub: https://github.com/Reidston/machiney-engine
  • Docker openclaw docker 教程 Hub: https://hub.docker.com/r/machiney/engine
  • 协议: Apache 2.0
  • 镜像大小: 238 MB (压缩)

MachineY Engine 解决的核心问题很简单:让 Windows 开发者用最少的时间跑起 AI Agent。

机器小乙 (MachineY) — 让你成为工作的甲方。

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

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

(0)
上一篇 2026年3月15日 下午12:44
下一篇 2026年3月15日 下午12:44


相关推荐

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