> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# オンボーディング（macOS アプリ）

macOS アプリの初回起動フロー: Gateway を実行する場所を選択し、検証済みの AI バックエンドに接続し、権限を付与して、エージェント自身のブートストラップ儀式へ引き継ぎます。
CLI オンボーディングと両方の経路の比較については、[オンボーディング概要](/ja-JP/start/onboarding-overview) を参照してください。

<Steps>
  <Step title="macOS 警告を承認">
    <Frame>
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/01-macos-warning.jpeg?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=7ade99ff85eba6a2fe743ff1f7799087" alt="" width="1132" height="818" data-path="assets/macos-onboarding/01-macos-warning.jpeg" />
    </Frame>
  </Step>

  <Step title="ローカルネットワークの検索を承認">
    <Frame>
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/02-local-networks.jpeg?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=e9fcec535d0cdca207cff0cf2379e951" alt="" width="1132" height="818" data-path="assets/macos-onboarding/02-local-networks.jpeg" />
    </Frame>
  </Step>

  <Step title="ようこそとセキュリティ通知">
    <Frame caption="表示されたセキュリティ通知を読み、それに応じて判断してください">
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/03-security-notice.png?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=8866e4aaac170614a163d990091addac" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/03-security-notice.png" />
    </Frame>

    セキュリティ信頼モデル:

    * デフォルトでは、OpenClaw は個人用エージェントです: 信頼できるオペレーター 1 人の境界です。
    * 共有/マルチユーザー構成にはロックダウンが必要です: 信頼境界を分離し、ツールアクセスを最小限に保ち、[セキュリティ](/ja-JP/gateway/security) に従ってください。
    * ローカルオンボーディングでは、新しい設定のデフォルトが `tools.profile: "coding"` になるため、新規構成では無制限の `full` プロファイルを使わずにファイルシステム/ランタイムツールを維持できます。
    * フック/Webhook やその他の信頼できないコンテンツフィードを有効にする場合は、強力な最新モデル層を使用し、厳格なツールポリシー/サンドボックス化を維持してください。
  </Step>

  <Step title="ローカルとリモート">
    <Frame>
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/04-choose-gateway.png?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=7e923f389e6d774363064140691b4fbe" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/04-choose-gateway.png" />
    </Frame>

    **Gateway** はどこで実行しますか？

    * **この Mac (ローカルのみ):** オンボーディングは認証を設定し、認証情報をローカルに書き込みます。
    * **リモート (SSH/Tailnet 経由):** オンボーディングはローカル認証を設定しません。
      認証情報は Gateway ホストにすでに存在している必要があります。リモート Gateway トークン
      フィールドには、macOS アプリがその Gateway に接続するために使用するトークンを保存します。
      既存の `gateway.remote.token` SecretRef 値は、置き換えるまで保持されます。
    * **後で設定:** セットアップをスキップし、アプリを未設定のままにします。

    <Tip>
      **Gateway 認証のヒント:**

      * Gateway 認証モードは、ループバックバインドでもデフォルトで `token` になるため、ローカル WS クライアントは認証する必要があります。
      * `gateway.auth.mode: "none"` を設定すると、任意のローカルプロセスが接続できます。完全に信頼できるマシンでのみ使用してください。
      * 複数マシンからのアクセスや非ループバックバインドにはトークンを使用してください。
    </Tip>
  </Step>

  <Step title="CLI">
    ローカルセットアップでは、npm、pnpm、または bun を使ってグローバル `openclaw` CLI をインストールし、
    npm を最初に優先します。Gateway
    自体の推奨ランタイムは引き続き Node です。既存の互換性のあるインストールは再利用されます。
  </Step>

  <Step title="AI を接続">
    Gateway の準備ができると、オンボーディングはすでに持っている AI アクセスを探します:
    Claude Code、Codex、Gemini CLI のログイン、または `OPENAI_API_KEY` /
    `ANTHROPIC_API_KEY` です。最適なオプションは実際の補完でテストされ、
    応答した後にのみ保存されます。テストが失敗すると、アプリは自動的に
    次のオプションを試し、前のオプションが失敗した理由を表示します。複数のオプションが
    見つかった場合は、続行する前にそれらを切り替えられます。

    何も見つからない場合 (またはどれも動作しない場合)、手動キー/トークン選択画面は固定のアプリ
    リストではなく、Gateway のアクティブなテキスト推論プロバイダー Plugin を読み込みます。
    選択したプロバイダーはスターターモデルと設定を提供します。OpenClaw は
    同じライブテストで認証情報を検証してから、その認証プロファイルを保存します。次へ
    は 1 つのバックエンドが合格するまでロックされたままなので、動作する推論なしでは最初のエージェントチャットを
    開始できません。Crestodian チャットはこの
    ページから (後で 設定 → Crestodian からも) 平易な言葉でのヘルプとして利用できます。

    後で設定を選択すると、この手順をスキップします。
  </Step>

  <Step title="権限">
    <Frame caption="OpenClaw に付与する権限を選択してください">
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/05-permissions.png?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=6c45fa49282cf491a1425a714ec68f18" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/05-permissions.png" />
    </Frame>

    オンボーディングは、Automation (AppleScript)、通知、アクセシビリティ、画面収録、マイク、音声認識、カメラ、位置情報の TCC 権限を要求します。
  </Step>

  <Step title="オンボーディングチャット (専用セッション)">
    セットアップ後、アプリは別のエージェントオンボーディングチャットを開き、エージェントが
    自己紹介し、そのやり取りを通常の会話履歴に混ぜずに次の手順を案内できるようにします。
    これは Crestodian セットアップ会話に続くものです。
    それを置き換えるものではありません。エージェントの最初の実際のターンで
    Gateway ホスト上で何が起きるかについては、[ブートストラップ](/ja-JP/start/bootstrapping) を参照してください。
  </Step>
</Steps>

## 関連

* [オンボーディング概要](/ja-JP/start/onboarding-overview)
* [はじめに](/ja-JP/start/getting-started)