如何在 macOS 安裝 OpenClaw？

建議先用快速路徑指令：npm install -g openclaw@latest && openclaw onboard

若啟動被 gateway mode 阻擋，該怎麼做？

先走 gateway.mode=local 專頁排障，並以 openclaw doctor 與 logs --follow 逐步驗證。

先做 doctor 檢查、查看啟動日誌，再跑一次端到端命令測試。

macOS 安裝指南

適合本機優先使用者，支援原生 App 與 CLI 上線路徑，能快速完成配對與啟動檢查。

快速路徑（多數使用者）

全域安裝 CLI 並直接進入引導式設定流程。

npm install -g openclaw@latest && openclaw onboard

一鍵安裝腳本

單行腳本安裝，適合快速起機。

curl -fsSL https://openclaw.ai/install.sh | bash

進階 / 原始碼路徑

適合需要客製或參與開發的使用者。

git clone https://github.com/openclaw/openclaw.git && cd openclaw && pnpm install && pnpm run build

macOS 平台指南

平台特定的架構與設定要點。

配對與 gateway 檢查

確認本機配對與通訊狀態。

疑難排解總覽

常見失敗情境與排查流程。

修復 gateway.mode=local 啟動阻擋

這是最常見的啟動中斷之一，頁面已整理根因與執行順序。

看懂 openclaw logs --follow

對照正常與異常輸出，快速定位 OpenClaw 設定問題。

安裝排障助理

提供你現在的指令與現象，助理會回傳最精確的 docs 路徑與下一步。

來自官方文件

我可以協助你在 macOS 完成 OpenClaw 安裝、設定與排障。

Common questions: