macOSアプリ

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

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. アプリが対応する CLI ランタイムをインストールするまで待ちます。ローカルモードでは、 Gateway もインストールして起動します。
4. 稼働中のモデルを確認して推論を確立します。確認に成功すると、Crestodian が 残りのセットアップを処理します。
5. macOS の権限チェックリストを完了し、オンボーディングのテストメッセージを送信します。

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

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

アップデート

ダッシュボードのアップデートカードは、まず Sparkle を通じて署名済み macOS アプリを更新します。 アプリの再起動後、アプリが管理する対応ローカル Gateway を自動的に更新して再起動します。 Homebrew など、ユーザーが管理する CLI インストールでは、通常の Gateway 更新フローが維持され （カードが Gateway の更新を直接実行します）、自動修復によって新しい Gateway が ダウングレードされたり、extended-stable チャネルの固定が上書きされたりすることはありません。

Sparkle は Gateway の update.channel 設定に従います。beta と dev では ベータ版アプリのビルドが有効になり、stable、extended-stable、および値が未設定または不明な場合は、 安定版アプリのビルドが使用されます。

ダッシュボードのリンクを開く

macOS アプリの埋め込みダッシュボードで外部 Web リンクをクリックすると、サイズ変更可能なブラウザーサイドバーで開きます。各リンクは個別のタブで開き、同じリンクを再度クリックすると既存のタブが再利用されます。タブをドラッグして並べ替えたり、タブの閉じるボタンまたは中クリックで閉じたりできます。また、タブを右クリックすると、Open in Default Browser、Copy Link、Reload、Close Tab、Close Other Tabs を選択できます。ウィンドウのタイトルバーにある戻る／進むコントロールとトラックパッドのスワイプではダッシュボードの履歴を移動し、サイドバー独自の戻る／進むコントロールではアクティブなタブの履歴を移動します。サイドバーには再読み込み、デフォルトブラウザーで開く、閉じるためのコントロールもあり、幅も記憶されます。

タイトルバーのコントロールはアプリのサイドバーに連動します。展開中は、戻る／進むコントロールがサイドバー切り替えボタンの隣にある右端に配置されます。折りたたみ中は、検索ボタン（コマンドパレットを開きます）と新規セッションボタンのために場所を空けます。

外部リンクを右クリックすると、Open in Sidebar、Open in Default Browser、または Copy Link を選択できます。修飾キーを押しながらのクリック、およびダッシュボードからユーザー操作で開かれる新規ウィンドウリンクは、引き続きデフォルトブラウザーで開きます。サイドバー内の新規ウィンドウリンクは、新しいサイドバータブとして開きます。通常のブラウザーでホストされる Control UI ページでは、ブラウザー標準のリンク動作とコンテキストメニュー動作が維持されます。

ブラウザーのログイン情報をインポートする

アプリがローカル Gateway に接続して動作し、Cookie を含む Chrome 系プロファイルが Mac 上に存在する場合、ダッシュボードウィンドウには、エージェントがブラウジングに使用する分離された管理対象プロファイルへ Cookie をコピーするための、閉じることができるバナーが表示されます。バナーの Import コントロールからプロファイルを選択します（Touch ID が必要な場合があります）。進行状況とインポートされた Cookie 数がインラインで表示され、コピーされるのは Cookie のみです。パスワードがコピー元ブラウザーから外部に出ることはありません。バナーを閉じるとその選択が記録されます。Settings → General → Browser login → Import… から、いつでも再度表示できます。基盤となるインポートフローと browser.allowSystemProfileImport ゲートについては、ブラウザーを参照してください。

Gateway モードを選択する

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

アプリが管理するもの

• メニューバーのステータス、通知、ヘルス状態、および WebChat。
• 画面、マイク、音声認識、オートメーション、アクセシビリティに関する macOS の権限プロンプト。
• ネイティブの Canvas、カメラ／画面キャプチャ、通知、位置情報、コンピューター制御と、CLI Node ホストのシステム、ブラウザー、Plugin、Skills、MCP コマンドを組み合わせた 1 つの Mac Node。
• Mac ホスト型コマンドに対する実行承認プロンプト。
• 承認済みシェルコマンドのアプリコンテキストでの実行。CLI ランタイムが共有 Node ポリシーを管理しながら、アプリに対する macOS の権限帰属を維持します。
• リモートモードの SSH トンネルまたは Gateway への直接接続。

アプリは Gateway や一般的な CLI ドキュメントの代わりにはなりません。Gateway の 設定、プロバイダー、Plugin、チャネル、ツール、セキュリティについては、 それぞれのドキュメントを参照してください。

macOS の詳細ページ

関連項目

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