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
The upstream flake provides the ZeroClaw CLI. With Nix and flakes enabled:
Wait, that’s not quite right. Let me restate what I’m producing: the Japanese translation of that sentence.
上流の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 |
ハードウェア機能（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
# グループの変更を反映させるために再ログインしてください
更新
標準リリースのアップデートには、minimal と full の両方のツール設定に対応するネイティブアダプターが含まれます。full は、新規インストールおよび既存のインストールの両方でデフォルトのまま維持され、[tools] のない構成も含まれます。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