オンボーディングウィザード(CLI)
オンボーディングウィザードは、macOS、 Linux、またはWindows(WSL2を介して強く推奨)でOpenClawを設定する推奨方法です。 ローカル ゲートウェイまたはリモート ゲートウェイ接続を構成し、チャネル、スキル、 およびワークスペースの既定値を 1 つのガイド付きフローで設定します。
後から再設定する場合:
--json は非対話モードを意味するものではありません。スクリプトでは --non-interactive を使用してください。
スクリプトの場合は --non-interactive を使用します。クイックスタート vs 高度な設定
ウィザードは クイックスタート(デフォルト)と 高度な設定(完全制御)から始まります。- QuickStart (defaults)
- Advanced (full control)
- ローカルゲートウェイ(loopback)
- ワークスペースのデフォルト(または既存のワークスペース)
- ゲートウェイポート 18789
- ゲートウェイ認証 Token(loopback でも自動生成)
- Tailscale 公開 オフ
- Telegram + WhatsApp のダイレクトメッセージは 許可リスト がデフォルト(電話番号の入力を求められます)
ウィザードが設定する内容
ローカルモード(デフォルト) では、次の手順を案内します:- モデル/認証 — Anthropic API キー(推奨)、OAuth、OpenAI、またはその他のプロバイダー。デフォルトモデルを選択します。 デフォルトのモデルを選択します。
- ワークスペース — エージェントファイルの保存場所(デフォルト
~/.openclaw/workspace)。ブートストラップファイルを初期配置します。 種のブートストラップファイル。 - ゲートウェイ — ポート、バインドアドレス、認証モード、Tailscale 公開。
- チャンネル — WhatsApp、Telegram、Discord、Google Chat、Mattermost、Signal、BlueBubbles、または iMessage。
- デーモン — LaunchAgent(macOS)または systemd ユーザーユニット(Linux/WSL2)をインストールします。
- ヘルスチェック — Gateway を起動し、正常に動作していることを検証します。
- Skills — 推奨 Skills と任意の依存関係をインストールします。
ウィザードを再実行しても、Reset を明示的に選択しない限り(または
--reset を渡さない限り)、何も消去されません。
設定が無効である場合やレガシーキーが含まれている場合、ウィザードはまず openclaw doctor を実行するよう促します。設定が無効な場合、または古いキーが含まれている場合は、ウィザードは最初に openclaw doctor を実行するように要求します。別のエージェントを追加する
openclaw agents add <name> を使用すると、独自のワークスペース、セッション、認証プロファイルを持つ別のエージェントを作成できます。
--workspace を付けずに実行すると、ウィザードが起動します。 --workspace なしで実行すると、ウィザードが起動します。
設定される内容:
agents.list[].nameagents.list[].workspaceagents.list[].agentDir
- デフォルトのワークスペースは
~/.openclaw/workspace-<agentId>に従います。 - 受信メッセージをルーティングするには
bindingsを追加してください(ウィザードで設定できます)。 - 非対話フラグ:
--model、--agent-dir、--bind、--non-interactive。
完全リファレンス
詳細なステップごとの内訳、非対話スクリプト、Signal のセットアップ、 RPC API、およびウィザードが書き込む設定フィールドの完全な一覧については、 Wizard Reference を参照してください。関連ドキュメント
- CLI コマンドリファレンス:
openclaw onboard - macOS アプリのオンボーディング: Onboarding
- エージェント初回実行の儀式: Agent Bootstrapping