オンボーディングウィザード（CLI）

オンボーディングウィザードは、macOS、Linux、または Windows（WSL2 経由を強く推奨）で OpenClaw をセットアップする推奨の方法です。 ローカル Gateway またはリモート Gateway への接続に加えて、チャンネル、スキル、ワークスペースのデフォルト設定を一つのガイド付きフローで構成します。

openclaw onboard

情報： 最速でチャットを始める方法：コントロールUI を使えば、チャンネル設定なしですぐ始められます。 openclaw dashboard を実行してブラウザでチャットしてください。ドキュメント：ダッシュボード。

再設定する場合：

openclaw configure
openclaw agents add <name>

注意： --json を指定しても非対話モードにはなりません。スクリプトでは --non-interactive を使ってください。

ヒント： オンボーディングウィザードには Web 検索の設定ステップがあり、プロバイダー （Perplexity、Brave、Gemini、Grok、Kimi）を選択して API キーを入力すると、 エージェントが web_search を使えるようになります。後から openclaw configure --section web で設定することもできます。ドキュメント：Webツール。

クイックスタート vs アドバンスド

ウィザードは最初に クイックスタート（デフォルト設定）か アドバンスド（すべてを制御）かを選びます。

クイックスタート（デフォルト）

- ローカル Gateway（ループバック）
- デフォルトのワークスペース（または既存のワークスペース）
- Gateway ポート **18789**
- Gateway 認証 **トークン**（ループバックでも自動生成）
- ツールポリシーのデフォルト（新規ローカルセットアップ時）：`tools.profile: "coding"`（既存の明示的プロファイルは保持）
- DM 分離のデフォルト：ローカルオンボーディングは未設定時に `session.dmScope: "per-channel-peer"` を書き込みます。詳細：[CLIオンボーディングリファレンス](/docs/start/wizard-cli-reference#outputs-and-internals)
- Tailscale 公開 **オフ**
- Telegram + WhatsApp の DM はデフォルトで**許可リスト**（電話番号の入力を求められます）

アドバンスド（フルコントロール）

- すべてのステップ（モード、ワークスペース、Gateway、チャンネル、デーモン、スキル）を表示。

ウィザードの設定内容

**ローカルモード（デフォルト）**では以下のステップを順に進めます。

  1. モデル／認証 — 対応するプロバイダーや認証フロー（APIキー、OAuth、セットアップトークン）を選択します。Custom Provider（OpenAI互換、Anthropic互換、Unknown 自動検出）にも対応。デフォルトモデルを選択。 セキュリティに関する注意：このエージェントがツールを実行したり、Webhook やフックのコンテンツを処理する場合は、利用可能な最新世代の最強モデルを選び、ツールポリシーを厳格に保ってください。旧世代や下位のモデルはプロンプトインジェクションに弱くなります。 非対話モードでは、--secret-input-mode ref により平文の API キー値ではなく env ベースの参照を認証プロファイルに保存します。 非対話の ref モードでは、プロバイダーの環境変数が設定されている必要があります。その環境変数なしにインラインキーフラグを渡すと即座にエラーになります。 対話モードでシークレット参照モードを選択すると、環境変数または設定済みプロバイダー参照（file または exec）のいずれかを指定でき、保存前に高速なプリフライト検証が実行されます。
  2. ワークスペース — エージェントファイルの配置場所（デフォルト ~/.openclaw/workspace）。ブートストラップファイルを生成。
  3. Gateway — ポート、バインドアドレス、認証モード、Tailscale 公開。 対話的なトークンモードでは、デフォルトの平文トークン保存または SecretRef へのオプトインを選択できます。 非対話のトークン SecretRef パス：--gateway-token-ref-env <ENV_VAR>。
  4. チャンネル — WhatsApp、Telegram、Discord、Google Chat、Mattermost、Signal、BlueBubbles、iMessage。
  5. デーモン — LaunchAgent（macOS）または systemd ユーザーユニット（Linux/WSL2）をインストール。 トークン認証が必要で gateway.auth.token が SecretRef 管理の場合、デーモンインストールはそれを検証しますが、解決済みトークンをスーパーバイザーサービスの環境メタデータに永続化しません。 トークン認証が必要で設定済みトークン SecretRef が未解決の場合、対処方法とともにデーモンインストールがブロックされます。 gateway.auth.token と gateway.auth.password の両方が設定されていて gateway.auth.mode が未設定の場合、モードを明示的に設定するまでデーモンインストールがブロックされます。
  6. ヘルスチェック — Gateway を起動し、動作を確認。
  7. スキル — 推奨スキルとオプションの依存関係をインストール。

注意： ウィザードを再実行しても、明示的にリセットを選択（または --reset を指定）しない限り、何も消去されません。 CLI の --reset はデフォルトで設定、認証情報、セッションを対象とします。ワークスペースも含めるには --reset-scope full を使用してください。 設定が無効だったりレガシーキーが含まれている場合、ウィザードはまず openclaw doctor を実行するよう案内します。

リモートモードは、このマシンのローカルクライアントを別の場所にある Gateway に接続するだけです。 リモートホスト上のインストールや変更は一切行いません。

別のエージェントを追加

openclaw agents add <name> を使うと、独自のワークスペース、セッション、認証プロファイルを持つ別のエージェントを作成できます。--workspace なしで実行するとウィザードが起動します。

設定される項目：

  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir

注意点：

  • デフォルトのワークスペースは ~/.openclaw/workspace-<agentId> に従います。
  • bindings を追加してインバウンドメッセージをルーティングできます（ウィザードで設定可能）。
  • 非対話フラグ：--model、--agent-dir、--bind、--non-interactive。

完全なリファレンス

ステップごとの詳しい説明と設定出力については、 CLIオンボーディングリファレンスをご覧ください。 非対話の例については、CLIオートメーションをご覧ください。 RPC の詳細を含むより深い技術リファレンスについては、 ウィザードリファレンスをご覧ください。

関連ドキュメント

arrow_back
前へ
Onboarding Overview
次へ
Onboarding
arrow_forward