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
树内提供了一个多实例 NixOS 模块。参见 NixOS。
关于 cargo binstall 和 nix run 的说明
目前两者都尚未生效。cargo binstall zeroclaw 会从 crates.io 解析 crate 元数据，但 ZeroClaw 并未发布到那里（publish = false），因此没有任何内容可供其拉取；nix run github:zeroclaw-labs/zeroclaw 也无法启动该 agent，因为该 flake 仅暴露了开发工具链，而非可运行的软件包（#5987）。install.sh 已经实现了 binstall 本应完成的工作（下载预构建的发行版二进制文件），因此它仍然是受支持的一行命令安装方式。
系统依赖
核心二进制文件在可能的情况下是静态链接的。某些功能需要系统库：
| 功能 | 软件包（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
# 重新登录以使组更改生效
更新
重新运行安装程序，它会检测到现有安装并就地升级：
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