system.run。
使用 Quick Chat,無須開啟完整視窗即可使用類似 Spotlight 的主工作階段輸入框。預設按下 Option-Space (⌥Space)、從選單列選單選取,或在 Settings → General 中錄製其他快捷鍵。
只需要命令列介面和閘道?請從開始使用著手。
下載
從 OpenClaw GitHub 發行版本取得 macOS App 組建。 當發行版本包含 macOS App 資產時,請尋找:OpenClaw-<version>.dmg(建議)OpenClaw-<version>.zip
首次執行
- 安裝並啟動 OpenClaw.app。
- 為本機閘道選擇 This Mac,或連線至遠端閘道。
- 等待 App 安裝相符的命令列介面執行環境。在本機模式下,它也會 安裝並啟動閘道。
- 透過即時模型檢查建立推論連線。通過檢查後,OpenClaw 會處理其餘設定。
- 完成 macOS 權限檢查清單,並傳送新手引導測試訊息。
更新
儀表板更新卡片會標示 App 將更新的項目:- Update Mac app + Gateway 表示已簽署的 App 擁有本機 launchd 閘道。Sparkle 會先更新 App;App 重新啟動後,會自動 將其閘道更新至相符版本並重新啟動,接著驗證 連線。
- Update Gateway 表示 App 已連線至遠端閘道、手動 管理的本機閘道,或 App 不擁有的其他安裝項目。此按鈕 會執行該閘道的一般更新流程,而不變更 Mac App。
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 通道或直接閘道連線。