First steps
オンボーディング概要
OpenClaw には 2 つのオンボーディング経路があります。どちらも auth、Gateway、 任意のチャットチャンネルを設定します。違いはセットアップとの対話方法だけです。
どの経路を使うべきですか？
| CLI オンボーディング | macOS アプリのオンボーディング | |
|---|---|---|
| 対応プラットフォーム | macOS、Linux、Windows（ネイティブまたは WSL2） | macOS のみ |
| インターフェース | ターミナルウィザード | アプリ内のガイド付き UI |
| 最適な用途 | サーバー、ヘッドレス、完全な制御 | デスクトップ Mac、視覚的セットアップ |
| 自動化 | スクリプト向けに --non-interactive 対応 |
手動のみ |
| コマンド | openclaw onboard |
アプリを起動 |
ほとんどのユーザーは CLI オンボーディング から始めるべきです。どこでも動作し、 最も高い制御性があります。
オンボーディングで設定されるもの
どちらの経路を選んでも、オンボーディングでは次を設定します。
- モデルプロバイダーと auth — 選択した provider 向けの API key、OAuth、または setup token
- workspace — エージェントファイル、bootstrap テンプレート、メモリ用ディレクトリ
- Gateway — port、bind address、auth mode
- チャンネル（任意） — BlueBubbles、Discord、Feishu、Google Chat、Mattermost、Microsoft Teams、 Telegram、WhatsApp などの組み込み/同梱チャットチャンネル
- daemon（任意） — Gateway が自動起動するようにするバックグラウンド service
CLI オンボーディング
任意のターミナルで実行します。
openclaw onboard
バックグラウンド service も 1 ステップでインストールするには --install-daemon を追加します。
完全なリファレンス: Onboarding (CLI)
CLI コマンド docs: openclaw onboard
macOS アプリのオンボーディング
OpenClaw アプリを開きます。初回起動ウィザードが、同じ手順を 視覚的インターフェースで案内します。
完全なリファレンス: Onboarding (macOS App)
custom または一覧にない provider
provider がオンボーディング一覧にない場合は、Custom Provider を選び、次を入力してください。
- API 互換モード（OpenAI-compatible、Anthropic-compatible、または auto-detect）
- Base URL と API key
- model ID と任意の alias
複数の custom endpoint を共存させることができ、それぞれに独自の endpoint ID が与えられます。