クイックスタート
クイックスタートは、新規インストールから動作するエージェントまでを一度の操作で導く、ガイド付きセットアップです。これは3つのインターフェイス上で動作します。CLI、zerocode ターミナルインターフェイス、そして web gateway です。3つはすべて同じ基盤フローを動かすため、生成される設定は同一です。今いる環境に合ったものを使用してください。
インストール
Unix の高速パス
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh
このルートは非対話型で、ピッカーを開きません。
一致するビルド済みバイナリを優先し、必要に応じてソースからのビルドにフォールバックします。
ビルド済みアーカイブには zerocode が含まれている場合があります。非対話型のソースフォールバックでは、ピッカーを開かずにデフォルトアプリがインストールされます。
このコマンドでは固定の機能セットが使用されます。
ソースからのビルドが必要な場合、インストーラーは Rust がインストールされていなければ Rust をブートストラップできます。
Unix では、許可されている場合、インストーラーがシェルプロファイルを更新します。新しい PATH を利用する前に、親シェルを再読み込みしてください。
インストーラーはセットアップをスキップし、次の手順として zeroclaw quickstart を表示します。
Unix ガイド付きパス
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh
このルートはガイド付きで、サポートされている選択肢が提示される場合があります。
サポート対象のターゲットでは、ビルド済み版またはソースからのインストールを利用できます。
ビルド済みアーカイブには zerocode が含まれている場合があります。ソースを選択すると、zerocode がデフォルトで選択され、アプリを選択できます。
ソースパスでは、オプションの Cargo フィーチャーも選択できます。
ソースからのビルドが必要な場合、インストーラーは Rust がインストールされていなければ Rust をブートストラップできます。
Unix では、許可されている場合、インストーラーがシェルプロファイルを更新します。新しい PATH を利用する前に、親シェルを再読み込みしてください。
未設定のインストールでは、zeroclaw quickstart またはブラウザーベースのクイックスタートを利用できます。
Windows のビルド済みパス
Windows セットアップガイドの PowerShell ブロックを使用してください。インストールと PATH の設定は冪等で、Quickstart は引き続き実行されます。
このルートは非対話型で、ピッカーを開きません。
この方法では、ビルド済みのリリースアーカイブをインストールします。
アーカイブには zerocode も含まれている場合があります。利用できるかどうかはリリースアセットによって異なります。
このコマンドでは固定の機能セットが使用されます。
このビルド済みルートでは、Rust ツールチェーンは必要ありません。
Windows では、PowerShell のパスにより、現在のプロセスと永続的なユーザー PATH が更新されます。
PowerShell ブロックは、最後に zeroclaw quickstart を自動的に実行して終了します。
高度なソース パス
Unix
./install.sh --source
このルートはガイド付きで、サポートされている選択肢が提示される場合があります。
この方法では常にソースからビルドされます。
ソースからのインストールでは、デフォルトでzerocodeが選択され、アプリの選択を変更できます。
ソースパスでは、オプションの Cargo フィーチャーも選択できます。
ソースからのビルドが必要な場合、インストーラーは Rust がインストールされていなければ Rust をブートストラップできます。
Unix では、許可されている場合、インストーラーがシェルプロファイルを更新します。新しい PATH を利用する前に、親シェルを再読み込みしてください。
未設定のインストールでは、zeroclaw quickstart またはブラウザーベースのクイックスタートを利用できます。
Windows
cargo install --locked --path .
このルートは非対話型で、ピッカーを開きません。
この方法では常にソースからビルドされます。
このコマンドはコアの zeroclaw バイナリをインストールします。オプションのアプリはインストールしません。
このコマンドでは固定の機能セットが使用されます。
このコマンドを使用する前に Rust ツールチェーンが必要です。
この Cargo コマンドは PATH を編集しません。Cargo の bin ディレクトリがすでにシェルで利用可能になっていることを確認してください。
インストール後、zeroclaw quickstart を実行します。
手順
重要: これらの用語に馴染みがない場合は、まず Getting Started → Concepts をお読みください。モデルプロバイダー、リスクプロファイル、エイリアスなどの用語がすべて定義されています。
すべてのサーフェスは同じチェックリストに従い、同じ設定を記述します。必須ステップはエージェントを作成する前に満たされている必要があり、オプションのステップはスキップできます。
| ステップ | 必須 | 設定内容 |
|---|---|---|
| モデルプロバイダー | yes | プロバイダーファミリー（Anthropic、OpenAI、Ollama、OpenRouter、…）、その API キーまたはエンドポイント、およびモデル。 |
| リスクプロファイル | yes | 自律性とサンドボックスの設定。プリセットを選択するか、既存の [risk_profiles.<alias>] を再利用します。 |
| メモリ | yes | メモリバックエンド（sqlite、markdown、postgres、qdrant、lucid、または none）。 |
| チャネル | optional | チャットプラットフォーム（Telegram、Discord、Slack など）。組み込みの cli チャネルは常に利用可能です。その他のチャネルはここで、または後から追加できます。 |
| ピアグループ | optional | 設定したチャンネルのマルチエージェントピアメンバーシップ。 |
| エージェント | yes | エージェントのエイリアス、システムプロンプト、その他の性格ファイル。 |
ランタイムプロファイルは自動的に設定されます。Quickstart は新しいエージェント用に
unboundedプリセットをインストールします。後から[runtime_profiles.<alias>]を編集して、予算とタイムアウトを調整してください（リファレンス → 設定 を参照）。
CLI
ヘッドレスマシン上やSSH経由での最速の方法:
sh
zeroclaw quickstart
ターミナルで1ステップにつき1つのプロンプトに応答します。組み込みの cli チャネルはすぐに動作するため、Channels と Peer groups はスキップできます。すべてデフォルトで承認なしの設定については、YOLO mode を参照してください。
OpenAI Codex サブスクリプション認証
クイックスタートでは、APIキーなしでOpenAI Codexのサブスクリプションパスを設定できます。一度認証したら、プロバイダーとしてOpenAIを選択し、プロンプトが表示されたらAuthenticationをcodexに設定してください:
# すでに Codex CLI でサインインしている場合:
zeroclaw auth login --model-provider openai-codex --import ~/.codex/auth.json
# または ZeroClaw 独自の OpenAI Codex ログインフローを開始します:
zeroclaw auth login --model-provider openai-codex
スクリプト化されたセットアップでは、openai-codex はクイックスタート入力のエイリアスとして受け付けられ、正規の [providers.models.openai.<alias>] エントリを書き込みます:
zeroclaw quickstart --model-provider openai-codex --model gpt-5.4 --agent assistant
Claude サブスクリプション setup-token 認証
クイックスタートでは、通常の Console API キーまたは Claude Max で生成されたトークンを使用して、Claude/Anthropic を設定することもできます。
claude setup-token
zeroclaw quickstart --model-provider anthropic --model claude-sonnet-4-5 --agent assistant
Anthropic を選択し、認証 を setup_token に設定してから、claude setup-token からのトークンを API キー/トークンのプロンプトに貼り付けます。スクリプト入力ではエイリアスとして --model-provider claude を使用できます。Quickstart は引き続き正規の [providers.models.anthropic.<alias>] エントリを書き込みます。トークンは api_key と同じクレデンシャルパスに保存されます。
zerocode
zerocode ターミナルインターフェイスでは、Quickstart ペインがタブの 1 つです。キーボードで操作します:
Quickstart ペインに切り替えます:
| キー | 対応 |
|---|---|
Alt+← / Alt+b | 前のペイン |
Alt+→ / Alt+f | 次のペイン |
ペイン内:
| キー | 対応 |
|---|---|
k / ↑ | prev |
j / ↓ | 次へ |
Enter | 開く |
q / Esc | 退出 |
c / C | エージェントを作成 |
マウスでも操作できます。モードバーのタブをクリックしてペインを切り替えたり、ステップをクリックして選択・展開したり、スクロールしてリストを移動したりできます。
各ステップでは、上記のチェックリストを反映したモーダルが開き、設定内に既に存在する一致するエイリアスを一覧表示する「既存のものを使用」オプションが表示されます。
Webゲートウェイ
デーモンが実行されている状態で、ブラウザでダッシュボードを開きます:
sh
zeroclaw daemon
zeroclaw daemon はランタイム全体を実行します。ゲートウェイ、設定済みのチャネル、スケジューラ、およびハートビートモニターが含まれます。（HTTPゲートウェイのみが必要な場合は、zeroclaw gateway でHTTPゲートウェイだけを起動できます。）
その後、http://127.0.0.1:42617/quickstart にアクセスします。エージェントが未設定の新規インストールでは自動的にここへリダイレクトされます。それ以降は、ダッシュボードのナビゲーションからいつでもアクセスできます。
Webフォームでは同じ手順をカードとして表示します。送信すると、デーモン経由で入力内容が適用され（POST /api/quickstart/apply）、無効な箇所があれば構造化されたエラーリストが返されます。その後、デーモンがその場で再読み込みされ、再起動せずに新しいエージェントが有効になります。別のPOST /api/quickstart/validateエンドポイントは、適用せずに同じチェックを実行するため、先に検証したいクライアント向けです。
クイックスタート後
- zerocode から操作: ターミナルインターフェイスは、チャット、ライブログの確認、設定の管理、デーモンの監視をすべて一か所で行える最良の方法です。
zerocodeを実行するだけです。 - シェルから手早く単発で実行:
zeroclaw agent -a <alias> -m "your message"。 - 常時実行:
zeroclaw service install && zeroclaw service start。 - チャンネルは後から追加できます: チャンネル → 概要。
- 自律性と予算の調整: リファレンス → 設定。