OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

はじめに

オンボーディングリファレンス

これは openclaw onboard の完全なリファレンスです。 概要については、オンボーディング（CLI）を参照してください。段階ごとの 動作と出力については、CLI セットアップリファレンスを参照してください。

フローの詳細（ローカルモード）

  • リセット（任意）

    • --reset はセットアップの実行前に状態をリセットします。指定しない場合、オンボーディングを再実行すると 既存の設定が保持され、デフォルトとして再利用されます。
    • --reset-scope は --reset が削除する対象を制御します。config（設定ファイル のみ）、config+creds+sessions（デフォルト）、または full（ワークスペースも 削除）です。
    • 設定ファイルが無効な場合、オンボーディングは停止し、まず openclaw doctor を実行してからセットアップを再実行するよう案内します。
    • リセットでは状態をゴミ箱に移動します（直接削除することはありません）。

  • リスクの確認

    • 初回実行時（または wizard.securityAcknowledgedAt が設定される前の実行時）は、 エージェントが強力であり、システムへの完全なアクセスにはリスクが伴うことを 理解しているか確認を求めます。
    • --non-interactive では --accept-risk を明示的に指定する必要があります。指定しない場合、 オンボーディングはプロンプトを表示せず、エラーで終了します。
    • 対話型の実行では、フラグの代わりに確認プロンプトが表示されます。拒否すると セットアップがキャンセルされます。

  • モデル／認証

    • Anthropic API キー：ANTHROPIC_API_KEY が存在する場合はそれを使用し、存在しない場合はキーの入力を求めて、デーモンで使用できるよう保存します。
    • Anthropic Claude CLI：Claude CLI へのサインインがすでに存在する場合に推奨されるローカルパスです。OpenClaw は代替手段として Anthropic のセットアップトークン認証も引き続きサポートします。
    • OpenAI Code（Codex）サブスクリプション（OAuth）：ブラウザフローを使用し、code#state を貼り付けます。
      • プライマリモデルがない新規セットアップでは、Codex ランタイムを通じて agents.defaults.model を openai/gpt-5.6-sol に設定します。
    • OpenAI Code（Codex）サブスクリプション（デバイスペアリング）：有効期間の短いデバイスコードを使用するブラウザペアリングフローです。
      • プライマリモデルがない新規セットアップでは、Codex ランタイムを通じて agents.defaults.model を openai/gpt-5.6-sol に設定します。
    • OpenAI API キー：OPENAI_API_KEY が存在する場合はそれを使用し、存在しない場合はキーの入力を求めて、認証プロファイルに保存します。
      • プライマリモデルがない新規セットアップでは、agents.defaults.model を openai/gpt-5.6 に設定します。修飾子のない直接 API モデル ID は Sol ティアとして解決されます。
    • OpenAI の追加または再認証では、openai/gpt-5.5 を含む、明示的に指定された既存のプライマリモデルが保持されます。アカウントで GPT-5.6 を利用できない場合は、openai/gpt-5.5 を明示的に選択してください。OpenClaw がモデルを暗黙にダウングレードすることはありません。
    • xAI OAuth：localhost コールバックを必要としないデバイスコード方式のブラウザサインインであるため、SSH／Docker／VPS 経由でも動作します（--auth-choice xai-oauth）。
    • xAI API キー：XAI_API_KEY の入力を求めます（--auth-choice xai-api-key）。
    • --auth-choice xai-device-code は、同じ xAI OAuth デバイスコードフローの手動専用互換エイリアスとして引き続き動作します。新しいスクリプトでは xai-oauth を使用してください。
    • OpenCode：OPENCODE_API_KEY（または OPENCODE_ZEN_API_KEY、https://opencode.ai/auth で取得）の入力を求め、Zen または Go カタログを選択できます。
    • Ollama：最初に クラウド＋ローカル、クラウドのみ、または ローカルのみ を提示します。Cloud only は OLLAMA_API_KEY の入力を求め、https://ollama.com を使用します。ホストを利用するモードでは Ollama のベース URL（デフォルトは http://127.0.0.1:11434）の入力を求め、利用可能なモデルを検出し、必要に応じて選択したローカルモデルを自動的にプルします。Cloud + Local は、その Ollama ホストがクラウドアクセス用にサインイン済みかどうかも確認します。
    • 詳細：Ollama
    • API キー：キーを保存します。
    • Vercel AI Gateway（マルチモデルプロキシ）：AI_GATEWAY_API_KEY の入力を求めます。
    • 詳細：Vercel AI Gateway
    • Cloudflare AI Gateway：Account ID、Gateway ID、および CLOUDFLARE_AI_GATEWAY_API_KEY の入力を求めます。
    • 詳細：Cloudflare AI Gateway
    • MiniMax：設定は自動的に書き込まれます。ホステッド環境のデフォルトは MiniMax-M3 です。 API キーによるセットアップでは minimax/... を使用し、OAuth によるセットアップでは minimax-portal/... を使用します。
    • 詳細：MiniMax
    • StepFun：中国またはグローバルのエンドポイントで、StepFun standard または Step Plan 用の設定が自動的に書き込まれます。
    • standard の現在のデフォルトは step-3.5-flash です。Step Plan には step-3.5-flash-2603 も含まれます。
    • 詳細：StepFun
    • Synthetic（Anthropic 互換）：SYNTHETIC_API_KEY の入力を求めます。
    • 詳細：Synthetic
    • Moonshot（Kimi K2）：設定は自動的に書き込まれます。
    • Kimi Coding：設定は自動的に書き込まれます。
    • 詳細：Moonshot AI（Kimi＋Kimi Coding）
    • カスタムプロバイダー：OpenAI 互換、OpenAI Responses 互換、または Anthropic 互換のエンドポイントで動作します。非対話型フラグ：--auth-choice custom-api-key、--custom-base-url、--custom-model-id、--custom-api-key（任意。未指定時は CUSTOM_API_KEY にフォールバック）、--custom-provider-id（任意。ベース URL から自動導出）、--custom-compatibility openai|openai-responses|anthropic（デフォルトは openai）、--custom-image-input／--custom-text-input（推論されたビジョンモデル検出を上書き）。
    • スキップ：認証はまだ設定されません。
    • 検出された選択肢からデフォルトモデルを選択します（またはプロバイダー／モデルを手動で入力します）。最高の品質と低いプロンプトインジェクションリスクを得るには、プロバイダースタックで利用可能な最新世代のうち、最も高性能なモデルを選択してください。
    • オンボーディングはモデルチェックを実行し、設定されたモデルが不明であるか、認証が不足している場合に警告します。
    • API キーの保存モードは、デフォルトでは認証プロファイルへの平文値の保存です。代わりに環境変数を参照する値として保存するには、--secret-input-mode ref を使用します（例：keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" }）。参照先の環境変数は事前に設定されている必要があり、設定されていない場合はオンボーディングが即座に失敗します。
    • 認証プロファイルは ~/.openclaw/agents/<agentId>/agent/auth-profiles.json に保存されます（API キー＋OAuth）。~/.openclaw/credentials/oauth.json は従来形式のインポート専用です。
    • 詳細：OAuth

  • ワークスペース

    • デフォルトは ~/.openclaw/workspace です（設定可能）。
    • エージェントのブートストラップ手順に必要なワークスペースファイルを初期配置します。
    • ワークスペースの完全なレイアウトとバックアップガイド：エージェントワークスペース

  • Gateway

    • ポート（デフォルトは 18789）、バインド、認証モード、Tailscale への公開。
    • 認証の推奨事項：local loopback であっても トークン を維持し、ローカルの WS クライアントにも認証を必須にします。
    • トークンモードの対話型セットアップでは、次の選択肢が提示されます。
      • 平文トークンを生成して保存（デフォルト）
      • SecretRef を使用（オプトイン）
      • クイックスタートでは、オンボーディングのプローブ／ダッシュボードのブートストラップ用に、env、file、および exec プロバイダー間で既存の gateway.auth.token SecretRef を再利用します。
      • その SecretRef が設定されていても解決できない場合、ランタイム認証を暗黙に縮退させるのではなく、明確な修正メッセージを表示してオンボーディングが早期に失敗します。
    • パスワードモードの対話型セットアップでも、平文または SecretRef での保存がサポートされます。
    • 非対話型のトークン SecretRef パス：--gateway-token-ref-env &lt;ENV_VAR&gt;。
      • オンボーディングプロセスの環境に、空でない環境変数が必要です。
      • --gateway-token と同時には使用できません。
    • すべてのローカルプロセスを完全に信頼できる場合にのみ、認証を無効にしてください。
    • local loopback 以外へのバインドでは、引き続き認証が必要です。

  • チャネル

    • WhatsApp：任意の QR ログイン。
    • Telegram：ボットトークン。
    • Discord：ボットトークン。
    • Google Chat：サービスアカウント JSON＋Webhook オーディエンス。
    • Mattermost（Plugin）：ボットトークン＋ベース URL。
    • Signal（Plugin）：任意の signal-cli インストール＋アカウント設定。
    • iMessage：imsg CLI パス＋Messages DB へのアクセス。Gateway が Mac 以外で実行される場合は SSH ラッパーを使用します。
    • Discord、Feishu、Microsoft Teams、QQ Bot、Slack、およびその他のチャネルは、 オンボーディングがインストールできる Plugin として提供されます。完全なカタログ：チャネル。
    • DM のセキュリティ：デフォルトはペアリングです。最初の DM でコードが送信されます。openclaw pairing approve <channel> <code> で承認するか、許可リストを使用します。

  • Web 検索

    • Brave、Codex（ホステッド検索）、DuckDuckGo、Exa、Firecrawl、Gemini、Grok、Kimi、MiniMax Search、Ollama Web Search、Parallel、Perplexity、SearXNG、Tavily などのサポート対象プロバイダーを選択します（またはスキップします）。
    • API を利用するプロバイダーでは、クイックセットアップに環境変数または既存の設定を使用できます。キー不要のプロバイダーでは、代わりにプロバイダー固有の前提条件を使用します。
    • --skip-search でスキップします。
    • 後で設定：openclaw configure --section web。

  • デーモンのインストール

    • macOS：LaunchAgent
      • ログイン済みのユーザーセッションが必要です。ヘッドレス環境では、カスタム LaunchDaemon（同梱されていません）を使用します。
    • Linux（および WSL2 経由の Windows）：systemd ユーザーユニット
      • ログアウト後も Gateway が稼働し続けるよう、オンボーディングは loginctl enable-linger <user> を使用して linger の有効化を試みます。
      • sudo の入力を求める場合があります（/var/lib/systemd/linger に書き込みます）。まず sudo なしで試行します。
    • ネイティブ Windows：最初にスケジュールされたタスクを使用します。タスクの作成が拒否された場合、OpenClaw はユーザー単位のスタートアップフォルダー内のログイン項目にフォールバックし、Gateway を直ちに起動します。
    • ランタイムの選択： 正式なランタイム状態ストアが node:sqlite を使用するため、Node が必要です。従来の Bun サービスは修復時に Node へ移行されます。
    • トークン認証でトークンが必要であり、gateway.auth.token が SecretRef で管理されている場合、デーモンのインストールではその値を検証しますが、解決された平文トークンの値をスーパーバイザーサービスの環境メタデータに永続化しません。
    • トークン認証でトークンが必要であり、設定されたトークン SecretRef を解決できない場合、実行可能な対処方法が案内され、デーモンのインストールはブロックされます。
    • gateway.auth.token と gateway.auth.password の両方が設定され、gateway.auth.mode が未設定の場合、モードが明示的に設定されるまでデーモンのインストールはブロックされます。

  • ヘルスチェック

    • Gateway を起動し（必要な場合）、openclaw health を実行します。
    • ヒント：openclaw status --deep を指定すると、ステータス出力に Gateway のライブヘルスプローブが追加され、サポートされている場合はチャネルプローブも含まれます（到達可能な Gateway が必要です）。

  • Skills（推奨）

    • 利用可能な Skills を読み込み、要件を確認します。
    • Node マネージャーとして npm / pnpm / bun を選択できます。
    • 信頼された同梱 Skills の任意の依存関係を自動インストールします（一部は macOS で Homebrew を使用します）。
    • Homebrew、uv、または Go のインストーラー前提条件を利用できない Skills をスキップし、手動セットアップの案内とともにグループ化して、前提条件のインストール後に openclaw doctor を参照するよう案内します。

  • 完了

    • 概要と次のステップを表示します。これには、Terminal、Browser、または後で実行するかを選ぶ エージェントをどのように起動しますか？ というプロンプトが含まれます。

    • 非対話モード

    オンボーディングを自動化またはスクリプト化するには、--non-interactive --accept-risk を使用します（このフラグは必須のリスク確認です。指定しない場合、オンボーディングはエラーで終了します）。

    bash
    openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --gateway-port 18789 \  --gateway-bind loopback \  --install-daemon \  --daemon-runtime node \  --skip-skills

    機械可読な概要を出力するには、--json を追加します。

    非対話モードでの Gateway トークン SecretRef：

    bash
    export OPENCLAW_GATEWAY_TOKEN="your-token"openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice skip \  --gateway-auth token \  --gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN

    --gateway-token と --gateway-token-ref-env は同時に使用できません。

    プロバイダー固有のコマンド例については、CLI の自動化を参照してください。 フラグの意味とステップの順序については、このリファレンスページを参照してください。

    エージェントを追加する（非対話）

    bash
    openclaw agents add work \  --workspace ~/.openclaw/workspace-work \  --model openai/gpt-5.6-sol \  --bind whatsapp:biz \  --non-interactive \  --json

    main は予約済みのエージェント ID であり、openclaw agents add には使用できません。

    Gateway ウィザード RPC

    Gateway は RPC 経由でオンボーディングフローを公開します（wizard.start、wizard.next、wizard.cancel、wizard.status）。 クライアント（macOS アプリ、Control UI）は、オンボーディングロジックを再実装せずに各ステップを表示できます。

    Signal のセットアップ（signal-cli）

    オンボーディングは signal-cli が PATH に存在するかを検出し、存在しない場合はインストールを提案します。

    • Linux x86-64：signal-cli の GitHub リリースから公式のネイティブ GraalVM ビルドをダウンロードし、~/.openclaw/tools/signal-cli/<version>/ に保存します。
    • macOS およびその他のアーキテクチャ：代わりに Homebrew 経由でインストールします。
    • ネイティブ Windows：まだサポートされていません。Linux のインストール手順を使用するには、WSL2 内でオンボーディングを実行してください。
    • いずれの場合も、kind: "managed-native" を指定した channels.signal.transport.cliPath を書き込みます。

    ウィザードが書き込む内容

    ~/.openclaw/openclaw.json の一般的なフィールド：

    • agents.defaults.workspace
    • --skip-bootstrap が渡された場合の agents.defaults.skipBootstrap
    • agents.defaults.model / models.providers（Minimax を選択した場合）
    • tools.profile（未設定の場合、ローカルオンボーディングではデフォルトで "coding" になります。既存の明示的な値は保持されます）
    • gateway.*（モード、バインド、認証、Tailscale）
    • session.dmScope（オンボーディングは明示的な値を保持し、それ以外の場合は未設定のままにします。そのため、"main" のデフォルトでは、すべてのチャンネルのダイレクトメッセージがエージェントのローリングメインセッションに保持されます。これは個人エージェント向けのデフォルトです。共有または複数ユーザーの受信トレイでは、"per-channel-peer" を使用してください。openclaw security audit は、複数ユーザーの DM トラフィックを検出すると分離を推奨します。詳細：CLI セットアップリファレンス）
    • channels.telegram.botToken、channels.discord.token、channels.matrix.*、channels.signal.*、channels.imessage.*
    • チャンネルのプロンプトでオプトインした場合の、チャンネル DM 許可リスト。Discord、Matrix、Microsoft Teams、Slack は可能な場合に名前を ID に解決します。その他のチャンネルでは ID を直接指定します（たとえば、数値の Telegram 送信者 ID や WhatsApp の電話番号）。
    • skills.install.nodeManager
      • setup --node-manager は npm、pnpm、または bun を受け付けます。
      • 手動設定では、skills.install.nodeManager を直接設定することで、引き続き yarn を使用できます。
    • wizard.lastRunAt
    • wizard.lastRunVersion
    • wizard.lastRunCommit
    • wizard.lastRunCommand
    • wizard.lastRunMode
    • wizard.securityAcknowledgedAt

    openclaw agents add は agents.entries.* と、任意の bindings を書き込みます。

    WhatsApp の認証情報は ~/.openclaw/credentials/whatsapp/<accountId>/ に保存されます。 アクティブなセッションとトランスクリプトは ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite に保存されます。 ~/.openclaw/agents/<agentId>/sessions/ ディレクトリは、従来の移行入力とアーカイブ／サポート用アーティファクトに使用されます。

    一部のチャンネルはプラグインとして提供されます。セットアップ中にいずれかを選択すると、設定する前にそのプラグイン（npm またはローカルパス）をインストールするようオンボーディングから求められます。

    関連ドキュメント

    Was this useful?
    On this page

    On this page