macOSアプリ

macOS アプリは OpenClaw のメニューバーコンパニオンです。ネイティブのトレイ UI、macOS の権限プロンプト、通知、WebChat、音声入力、Canvas、および system.run などの Mac ホスト型 Node ツールを提供します。

フルウィンドウを開かずに Spotlight 風のメインセッション入力画面を使用するには、クイックチャットを使用します。デフォルトでは Option-Space（⌥Space）を押すか、メニューバーのメニューから選択します。または、設定 → 一般で別のショートカットを登録します。

CLI と Gateway だけが必要な場合は、はじめにを参照してください。

ダウンロード

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

• OpenClaw-<version>.dmg（推奨）
• OpenClaw-<version>.zip

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

初回起動

1. OpenClaw.appをインストールして起動します。
2. ローカル Gateway を使用する場合はこの Macを選択し、それ以外の場合はリモート Gateway に接続します。
3. アプリが対応する CLI ランタイムをインストールするまで待ちます。ローカルモードでは、Gateway もインストールして起動します。
4. 実際のモデルチェックで推論接続を確立します。チェックに合格すると、OpenClaw が残りのセットアップを処理します。
5. macOS の権限チェックリストを完了し、オンボーディングのテストメッセージを送信します。

アプリが、デフォルトエージェントにモデルが設定済みの既存 Gateway に接続した場合、その Gateway はすでにセットアップ済みとみなされ、プロバイダーのオンボーディングと OpenClaw のセットアップをスキップしてダッシュボードを開きます。Gateway に接続できない場合や、デフォルトエージェントにモデルがない場合は、復旧のために推論のオンボーディングを引き続き利用できます。

CLI/Gateway のセットアップ手順については、はじめにを参照してください。 権限を復旧するには、macOS の権限を参照してください。

アップデート

ダッシュボードのアップデートカードには、アプリが更新する対象が表示されます。

• Mac アプリと Gateway をアップデートは、署名済みアプリがローカルの launchd Gateway を管理していることを意味します。Sparkle が最初にアプリを更新します。再起動後、アプリは Gateway を対応するバージョンへ自動的に更新して再起動し、接続を検証します。
• Gateway をアップデートは、アプリがリモート Gateway、手動管理されているローカル Gateway、またはアプリが管理していない別のインストールに接続していることを意味します。このボタンは Mac アプリを変更せず、その Gateway の通常のアップデート処理を実行します。

連携アップデートに失敗した場合は、再試行、アップデートガイド、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 ゲートについては、ブラウザーを参照してください。

Gateway モードを選択する

アプリは Node ホストランタイムを再利用するため、どちらのモードでも openclaw CLI がインストールされている必要があります。新しい Mac では、アプリが対応する CLI を自動的にインストールします。その後、ローカルモードでは Gateway ウィザードを起動し、リモートモードでは2つ目のローカル Gateway を起動せず、選択した Gateway に接続します。 手動で復旧する方法については、macOS 上の Gatewayを参照してください。

アプリが管理するもの

• メニューバーのステータス、通知、正常性、WebChat、およびフローティング表示されるクイックチャットバー。
• 画面、マイク、音声認識、オートメーション、アクセシビリティに関する macOS の権限プロンプト。
• ネイティブの Canvas、カメラ／画面キャプチャ、通知、位置情報、コンピューター制御と、CLI Node ホストのシステム、ブラウザー、Plugin、Skill、MCP コマンドを統合する1つの Mac Node。
• Mac ホスト型コマンドに対する実行承認プロンプト。
• 承認されたシェルコマンドをアプリのコンテキストで実行する機能。CLI ランタイムが共有 Node ポリシーを管理する一方で、アプリに対する macOS の権限帰属を維持します。
• リモートモードの SSH トンネルまたは Gateway への直接接続。

組み込みの Control UI では、アプリが通知をネイティブに配信するため、設定 → 通知にブラウザーのプッシュ通知ではなく、アプリのネイティブ通知権限が表示されます。

アプリは Gateway または一般的な CLI ドキュメントを置き換えるものではありません。Gateway の設定、プロバイダー、プラグイン、チャンネル、ツール、セキュリティについては、それぞれのドキュメントを参照してください。

macOS の詳細ページ

関連項目

• プラットフォーム
• はじめに
• Gateway
• 実行承認