macOS 應用程式

macOS App 是 OpenClaw 的選單列夥伴：提供原生系統匣介面、macOS 權限提示、通知、WebChat、語音輸入、Canvas，以及 由 Mac 託管的節點工具，例如 system.run。

使用 Quick Chat，無須開啟完整視窗即可使用類似 Spotlight 的主工作階段輸入框。預設按下 Option-Space (⌥Space)、從選單列選單選取，或在 Settings → General 中錄製其他快捷鍵。

只需要命令列介面和閘道？請從開始使用著手。

下載

從 OpenClaw GitHub 發行版本取得 macOS App 組建。 當發行版本包含 macOS App 資產時，請尋找：

• OpenClaw-<version>.dmg（建議）
• OpenClaw-<version>.zip

部分發行版本只包含命令列介面、證明資料或 Windows 資產。如果最新發行版本 沒有 macOS App 資產，請使用包含該資產的最新版本，或依照 macOS 開發設定從原始碼組建。

首次執行

1. 安裝並啟動 OpenClaw.app。
2. 為本機閘道選擇 This Mac，或連線至遠端閘道。
3. 等待 App 安裝相符的命令列介面執行環境。在本機模式下，它也會 安裝並啟動閘道。
4. 透過即時模型檢查建立推論連線。通過檢查後，OpenClaw 會處理其餘設定。
5. 完成 macOS 權限檢查清單，並傳送新手引導測試訊息。

如果 App 連線到現有閘道，且其預設代理程式已設定 模型，它會將該閘道視為已完成設定、略過供應商新手引導和 OpenClaw，並開啟儀表板。如果無法連線至閘道，或其 預設代理程式沒有模型，推論新手引導仍可用於 復原。

若要使用命令列介面／閘道設定流程，請參閱開始使用。 若要復原權限，請參閱 macOS 權限。

更新

儀表板更新卡片會標示 App 將更新的項目：

• Update Mac app + Gateway 表示已簽署的 App 擁有本機 launchd 閘道。Sparkle 會先更新 App；App 重新啟動後，會自動 將其閘道更新至相符版本並重新啟動，接著驗證 連線。
• Update Gateway 表示 App 已連線至遠端閘道、手動 管理的本機閘道，或 App 不擁有的其他安裝項目。此按鈕 會執行該閘道的一般更新流程，而不變更 Mac App。

協調更新失敗時，會停留在其設定樣式視窗，並提供重試、 更新指南和 Discord 操作。自動修復絕不會 將較新的閘道降級，也不會覆寫 extended-stable 通道釘選。

成功更新後，App 會找出最近由真人使用的 最上層直接工作階段，並向該代理程式提供一次性更新事件。心跳偵測 和排程活動不會影響此選擇。接著，代理程式可以從你最可能使用的 對話中歡迎你回來。在遠端模式下，App 只會更新本機 Mac 節點執行環境；如果遠端閘道比 App 舊， 則會略過通知。

Sparkle 會遵循閘道的 update.channel 設定。beta 和 dev 會選擇加入 Beta App 組建；stable、extended-stable，以及缺少或未知的值 則會維持使用穩定版 App 組建。

開啟儀表板連結

在 macOS App 的內嵌儀表板中，按一下外部網頁連結會在可調整大小的瀏覽器側邊欄中開啟，預設占視窗寬度的一半，同時保留儀表板導覽。拖曳分隔線即可選擇其他寬度；App 會記住該設定。每個連結都會在自己的分頁中開啟；開啟多個頁面時會顯示分頁列，再次按一下相同連結會重複使用現有分頁。拖曳分頁可重新排序，使用分頁關閉按鈕或按一下滑鼠中鍵即可關閉分頁；在分頁上按一下滑鼠右鍵可使用 Open in Default Browser、Copy Link、Reload、Close Tab 和 Close Other Tabs。視窗標題列的上一頁／下一頁控制項和觸控式軌跡板滑動手勢會導覽儀表板歷程記錄；側邊欄本身的上一頁／下一頁控制項則會導覽目前分頁的歷程記錄。側邊欄也提供重新載入、在預設瀏覽器中開啟及關閉控制項。

標題列控制項會配合 App 側邊欄：展開時，上一頁／下一頁位於其右側邊緣、緊鄰側邊欄切換按鈕；收合時，這些控制項會讓位給搜尋按鈕（開啟命令選擇區）和新增工作階段按鈕。

在外部連結上按一下滑鼠右鍵，可選擇 Open in Sidebar、Open in Default Browser 或 Copy Link。從儀表板進行的輔助按鍵點擊，以及由使用者啟動的新視窗連結，仍會在預設瀏覽器中開啟；側邊欄內的新視窗連結則會以新的側邊欄分頁開啟。一般由瀏覽器託管的 Control UI 頁面會保留瀏覽器的一般連結與內容選單行為。

匯入瀏覽器登入資料

當 App 連線至本機閘道時，瀏覽器側邊欄首次開啟之際，如果 Mac 上存在含 Cookie 的 Chrome 系列設定檔，儀表板會顯示可關閉的橫幅。此橫幅可將這些 Cookie 複製到代理程式用於瀏覽的隔離式受管理設定檔。從其 Import 控制項選擇設定檔（可能需要 Touch ID）；進度和已匯入的 Cookie 數量會顯示在行內，而且只會複製 Cookie——密碼絕不會離開來源瀏覽器。關閉橫幅會記錄此選擇；Settings → General → Browser login → Import… 可隨時再次提供此功能。請參閱瀏覽器，了解底層匯入流程和 browser.allowSystemProfileImport 閘門。

選擇閘道模式

兩種模式都需要已安裝的 openclaw 命令列介面，因為 App 會重複使用其節點主機 執行環境。在全新的 Mac 上，App 會自動安裝相符的命令列介面；接著，本機 模式會啟動閘道精靈，而遠端模式則會連線至所選 閘道，不會啟動第二個本機閘道。 若要手動復原，請參閱 macOS 上的閘道。

App 負責的項目

• 選單列狀態、通知、健康狀態、WebChat，以及浮動的 Quick Chat 列。
• 螢幕、麥克風、語音、Automation 和 Accessibility 的 macOS 權限提示。
• 一個 Mac 節點，將原生 Canvas、相機／螢幕擷取、通知、 位置和電腦控制，與命令列介面節點主機的系統、瀏覽器、 外掛、技能和 MCP 命令結合。
• Mac 託管命令的執行核准提示。
• 在 App 情境中執行已核准的 Shell 命令，在命令列介面執行環境 負責共用節點原則的同時，保留 App 的 macOS 權限歸屬。
• 遠端模式 SSH 通道或直接閘道連線。

在內嵌 Control UI 中，Settings → Notifications 會顯示 App 的原生 通知權限，而不是瀏覽器推播，因為 App 會以原生方式傳遞通知。

App 不會取代閘道或一般命令列介面文件。閘道 設定、供應商、外掛、通道、工具和安全性各有 專屬文件。

macOS 詳細資訊頁

相關內容

• 平台
• 開始使用
• 閘道
• 執行核准