Windows

在 Windows 10 / 11 上安装、更新、作为计划任务 / Windows 服务运行以及卸载。

setup.bat 是 install.sh 的 Windows 对应版本——功能相同，只是使用的 Shell 不同。如果您正在运行 WSL2，可以改用 Linux 安装指南；install.sh 在 WSL 下可直接运行。

安装

选项 1 — 来自发布的 `setup.bat`

下载最新的 ZeroClaw 版本，解压并运行：

setup.bat

标志：

标志	行为
`--prebuilt`	从 GitHub Releases 下载预构建的二进制文件（最快——无需 Rust 工具链）
`--minimal`	Build core only (`--no-default-features`; no channels, no hardware)
`--standard`	使用常用频道（Telegram、Discord、Slack、Matrix）进行构建
`--full`	构建所有内容

脚本：

检查 rustup；如果缺失，则下载 rustup-init.exe 并安装稳定版工具链
构建（或下载）二进制文件
Installs to %USERPROFILE%\.zeroclaw\bin\zeroclaw.exe
Prints mode-specific next steps:
- --prebuilt, --standard, --full: run zeroclaw onboard
- --minimal: onboarding is unavailable; configure %USERPROFILE%\.zeroclaw\config.toml manually and use the reduced CLI path (zeroclaw agent ...)

For source builds, setup.bat now prints the exact cargo build ... command it executes and reports the installed zeroclaw.exe size so command shape and artifact expectations stay visible.

选项 2 — Scoop

scoop install zeroclaw
zeroclaw onboard

选项 3 — 从源代码

需要 Rust（rustup）和 Visual Studio 构建工具：

git clone https://github.com/zeroclaw-labs/zeroclaw
cd zeroclaw
cargo install --locked --path .
zeroclaw onboard

系统依赖

Windows 构建使用 MSVC 工具链。你需要：

Visual Studio Build Tools（或完整的 Visual Studio），并安装“使用 C++ 的桌面开发”工作负载
Rust 稳定版（通过 rustup）

如果您使用的是 --prebuilt，则无需 Rust 工具链——该二进制文件是自包含的。

作为服务运行

Windows 提供两种选项：计划任务（用户会话）或 Windows 服务（系统会话）。

计划任务（推荐用于单用户计算机）

zeroclaw service install
zeroclaw service start

这将创建一个在您的用户账户下运行并在登录时启动的任务。通过任务计划程序（taskschd.msc）进行管理。

日志文件位于 %LOCALAPPDATA%\ZeroClaw\logs\。

Windows 服务（用于服务器安装）

作为真正的服务运行需要在安装期间具有管理员权限。打开提升权限的 cmd.exe 并执行以下操作：

zeroclaw service install

以管理员身份运行时，安装程序会在 LocalSystem 下注册 Windows 服务，而不是用户作用域的定时任务。如果代理程序会访问用户作用域的资源，请考虑创建专用的服务账户。

详细信息：服务管理。

更新

从 `setup.bat` / 发布版 zip 包

重新下载最新版本并重新运行 setup.bat --prebuilt（或你最初使用的其他标志）。然后：

zeroclaw service restart

Scoop

scoop update zeroclaw
zeroclaw service restart

从源代码

cd C:\path\to\zeroclaw
git pull
cargo install --locked --path . --force
zeroclaw service restart

卸载

停止并移除服务：

zeroclaw service stop
zeroclaw service uninstall

移除二进制文件：

:: setup.bat
del "%USERPROFILE%\.zeroclaw\bin\zeroclaw.exe"

:: cargo install
del "%USERPROFILE%\.cargo\bin\zeroclaw.exe"

:: Scoop
scoop uninstall zeroclaw

移除配置和工作区（可选 — 这将删除对话历史）：

rmdir /s /q "%USERPROFILE%\.zeroclaw"
rmdir /s /q "%LOCALAPPDATA%\ZeroClaw"

注意事项

长路径。 某些 Windows 文件系统仍将路径长度限制为 260 个字符。如果在构建过程中遇到 path too long 错误，请启用长路径支持（reg add HKLM\SYSTEM\CurrentControlSet\Control\FileSystem /v LongPathsEnabled /t REG_DWORD /d 1 /f）。
SmartScreen。 未签名的二进制文件在首次启动时可能会触发 SmartScreen。在添加已签名的 MSI 之前，标准的解决方法是右键单击 → 属性 → “解除锁定”。
任务计划程序停止于空闲状态。 默认情况下，Windows 可能会在空闲或电池供电时终止计划任务。已安装的任务明确禁用了这些条件；请在“任务计划程序” → “ZeroClaw” → “属性” → “条件”中进行验证。

ZeroClaw Docs