オンボーディング（macOS アプリ）¶
このドキュメントでは、最初に実行するオンボーディングフローについて説明します。 本ドキュメントでは、現在の初回オンボーディングフローについて説明します。目標は、スムーズな「day 0」体験です。Gateway（ゲートウェイ）の実行場所を選択し、認証を接続し、ウィザードを実行して、エージェントが自己ブートストラップできるようにします。
Gateway（ゲートウェイ） はどこで実行しますか？
- This Mac（ローカルのみ）: オンボーディングで OAuth フローを実行し、認証情報をローカルに書き込めます。
- Remote（SSH/Tailnet 経由）: オンボーディングではローカルで OAuth を実行しません。認証情報はゲートウェイ ホスト上に存在している必要があります。
- Configure later: セットアップをスキップし、アプリを未設定のままにします。
Gateway 認証のヒント: - ウィザードは、local loopback の場合でも トークン を生成するようになりました。そのため、ローカルの WS クライアントは認証が必要です。 - 認証を無効化すると、任意のローカルプロセスが接続できてしまいます。完全に信頼できるマシンでのみ使用してください。 - 複数マシンからのアクセスや non‑loopback バインドには トークン を使用してください。
- authを無効にすると、どのローカルプロセスでも接続できます。完全に信頼されたマシンでのみ使用できます。
- 複数のマシンにアクセスするには、トークン を使用します。
オンボーディングでは、以下に必要な TCC 権限を要求します。
- Automation（AppleScript）
- 通知
- アクセシビリティ
- 画面収録
- マイク
- 音声認識
- カメラ
- 位置情報
openclaw CLI をインストールできます。これにより、ターミナルのワークフローや launchd タスクがすぐに利用可能になります。
セットアップ後、アプリは専用のオンボーディングチャットセッションを開き、エージェントが自己紹介を行い、次のステップを案内します。これにより、初回実行時のガイダンスを通常の会話から分離できます。初回のエージェント実行時にゲートウェイ ホストで何が起こるかについては、Bootstrapping を参照してください。 これにより、通常の会話とは別の ガイダンスが維持されます。 11. 初回エージェント実行時にゲートウェイホストで何が起こるかについては、 Bootstrapping を参照してください。