Platforms overview

macOS アプリ

macOS アプリは OpenClaw のメニューバー コンパニオンです。ネイティブなトレイ UI、macOS 権限プロンプト、通知、WebChat、音声入力、Canvas、または system.run などの Mac ホスト型ノードツールが必要な場合に使用します。

CLI と Gateway だけが必要な場合は、はじめにから始めてください。

ダウンロード

macOS アプリビルドは OpenClaw GitHub リリースからダウンロードします。 リリースに macOS アプリのアセットが含まれる場合は、次を探してください。

  • OpenClaw-<version>.dmg(推奨)
  • OpenClaw-<version>.zip

一部のリリースには CLI、証拠、または Windows アセットのみが含まれます。最新の リリースに macOS アプリのアセットがない場合は、それを含む最新リリースを使用するか、 macOS 開発セットアップでソースからアプリをビルドしてください。

初回起動

  1. OpenClaw.app をインストールして起動します。
  2. ローカル Gateway には This Mac を選ぶか、リモート Gateway に接続します。
  3. ローカルモードでは、アプリがユーザー空間ランタイムと Gateway をインストールするまで待ちます。
  4. プロバイダー設定と macOS 権限チェックリストを完了します。
  5. オンボーディングのテストメッセージを送信します。

CLI/Gateway のセットアップ経路については、はじめにを使用してください。 権限の復旧については、macOS 権限を使用してください。

Gateway モードを選択する

モード 使用する場合 詳細ページ
ローカル この Mac で Gateway を実行し、launchd で稼働を維持する必要がある場合。 macOS の Gateway
リモート 別のホストが Gateway を実行し、この Mac が SSH、LAN、または Tailnet 経由で制御する必要がある場合。 リモート制御

ローカルモードには、インストール済みの openclaw CLI が必要です。新しい Mac では、アプリが Gateway ウィザードを開始する前に、対応する CLI とランタイムを自動的にインストールします。 手動復旧については、macOS の Gatewayを参照してください。

アプリが所有するもの

  • メニューバーのステータス、通知、ヘルス、WebChat。
  • 画面、マイク、音声認識、オートメーション、アクセシビリティに関する macOS 権限プロンプト。
  • Canvas、カメラ/画面キャプチャ、通知、system.run などのローカルノードツール。
  • Mac ホスト型コマンドの Exec 承認プロンプト。
  • リモートモードの SSH トンネルまたは直接 Gateway 接続。

アプリは OpenClaw Gateway や一般的な CLI ドキュメントを置き換えるものではありません。コアの Gateway 設定、プロバイダー、plugins、チャネル、ツール、セキュリティには それぞれ専用のドキュメントがあります。

macOS 詳細ページ

タスク 読むもの
CLI/Gateway サービスをインストールまたはデバッグする macOS の Gateway
クラウド同期フォルダーから状態を除外する macOS の Gateway
アプリの検出と接続をデバッグする macOS の Gateway
launchd の動作を理解する Gateway ライフサイクル
権限または署名/TCC の問題を修正する macOS 権限
リモート Gateway に接続する リモート制御
メニューバーのステータスとヘルスチェックを読む メニューバー, ヘルスチェック
組み込みチャット UI を使用する WebChat
音声ウェイクまたはプッシュトゥトークを使用する 音声ウェイク
Canvas と Canvas ディープリンクを使用する Canvas
UI オートメーション用に PeekabooBridge をホストする Peekaboo ブリッジ
コマンド承認を設定する Exec 承認, 詳細
Mac ノードコマンドとアプリ IPC を調査する macOS IPC
ログをキャプチャする macOS ロギング
ソースからビルドする macOS 開発セットアップ

関連

Was this useful?
On this page

On this page