--- read_when: - macOSアプリのインストール - macOS でローカルとリモートの Gateway モードを選択する - macOS アプリのリリース版ダウンロードを探す summary: OpenClaw macOSメニューバーアプリのインストールと使用 title: macOSアプリ x-i18n: generated_at: "2026-07-26T10:20:47Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 32 provider: openai source_hash: b319d72bcbffcf91b6bc012d352c2cf647abd66e08ab0146cf98f5edfae3bca1 source_path: platforms/macos.md workflow: 16 --- macOS アプリは OpenClaw の**メニューバーコンパニオン**です。ネイティブのトレイ UI、macOS の権限プロンプト、通知、WebChat、音声入力、Canvas、および `system.run` などの Mac ホスト型 Node ツールを提供します。 フルウィンドウを開かずに Spotlight 風のメインセッション入力画面を使用するには、**クイックチャット**を使用します。デフォルトでは Option-Space（⌥Space）を押すか、メニューバーのメニューから選択します。または、**設定 → 一般**で別のショートカットを登録します。 CLI と Gateway だけが必要な場合は、[はじめに](/ja-JP/start/getting-started)を参照してください。 ## ダウンロード macOS アプリのビルドは、[OpenClaw GitHub リリース](https://github.com/openclaw/openclaw/releases)から入手できます。 リリースに macOS アプリのアセットが含まれている場合は、次を探してください。 - `OpenClaw-.dmg`（推奨） - `OpenClaw-.zip` リリースによっては、CLI、証拠資料、または Windows のアセットのみが含まれます。最新リリースに macOS アプリのアセットがない場合は、アセットが含まれる最新のリリースを使用するか、[macOS 開発環境のセットアップ](/ja-JP/platforms/mac/dev-setup)に従ってソースからビルドしてください。 ## 初回起動 1. **OpenClaw.app**をインストールして起動します。 2. ローカル Gateway を使用する場合は**この Mac**を選択し、それ以外の場合はリモート Gateway に接続します。 3. アプリが対応する CLI ランタイムをインストールするまで待ちます。ローカルモードでは、Gateway もインストールして起動します。 4. 実際のモデルチェックで推論接続を確立します。チェックに合格すると、OpenClaw が残りのセットアップを処理します。 5. macOS の権限チェックリストを完了し、オンボーディングのテストメッセージを送信します。 アプリが、デフォルトエージェントにモデルが設定済みの既存 Gateway に接続した場合、その Gateway はすでにセットアップ済みとみなされ、プロバイダーのオンボーディングと OpenClaw のセットアップをスキップしてダッシュボードを開きます。Gateway に接続できない場合や、デフォルトエージェントにモデルがない場合は、復旧のために推論のオンボーディングを引き続き利用できます。 CLI/Gateway のセットアップ手順については、[はじめに](/ja-JP/start/getting-started)を参照してください。 権限を復旧するには、[macOS の権限](/ja-JP/platforms/mac/permissions)を参照してください。 ## アップデート ダッシュボードのアップデートカードには、アプリが更新する対象が表示されます。 - **Mac アプリと Gateway をアップデート**は、署名済みアプリがローカルの launchd Gateway を管理していることを意味します。Sparkle が最初にアプリを更新します。再起動後、アプリは Gateway を対応するバージョンへ自動的に更新して再起動し、接続を検証します。 - **Gateway をアップデート**は、アプリがリモート Gateway、手動管理されているローカル Gateway、またはアプリが管理していない別のインストールに接続していることを意味します。このボタンは Mac アプリを変更せず、その Gateway の通常のアップデート処理を実行します。 連携アップデートに失敗した場合は、再試行、[アップデートガイド](/ja-JP/install/updating)、Discord の各アクションを備えたセットアップ形式のウィンドウがそのまま表示されます。自動修復によって新しい Gateway がダウングレードされたり、`extended-stable` チャンネルの固定設定が上書きされたりすることはありません。 アップデートに成功すると、アプリは人間が最後に使用した最上位のダイレクトセッションを特定し、そのエージェントに一度限りのアップデートイベントを送信します。Heartbeat と Cron のアクティビティは、この選択に影響しません。その後、エージェントは、使用していた可能性が最も高い会話から再び応答できます。リモートモードでは、アプリはローカルの Mac Node ランタイムのみを更新し、リモート Gateway がアプリより古い場合は通知をスキップします。 Sparkle は Gateway の `update.channel` 設定に従います。`beta` と `dev` を指定するとベータ版アプリのビルドを使用し、`stable`、`extended-stable`、未指定または不明な値の場合は安定版アプリのビルドを使用します。 ## ダッシュボードのリンクを開く macOS アプリに組み込まれたダッシュボードで外部 Web リンクをクリックすると、ダッシュボードのナビゲーションを表示したまま、ウィンドウ幅の半分を占めるサイズ変更可能なブラウザーサイドバーでリンクが開きます。仕切りをドラッグして幅を変更できます。選択した幅はアプリに記憶されます。各リンクは個別のタブで開き、複数のページを開くとタブバーが表示されます。同じリンクをもう一度クリックすると、既存のタブが再利用されます。タブをドラッグして並べ替え、タブの閉じるボタンまたは中クリックで閉じることができます。また、タブを右クリックすると、**デフォルトブラウザーで開く**、**リンクをコピー**、**再読み込み**、**タブを閉じる**、**ほかのタブを閉じる**を使用できます。ウィンドウのタイトルバーにある戻る／進むコントロールとトラックパッドのスワイプはダッシュボードの履歴を移動し、サイドバー独自の戻る／進むコントロールはアクティブなタブの履歴を移動します。サイドバーには、再読み込み、デフォルトブラウザーで開く、閉じるためのコントロールもあります。 タイトルバーのコントロールはアプリのサイドバーに追従します。サイドバーが展開されている間、戻る／進むコントロールはサイドバー切り替えボタンの隣にある右端に配置されます。サイドバーが折りたたまれている間は、検索ボタン（コマンドパレットを開きます）と新規セッションボタンのためにスペースを空けます。 外部リンクを右クリックすると、**サイドバーで開く**、**デフォルトブラウザーで開く**、または**リンクをコピー**を選択できます。修飾キーを使用したクリックと、ダッシュボードからユーザー操作によって開かれる新規ウィンドウのリンクは、引き続きデフォルトブラウザーで開きます。サイドバー内の新規ウィンドウのリンクは、新しいサイドバータブとして開きます。通常のブラウザーでホストされる Control UI ページでは、ブラウザー標準のリンクおよびコンテキストメニューの動作が維持されます。 ## ブラウザーのログイン情報をインポートする アプリがローカル Gateway に接続している状態で初めてブラウザーサイドバーを開くと、Mac 上に Cookie を含む Chrome 系のプロファイルが存在する場合、ダッシュボードに閉じることのできるバナーが表示されます。このバナーでは、エージェントがブラウジングに使用する分離された管理対象プロファイルへ Cookie をコピーできます。**インポート**コントロールからプロファイルを選択します（Touch ID が必要になる場合があります）。進行状況とインポートされた Cookie の数がその場に表示され、コピーされるのは Cookie だけです。パスワードが元のブラウザーから外部へ送信されることはありません。バナーを閉じると、その選択が記録されます。**設定 → 一般 → ブラウザーへのログイン → インポート…**から、いつでも再表示できます。内部のインポート処理と `browser.allowSystemProfileImport` ゲートについては、[ブラウザー](/ja-JP/cli/browser)を参照してください。 ## Gateway モードを選択する | モード | 使用する状況 | 詳細ページ | | ------ | ------------------------------------------------------------------------------ | -------------------------------------------------- | | ローカル | この Mac で Gateway を実行し、launchd によって常時稼働させる場合。 | [macOS 上の Gateway](/ja-JP/platforms/mac/bundled-gateway) | | リモート | 別のホストで Gateway を実行し、この Mac から SSH、LAN、または Tailnet 経由で制御する場合。 | [リモート制御](/ja-JP/platforms/mac/remote) | アプリは Node ホストランタイムを再利用するため、どちらのモードでも `openclaw` CLI がインストールされている必要があります。新しい Mac では、アプリが対応する CLI を自動的にインストールします。その後、ローカルモードでは Gateway ウィザードを起動し、リモートモードでは2つ目のローカル Gateway を起動せず、選択した Gateway に接続します。 手動で復旧する方法については、[macOS 上の Gateway](/ja-JP/platforms/mac/bundled-gateway)を参照してください。 ## アプリが管理するもの - メニューバーのステータス、通知、正常性、WebChat、およびフローティング表示されるクイックチャットバー。 - 画面、マイク、音声認識、オートメーション、アクセシビリティに関する macOS の権限プロンプト。 - ネイティブの Canvas、カメラ／画面キャプチャ、通知、位置情報、コンピューター制御と、CLI Node ホストのシステム、ブラウザー、Plugin、Skill、MCP コマンドを統合する1つの Mac Node。 - Mac ホスト型コマンドに対する実行承認プロンプト。 - 承認されたシェルコマンドをアプリのコンテキストで実行する機能。CLI ランタイムが共有 Node ポリシーを管理する一方で、アプリに対する macOS の権限帰属を維持します。 - リモートモードの SSH トンネルまたは Gateway への直接接続。 組み込みの Control UI では、アプリが通知をネイティブに配信するため、**設定 → 通知**にブラウザーのプッシュ通知ではなく、アプリのネイティブ通知権限が表示されます。 アプリは Gateway または一般的な CLI ドキュメントを置き換えるものでは**ありません**。Gateway の設定、プロバイダー、プラグイン、チャンネル、ツール、セキュリティについては、それぞれのドキュメントを参照してください。 ## macOS の詳細ページ | タスク | 参照先 | | ---------------------------------------- | ------------------------------------------------------------------------------------------- | | CLI/Gateway サービスをインストールまたはデバッグする | [macOS 上の Gateway](/ja-JP/platforms/mac/bundled-gateway) | | クラウド同期フォルダーに状態を保存しないようにする | [macOS 上の Gateway](/ja-JP/platforms/mac/bundled-gateway#state-directory-on-macos) | | アプリの検出と接続をデバッグする | [macOS 上の Gateway](/ja-JP/platforms/mac/bundled-gateway#debug-app-connectivity) | | launchd の動作を理解する | [Gateway のライフサイクル](/ja-JP/platforms/mac/child-process) | | 権限または署名／TCC の問題を修正する | [macOS の権限](/ja-JP/platforms/mac/permissions) | | 最後に使用した Mac を検出する | [アクティブなコンピューターのプレゼンス](/ja-JP/nodes/presence) | | リモート Gateway に接続する | [リモート制御](/ja-JP/platforms/mac/remote) | | メニューバーのステータスと正常性チェックを確認する | [メニューバー](/ja-JP/platforms/mac/menu-bar)、[正常性チェック](/ja-JP/platforms/mac/health) | | 組み込みのチャット UI を使用する | [WebChat](/ja-JP/platforms/mac/webchat) | | 音声ウェイクまたはプッシュトゥトークを使用する | [音声ウェイク](/ja-JP/platforms/mac/voicewake) | | Canvas と Canvas のディープリンクを使用する | [Canvas](/ja-JP/platforms/mac/canvas) | | UI オートメーション用に PeekabooBridge をホストする | [Peekaboo ブリッジ](/ja-JP/platforms/mac/peekaboo) | | コマンドの承認を設定する | [実行承認](/ja-JP/tools/exec-approvals)、[高度な詳細](/ja-JP/tools/exec-approvals-advanced) | | Mac Node のコマンドとアプリの IPC を調べる | [macOS IPC](/ja-JP/platforms/mac/xpc) | | ログを取得する | [macOS のログ記録](/ja-JP/platforms/mac/logging) | | ソースからビルドする | [macOS 開発環境のセットアップ](/ja-JP/platforms/mac/dev-setup) | ## 関連項目 - [プラットフォーム](/ja-JP/platforms) - [はじめに](/ja-JP/start/getting-started) - [Gateway](/ja-JP/gateway) - [実行承認](/ja-JP/tools/exec-approvals)