オンボーディング (macOS アプリ)

このドキュメントでは、現在の初回実行オンボーディングフローについて説明します。目標はスムーズな「0日目」体験です：ゲートウェイの実行場所を選び、認証を接続し、ウィザードを実行し、エージェントが自身をブートストラップできるようにします。 オンボーディングパスの一般的な概要については、オンボーディング概要をご覧ください。

1

macOS の警告を承認

2

ローカルネットワーク検出を承認

3

ウェルカムとセキュリティ通知

表示されたセキュリティ通知を読み、適切に判断してください
4

ローカル vs リモート

ゲートウェイはどこで動作しますか？

  • この Mac（ローカルのみ）： オンボーディングで OAuth フローを実行し、資格情報をローカルに書き込みます。
  • リモート（SSH/Tailnet 経由）： オンボーディングでローカルの OAuth は実行されません。資格情報はゲートウェイホスト上に存在する必要があります。
  • 後で設定： セットアップをスキップし、アプリを未設定のままにします。

ゲートウェイ認証のヒント：

  • ウィザードはループバックでもトークンを生成するため、ローカルの WS クライアントも認証が必要です。
  • 認証を無効にすると、ローカルのすべてのプロセスが接続できます。完全に信頼できるマシンでのみ使用してください。
  • マルチマシンアクセスまたは非ループバックバインドにはトークンを使用してください。
5

権限

Mayros に付与する権限を選択してください

オンボーディングでは、以下に必要な TCC 権限を要求します：

  • オートメーション（AppleScript）
  • 通知
  • アクセシビリティ
  • 画面収録
  • マイク
  • 音声認識
  • カメラ
  • 位置情報
6

CLI

このステップはオプションです
アプリは npm/pnpm 経由でグローバルの mayros CLI をインストールできます。これにより、ターミナルのワークフローや launchd タスクがすぐに使えるようになります。

7

オンボーディングチャット（専用セッション）

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