Linux
安装、更新、作为服务运行以及卸载，适用于所有 Linux 发行版。
安装
./install.sh
这就是全部安装过程。可以从克隆仓库中运行它，或通过 curl 管道执行：
sh
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh
规范的安装路径介绍了快速和引导式路径、源码回退、应用选择、PATH 传递以及接下来的 Quickstart 步骤。
Homebrew (Linuxbrew)
sh
brew install zeroclaw
Homebrew-on-Linux 安装遵循 Homebrew 的服务路径约定，你的工作区位于 $HOMEBREW_PREFIX/var/zeroclaw/ 下，而不是 ~/.zeroclaw/。请参阅服务管理了解这一点为何重要。
NixOS
上游 flake 提供 ZeroClaw CLI。在启用 Nix 和 flakes 的情况下：
nix run github:zeroclaw-labs/zeroclaw -- --version
See NixOS 了解源码构建、Nixpkgs 软件包以及多实例 NixOS 服务模块。如需预编译二进制文件,请使用上文所述的安装程序。
系统依赖
核心二进制文件在可能的情况下是静态链接的。某些功能需要系统库：
| 功能 | 软件包（Debian/Ubuntu） | 包 (Arch) | 软件包（Fedora） |
|---|---|---|---|
文档翻译（cargo mdbook sync） | gettext | gettext | gettext |
| 浏览器工具（Playwright） | libnss3、libatk1.0-0、libcups2（参见 playwright --help） | nss、atk、cups | nss、atk、cups |
| 音频（TTS、语音频道） | libasound2-dev | alsa-lib | alsa-lib-devel |
硬件功能（树莓派上的 GPIO / I2C / SPI）使用纯 Rust 编写的 rppal 驱动，无需额外的系统库；它直接与 /dev/gpiomem、/dev/spidev* 和 /dev/i2c-* 通信。它确实需要的是设备访问权限：启用 SPI/I2C 接口，并将服务用户加入 gpio、spi 和 i2c 组（参见下文 SBC / Raspberry Pi）。
大多数部署不需要这些。
作为服务运行
Systemd 是默认选项。OpenRC 会被检测并作为备用方案支持。
sh
zeroclaw service install
zeroclaw service start
zeroclaw service status
日志默认会写入 systemd 日志：
sh
journalctl --user -u zeroclaw -f
详细信息：服务管理。
SBC / 树莓派
在树莓派或类似的单板计算机（SBC）上，使用硬件特性进行构建：
sh
./install.sh --source --features hardware
为了在不以 root 身份运行的情况下访问硬件，服务用户需要加入 gpio、spi 和 i2c 组。zeroclaw service install 写入的用户级单元不会设置这些组；请使用位于 scripts/zeroclaw.service 的系统级 Pi 单元模板，其中包含 SupplementaryGroups=gpio spi i2c。无论采用哪种方式，请确认你的用户已加入这些组：
sh
getent group gpio spi i2c
sudo usermod -aG gpio,spi,i2c $USER
# 重新登录以使组更改生效
更新
标准发布版本同时附带 minimal 和 full 两种工具设置对应的原生适配器。对于新安装和现有安装（包括没有 [tools] 的配置），full 仍是默认设置。minimal 设置在 Chat 中提供 11 个工具，在 Code/ACP 中提供 8 个工具，需要通过 optional = [] 主动启用。显式选择会被保留；具名条目用于选择单个可选扩展。full 保留现有集成的前置条件和权限控制。仅使用 Cargo 默认特性的源码构建（包括仅使用这些默认特性的 Homebrew formula）仍可能不包含适配器。参见 minimal/full 工具与构建恢复。
重新运行安装程序，它会检测到现有安装并就地升级：
sh
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh -s -- --skip-quickstart
或者从克隆版本中：
sh
cd /path/to/zeroclaw
git pull
./install.sh --skip-quickstart
如果通过 Homebrew 安装：
sh
brew update && brew upgrade zeroclaw
更新后，重启服务：
sh
zeroclaw service restart
卸载
如果你使用引导脚本进行安装，请使用同一脚本进行卸载：
sh
./install.sh --uninstall
停止并移除服务：
sh
zeroclaw service stop
zeroclaw service uninstall
移除二进制文件：
sh
# cargo install / 引导
rm ~/.cargo/bin/zeroclaw
# Homebrew
brew uninstall zeroclaw
删除配置和工作区（可选：此操作会删除对话历史记录）：
sh
rm -rf ~/.zeroclaw ~/.config/zeroclaw