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 のサービスパス規約に従うため、ワークスペースは ~/.zeroclaw/ ではなく $HOMEBREW_PREFIX/var/zeroclaw/ 配下に置かれます。これが重要な理由については サービス管理 を参照してください。
NixOS
複数インスタンスに対応した NixOS モジュールがツリー内に同梱されています。NixOS を参照してください。
cargo binstall と nix run に関する注意
どちらもまだ動作しません。cargo binstall zeroclaw は crates.io からクレートのメタデータを解決しますが、ZeroClaw はそこに公開されていない（publish = false）ため、取得できるものがありません。nix run github:zeroclaw-labs/zeroclaw は、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 |
ハードウェア機能（Pi 上の 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 / Raspberry Pi
Raspberry Pi や同様の SBC では、ハードウェア機能を使用してビルドします：
sh
./install.sh --source --features hardware
root として実行せずにハードウェアへアクセスするには、サービスユーザーが gpio、spi、i2c グループに所属している必要があります。zeroclaw service install が書き込むユーザーレベルのユニットではこれらは設定されません。SupplementaryGroups=gpio spi i2c を含むシステムレベルの Pi ユニットテンプレート scripts/zeroclaw.service を使用してください。いずれの場合も、ユーザーがこれらのグループに所属していることを確認してください:
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