GitHub Repo
OpenHands 1.23.0 改用通用 macOS 安裝包,修正 Intel 執行環境不相容
新版同時封裝 Intel 與 Apple Silicon 所需的 Node.js、uv,啟動時依架構選取。桌面版仍屬早期預覽,完整代理流程與後端設定須在實際環境驗證。

OpenHands 於 9 月 23 日發布 Agent Canvas 1.23.0,將 macOS 桌面安裝包改為同時支援 Intel 與 Apple Silicon 的 universal DMG。新版把兩種架構的 Node.js 與 uv 一起封裝,啟動時選用對應版本,處理 Intel Mac 收到 arm64 執行檔而無法使用的問題。[發布說明](https://docs.openhands.dev/openhands/usage/agent-canvas/release-notes/v1.23.0)、[修補 PR](https://github.com/OpenHands/OpenHands/pull/17225)
這項修改影響程式代理的本機啟動鏈。Agent Canvas 負責管理對話、檔案、終端機與自動化,實際代理及工具則由後端服務執行;桌面程式會自動啟動本機後端。即使視窗本身能開啟,只要隨附執行環境的架構不符,後續服務仍可能無法就緒。對混用新舊 Mac 的團隊,統一安裝包也減少分發與排查差異。[架構概覽](https://docs.openhands.dev/openhands/usage/agent-canvas/overview)、[桌面安裝文件](https://docs.openhands.dev/openhands/usage/agent-canvas/setup)
修補同時調整下載、封裝與執行時路徑。建置流程準備四個依架構區分的 Node.js、uv 目錄,啟動解析器依 `process.arch` 優先選取相符目錄,找不到時才回退至舊式平面目錄。封裝設定也處理 `@electron/universal` 合併 Mach-O 檔案的限制,避免只合併 Electron 主程式,卻留下不相容的輔助執行檔。[實作細節](https://github.com/OpenHands/OpenHands/pull/17225)
公開討論附有 Intel Mac 的啟動紀錄,顯示程式載入 x64 執行環境並等到後端回應。合併前也加入 Intel、arm64 原生建置檢查,以及可手動觸發的完整 universal DMG 建置。這些證據涵蓋封裝與啟動路徑;兩種硬體上的完整代理任務、外部工具及模型連線,仍應由部署團隊按實際設定驗證。[審查與驗證紀錄](https://github.com/OpenHands/OpenHands/pull/17225)
執行位置也需在遷移時核對。官方把本機後端、容器與遠端虛擬機列為不同部署方式,代理可見的檔案取決於連接的工作區。企業若原先使用容器隔離,換成桌面入口後仍應選取相同後端與掛載範圍,維持一致的工具環境與權限邊界。這項檢查對需要讀寫原始碼、執行測試與使用憑證的流程尤其直接。[後端與工作區](https://docs.openhands.dev/openhands/usage/agent-canvas/overview)
桌面版目前仍被官方列為早期預覽,macOS 應用也採 ad-hoc 簽署,作業系統可能阻擋開啟。升級後可從「Show details」取得啟動紀錄,先確認執行環境與後端就緒,再測試讀寫專案及工具呼叫。模型可位於本機或遠端 API,安裝成功與模型推論效能須分別評估。[安裝與疑難排解](https://docs.openhands.dev/openhands/usage/agent-canvas/setup)