先决条件¶

ZeroClaw 需要一些依赖才能正常构建和运行。根据您的操作系统选择相应的安装步骤。

Windows¶

必需的依赖¶

1. Visual Studio Build Tools¶

提供 MSVC 链接器和 Windows SDK：

winget install Microsoft.VisualStudio.2022.BuildTools

在安装过程中（或通过 Visual Studio Installer），选择 "使用 C++ 的桌面开发" 工作负载。

2. Rust 工具链¶

winget install Rustlang.Rustup

安装后，打开新的终端并运行 rustup default stable 以确保使用稳定工具链。

3. 验证安装¶

rustc --version
cargo --version

可选依赖¶

• Docker Desktop - 仅在使用 Docker 沙盒运行时（runtime.kind = "docker"）时需要。通过 winget install Docker.DockerDesktop 安装。

Linux / macOS¶

必需的依赖¶

1. 构建工具包¶

Linux (Debian/Ubuntu):

sudo apt install build-essential pkg-config

Linux (Fedora/RHEL):

sudo dnf groupinstall "Development Tools" && sudo dnf install pkg-config

macOS: 安装 Xcode Command Line Tools：

xcode-select --install

2. Rust 工具链¶

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

详情请参阅 rustup.rs。

3. 验证安装¶

rustc --version
cargo --version

可选依赖¶

• Docker - 仅在使用 Docker 沙盒运行时（runtime.kind = "docker"）时需要。通过您的包管理器或 docker.com 安装。

注意: 默认的 cargo build --release 使用 codegen-units=1 以兼容低内存设备（例如 1GB RAM 的 Raspberry Pi 3）。为了在强大的机器上更快构建，请使用 cargo build --profile release-fast。

验证环境¶

安装完上述依赖后，您可以运行以下命令验证环境是否正确配置：

# 检查 Rust 工具链
rustc --version
cargo --version

# 检查构建工具
# Linux/macOS
gcc --version

# Windows
cl --version  # 需要在 Developer Command Prompt 中运行

故障排除¶

OpenSSL 错误（Linux）¶

如果在构建时遇到 openssl-sys 错误：

git pull
cargo build --release --locked
cargo install --path . --force --locked

ZeroClaw 配置为对 HTTP/TLS 依赖使用 rustls；--locked 保持传递图在新环境中确定性。

Python 版本兼容性¶

ZeroClaw 的 Python 工具包需要 Python 3.7+。要检查您的 Python 版本：

python3 --version

下一步¶

环境准备好后，您就可以开始快速入门了。