macOS

macOS（Intel または Apple Silicon）でインストール、更新、LaunchAgent として実行、およびアンインストールを行います。

インストール

./install.sh

これでインストールは完了です。クローンから実行するか、curl でパイプ処理してください。

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

標準のインストールパスでは、高速な手順とガイド付きの手順、ソースへのフォールバック、アプリの選択、PATH の引き継ぎ、次の Quickstart の手順について説明しています。

Homebrew

brew install zeroclaw

brew services の統合を提供します。バイナリは $HOMEBREW_PREFIX/bin/zeroclaw に配置されます。

ワークスペースの場所に関する注意点: Homebrew では、サービスユーザーと CLI のユーザーが異なる場合があります。そのため、ワークスペースは ~/.zeroclaw/ ではなく $HOMEBREW_PREFIX/var/zeroclaw/ に配置されます。CLI の呼び出しを同じワークスペースを指すようにしてください。

export ZEROCLAW_WORKSPACE="$HOMEBREW_PREFIX/var/zeroclaw"

永続化したい場合は、シェルのプロファイルに追加してください。

システム依存関係

ほとんどの機能は標準のmacOSインストールで動作します。オプションの追加機能:

サービスとして実行

zeroclaw service install   # ~/Library/LaunchAgents/com.zeroclaw.daemon.plist に書き込み
zeroclaw service start
zeroclaw service status

ログは ~/.zeroclaw/logs/ に出力されます（Homebrew でインストールした場合: $HOMEBREW_PREFIX/var/zeroclaw/logs/）:

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

Homebrew のインストールでは、以下を優先してください:

brew services start zeroclaw
brew services info zeroclaw

どちらの方法でも、ログイン時に起動するロード済みのLaunchAgentという同じ最終状態になります。どちらか1つを選んで、それを使い続けてください。

詳細については、サービス管理をご覧ください。

更新

インストーラーを再実行すると、既存のインストールが検出され、その場でアップグレードされます。

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

または、クローンから:

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

Homebrew経由でインストールした場合:

brew update && brew upgrade zeroclaw
brew services restart zeroclaw

アンインストール

# サービスを停止して登録解除する
zeroclaw service stop
zeroclaw service uninstall

# Homebrew
brew uninstall zeroclaw

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

設定とワークスペースを削除（オプション：これにより会話履歴が削除されます）：

# Homebrew ワークスペース
rm -rf "$HOMEBREW_PREFIX/var/zeroclaw"

# デフォルトのワークスペース（~/.zeroclaw/logs にログを含む）
rm -rf ~/.zeroclaw ~/.config/zeroclaw

注意点

• Homebrew の設定パスの不一致。 brew services デーモンは ~/.zeroclaw/ ではなく $HOMEBREW_PREFIX/var/zeroclaw/ から設定を読み込みます。サービスが古い設定を読み込んでいる場合は、デーモンが参照しているパスを確認し、それに合わせて ZEROCLAW_WORKSPACE を設定してください。
• ブラウザツールの初回起動時に、Playwright 経由で Chromium（約 150 MB）がダウンロードされます。
• Apple Silicon および Intel: ブートストラップスクリプトはアーキテクチャを検出し、対応するビルド済みリリースアーティファクトが利用可能な場合はそれを使用します。リリースに一致するアーティファクトがない場合は、ソースビルドにフォールバックします。Homebrew はホストに適したパッケージを選択します。

次へ

• サービス管理
• クイックスタート
• 操作 → 概要