メインコンテンツへスキップ

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

このドキュメントでは、最初に実行するオンボーディングフローについて説明します。 本ドキュメントでは、現在の初回オンボーディングフローについて説明します。目標は、スムーズな「day 0」体験です。Gateway（ゲートウェイ）の実行場所を選択し、認証を接続し、ウィザードを実行して、エージェントが自己ブートストラップできるようにします。
1

Approve macOS warning

2

Approve find local networks

3

Welcome and security notice

4

Local vs Remote

Gateway（ゲートウェイ） はどこで実行しますか？
  • This Mac（ローカルのみ）: オンボーディングで OAuth フローを実行し、認証情報をローカルに書き込めます。
  • Remote（SSH/Tailnet 経由）: オンボーディングではローカルで OAuth を実行しません。認証情報はゲートウェイ ホスト上に存在している必要があります。
  • Configure later: セットアップをスキップし、アプリを未設定のままにします。
Gateway 認証のヒント:
  • ウィザードは、local loopback の場合でも トークン を生成するようになりました。そのため、ローカルの WS クライアントは認証が必要です。
  • 認証を無効化すると、任意のローカルプロセスが接続できてしまいます。完全に信頼できるマシンでのみ使用してください。
  • 複数マシンからのアクセスや non‑loopback バインドには トークン を使用してください。
  • authを無効にすると、どのローカルプロセスでも接続できます。完全に信頼されたマシンでのみ使用できます。
  • 複数のマシンにアクセスするには、トークン を使用します。
5

Permissions

オンボーディングでは、以下に必要な TCC 権限を要求します。
  • Automation（AppleScript）
  • 通知
  • アクセシビリティ
  • 画面収録
  • マイク
  • 音声認識
  • カメラ
  • 位置情報
6

CLI

このステップは任意です
アプリは、npm/pnpm を通じてグローバルな openclaw CLI をインストールできます。これにより、ターミナルのワークフローや launchd タスクがすぐに利用可能になります。
7

Onboarding Chat (dedicated session)

セットアップ後、アプリは専用のオンボーディングチャットセッションを開き、エージェントが自己紹介を行い、次のステップを案内します。これにより、初回実行時のガイダンスを通常の会話から分離できます。初回のエージェント実行時にゲートウェイ ホストで何が起こるかについては、Bootstrapping を参照してください。 これにより、通常の会話とは別の ガイダンスが維持されます。 11. 初回エージェント実行時にゲートウェイホストで何が起こるかについては、 Bootstrapping を参照してください。