macOS

在 macOS（Intel 或 Apple Silicon）上安装、更新、作为 LaunchAgent 运行以及卸载。

安装

./install.sh

这就是全部安装过程。可以从克隆仓库中运行它，或通过 curl 管道执行：

sh

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh

规范的安装路径介绍了快速和引导式路径、源码回退、应用选择、PATH 传递以及接下来的 Quickstart 步骤。

Homebrew

sh

brew install zeroclaw

提供 brew services 集成。二进制文件位于 $HOMEBREW_PREFIX/bin/zeroclaw。

工作区位置注意事项： 使用 Homebrew 时，服务用户和 CLI 用户可能不同，因此工作区位于 $HOMEBREW_PREFIX/var/zeroclaw/ 而不是 ~/.zeroclaw/。请将 CLI 调用指向相同的工作区：

sh

export ZEROCLAW_WORKSPACE="$HOMEBREW_PREFIX/var/zeroclaw"

如果希望永久生效，请将其添加到您的 shell 配置文件中。

系统依赖

大多数功能在标准 macOS 安装中即可使用。可选的额外功能：

功能	安装
文档翻译	`brew install gettext`
浏览器工具	Playwright 会在首次使用时自动拉取 Chromium
硬件	macOS 上没有原生 GPIO；请使用通过 USB 连接的开发板。请参阅硬件
iMessage 通道	需要 macOS 11 或更高版本。请参阅 Channels → 其他聊天平台

作为服务运行

sh

zeroclaw service install   # 写入 ~/Library/LaunchAgents/com.zeroclaw.daemon.plist
zeroclaw service start
zeroclaw service status

日志保存在 ~/.zeroclaw/logs/（Homebrew 安装：$HOMEBREW_PREFIX/var/zeroclaw/logs/）：

sh

tail -f ~/.zeroclaw/logs/daemon.stdout.log

对于 Homebrew 安装，推荐使用：

sh

brew services start zeroclaw
brew services info zeroclaw

两种方法产生的最终状态相同，都是一个在登录时启动的已加载 LaunchAgent。选择一种并坚持使用。

详细信息：服务管理。

更新

重新运行安装程序，它会检测到现有安装并就地升级：

sh

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh -s -- --skip-quickstart
zeroclaw service restart

或者从克隆版本中：

sh

cd /path/to/zeroclaw
git pull
./install.sh --skip-quickstart
zeroclaw service restart

如果通过 Homebrew 安装：

sh

brew update && brew upgrade zeroclaw
brew services restart zeroclaw

卸载

sh

# 停止并注销服务
zeroclaw service stop
zeroclaw service uninstall

# Homebrew
brew uninstall zeroclaw

# bootstrap / cargo
rm ~/.cargo/bin/zeroclaw

删除配置和工作区（可选：此操作会删除对话历史记录）：

sh

# Homebrew 工作区
rm -rf "$HOMEBREW_PREFIX/var/zeroclaw"

# 默认工作区（日志位于 ~/.zeroclaw/logs）
rm -rf ~/.zeroclaw ~/.config/zeroclaw

注意事项

Homebrew 配置路径不匹配。 brew services 守护进程从 $HOMEBREW_PREFIX/var/zeroclaw/ 读取配置，而不是 ~/.zeroclaw/。如果你的服务读取的是过时的配置，请检查守护进程实际看到的是哪个路径，并相应地设置 ZEROCLAW_WORKSPACE。
首次启动浏览器工具会通过 Playwright 下载 Chromium（约 150 MB）。
**Apple Silicon 和 Intel：**引导脚本会检测架构，并在有可用的匹配预构建发布构件时使用它。如果该发布版本没有匹配的构件，则回退到从源代码构建。Homebrew 会为主机选择适当的软件包。

ZeroClaw Docs