オンボーディング (CLI)

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

openclaw onboard

後で再構成するには:

openclaw configure
openclaw agents add <name>

# クイックスタート vs 詳細設定

オンボーディングは クイックスタート (デフォルト) と 詳細設定 (完全制御) の選択から始まります。

# オンボーディングで構成される内容

ローカルモード (デフォルト) では、次のステップを順に進めます:

1. モデル/認証 — サポートされている任意のプロバイダー/認証フロー (API キー、OAuth、またはプロバイダー固有の手動認証) を、カスタムプロバイダー (OpenAI 互換、Anthropic 互換、または Unknown の自動検出) を含めて選択します。デフォルトモデルを選択します。 セキュリティ上の注意: このエージェントがツールを実行する、または Webhook/hooks コンテンツを処理する場合は、利用可能な最も強力な最新世代モデルを優先し、ツールポリシーを厳格に保ってください。弱い/古いティアほどプロンプトインジェクションを受けやすくなります。 非対話実行では、--secret-input-mode ref により、平文の API キー値の代わりに env 裏付けの ref が認証プロファイルに保存されます。 非対話の ref モードでは、プロバイダーの環境変数を設定する必要があります。その環境変数なしでインラインキーのフラグを渡すと即座に失敗します。 対話実行では、シークレット参照モードを選ぶと、環境変数または構成済みプロバイダー ref (file または exec) のいずれかを指定でき、保存前に高速な事前検証が行われます。 Anthropic では、対話型のオンボーディング/構成時に、推奨されるローカルパスとして Anthropic Claude CLI、推奨される本番パスとして Anthropic API キー が提示されます。Anthropic setup-token も、サポートされるトークン認証パスとして引き続き利用できます。
2. ワークスペース — エージェントファイルの場所 (デフォルト ~/.openclaw/workspace)。ブートストラップファイルを配置します。
3. Gateway — ポート、バインドアドレス、認証モード、Tailscale 公開。 対話型トークンモードでは、デフォルトの平文トークン保存を選択するか、SecretRef を選択できます。 非対話トークン SecretRef パス: --gateway-token-ref-env <ENV_VAR>。
4. チャネル — BlueBubbles、Discord、Feishu、Google Chat、Mattermost、Microsoft Teams、QQ Bot、Signal、Slack、Telegram、WhatsApp などの組み込みおよびバンドルされたチャットチャネル。
5. デーモン — LaunchAgent (macOS)、systemd user unit (Linux/WSL2)、またはユーザーごとの Startup フォルダーへのフォールバック付きのネイティブ Windows Scheduled Task をインストールします。 トークン認証でトークンが必要で、gateway.auth.token が SecretRef 管理の場合、デーモンのインストールはそれを検証しますが、解決済みトークンをスーパーバイザーサービスの環境メタデータには永続化しません。 トークン認証でトークンが必要で、構成済みのトークン SecretRef が未解決の場合、デーモンのインストールは対処可能なガイダンスとともにブロックされます。 gateway.auth.token と gateway.auth.password の両方が構成され、gateway.auth.mode が未設定の場合、モードが明示的に設定されるまでデーモンのインストールはブロックされます。
6. ヘルスチェック — Gateway を起動し、実行中であることを確認します。
7. Skills — 推奨 Skills と任意の依存関係をインストールします。

リモートモード は、別の場所にある 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 の詳細を含む、より詳しい技術リファレンスについては、 オンボーディングリファレンスを参照してください。

# 関連ドキュメント

• CLI コマンドリファレンス: openclaw onboard
• オンボーディング概要: オンボーディング概要
• macOS アプリのオンボーディング: オンボーディング
• エージェントの初回実行手順: エージェントのブートストラップ