openclaw setup
openclaw setup はシステムエージェントのエントリーポイントです。構成済みのシステムでは、単独の
openclaw setup により対話型の OpenClaw チャットが開きます。新規システムでは、
ガイド付きオンボーディングに移行します。1 回のリクエストには -m/--message を使用し、
ウィザードを使わずに構成/ワークスペースフォルダーを初期化するには --baseline を使用します。
ルーティング順序:
- オンボーディングオプション（
--wizard、--baseline、ワークスペース、リセット、 非対話型、フロー、モード、Gateway、デーモン、スキップ、インポート、リモート、または認証 オプション）を指定すると、openclaw onboardとまったく同じようにオンボーディングが実行されます。 -m/--messageまたは--yesを指定すると、システムエージェントが実行されます。- ルーティングオプションがない場合、構成済みの対話型システムでは OpenClaw が開きます。
新規システムではオンボーディングが実行されます。構成済みのシステムでは、TTY がなくても
--jsonにより システム概要が出力されます。オンボーディングオプションを指定した場合は、オンボーディングの JSON サマリーが維持されます。
--workspace <dir> が OpenClaw に提案されるワークスペースです。
この提案を承認した後にのみ保存されます。新規インストールでは、ベースライン、クラシック、および
非対話型セットアップにより、指定されたワークスペースが各通常フローを通じて保存されます。
既存のエージェント一覧が再マッピングされる場合、クラシックウィザードでは明示的な確認が必要です。
非対話型セットアップでは現在のフリートワークスペースが維持され、警告が出力されます。
ガイド付き推論検出は、macOS または Linux 上の Gateway ホストで実行されます。CLI
と macOS アプリは、構成済みモデル、対応している CLI ログイン、API キー環境変数、および
インストール済みの Ollama または LM Studio モデルを確認する、同じ Gateway 所有の検出機能を呼び出します。
この自動処理によってローカルモデルがダウンロードされることはありません。検出されたローカルランタイムは、
CLI および API キーの候補の後に自動テストされます。複数のローカルモデルを利用できる場合、OpenClaw は
ツール呼び出しに対応する最も強力な instruct ファミリーを優先します。選択された候補は、そのプロバイダーと
モデルの構成が保存される前に、実際の補完に応答できなければなりません。
インストール済みの Gemini、Antigravity、Pi、および OpenCode CLI は、
ガイド付きセットアップで再利用可能な推論経路として使用できない場合にも報告されます。
setup は、認証（--auth-choice、--token、プロバイダーキーフラグ）、Gateway
（--gateway-port、--gateway-bind、--gateway-auth、--install-daemon）、
Tailscale（--tailscale）、リセット（--reset、--reset-scope）、フロー
（--flow quickstart|advanced|manual|import）、およびスキップフラグ
（--skip-channels、--skip-skills、--skip-bootstrap、--skip-search、
--skip-health、--skip-ui、--skip-hooks）を含む、openclaw onboard と同じオンボーディングフラグを受け付けます。openclaw onboard --tui と同じ
ターミナル経路を使用するには、--tui を渡します。フラグの完全なリファレンスと
非対話型の例については、オンボーディングおよび
CLI 自動化を参照してください。openclaw onboard --modern は、同じ推論ゲート付き
OpenClaw アシスタントへの互換性エントリとして引き続き利用できます。
openclaw setup は変更可能な構成のインストール向けです。Nix モード（OPENCLAW_NIX_MODE=1）では、構成ファイルが Nix によって管理されているため、OpenClaw はセットアップによる書き込みを拒否します。公式の nix-openclaw クイックスタートまたは別の Nix パッケージ用の同等のソース構成を使用してください。オプション
--classic と --non-interactive は相互に排他的です。クラシックでは
プロンプト付きウィザードが開き、非対話型セットアップでは自動化経路が使用されます。
対話型オンボーディングでは、--remote-url と --remote-token により
リモート Gateway のステップが事前入力され、その実行では保存済みのリモート値より優先されます。
トークンも渡さない限り、URL を変更しても保存済みの認証情報は再利用されません。
トークンはマスクされたままになり、ウィザードで選択した平文または SecretRef の
保存モードが使用されます。
ベースラインモード
openclaw setup --baseline は従来のベースライン専用の動作を維持します。
構成、ワークスペース、およびセッションのディレクトリを作成し、オンボーディングを
実行せずに終了します。--workspace と無害な出力制御は受け付けますが、
明示的なオンボーディング、Gateway、認証、リセット、またはデーモンのオプションは
暗黙に無視せず拒否します。既存の構成が無効な場合、ベースラインセットアップは
その構成を維持し、再試行する前に openclaw doctor を実行するよう求めます。
例
注記
- ベースラインセットアップ後、完全なガイド付き手順には
openclaw onboard、対象を絞った変更にはopenclaw configure、チャネルアカウントの追加にはopenclaw channels addを実行します。 - Hermes の状態が検出された場合、対話型オンボーディングで移行が自動的に提案されることがあります。インポートオンボーディングには新規セットアップが必要です。オンボーディング外でのドライラン計画、バックアップ、および上書きモードについては、移行を使用してください。