Openclaw 新手安裝 ｜ Mac OS 使用者，Docker 隔離版本

OpenClaw 安裝教學（macOS・Docker 隔離版）

適用對象：已經在使用 Mac 的一般使用者，想在不影響原有系統的前提下，安全安裝 OpenClaw
最後更新：2026-02-14
預計時間：約 40–60 分鐘（含下載等待）

🔒 權限分布：

• 私密區域（700，只有你能讀寫）：credentials、agents、workspace、logs、telegram、openclaw-data
• 公開讀取（755，但只有你能寫）：cron、devices、identity、canvas、completions

做什麼：Homebrew 是 macOS 的「App Store for 開發者」，之後裝 Node.js 都靠它。

⏳ 安裝過程中會要求你輸入 Mac 登入密碼（輸入時畫面不會顯示字元，這是正常的）。
整個過程大約 2–5 分鐘。

做什麼：告訴系統「去哪裡找 brew 指令」。寫在 是最乾淨的做法。

你應該看到：（版本號）
如果看到 ：回到步驟 1-2 重做

做什麼：Homebrew 預設會回傳匿名使用統計。如果你在意隱私，可以關閉。

驗證已關閉：

你應該看到：

做什麼：OpenClaw 是用 JavaScript/Node.js 寫的，需要 Node.js 執行環境。

如果看到版本號（例如 ）：跳到步驟 2-3 驗證路徑
如果看到 ：繼續步驟 2-2

⏳ 大約 1–3 分鐘。

做什麼：確認系統使用的是 Homebrew 安裝的 Node.js，而非其他來源（避免日後衝突）。

你應該看到：

你應該看到： 或更高

你應該看到：

你應該看到： 或更高

如果你之前裝過 （Node Version Manager），請不要混用。用 就夠了。混用會導致 OpenClaw 的背景服務（daemon）日後找不到正確的 Node.js 路徑。

你應該看到：版本號（例如 ）

做什麼：讓 OpenClaw 自我診斷，確認所有依賴都就緒。

做什麼：這一步會引導你設定 API 金鑰、模型、Telegram Bot 等等，並安裝背景服務。

以下是精靈會問你的重要設定，逐一說明：

做什麼：選擇你要用哪家 AI 服務商和哪個模型。

如果你使用 OpenRouter（建議初學者用）：

⚠️ 不要把 default model 填成 卻沒設定 Anthropic 的 API key，否則會出現警告：

做什麼：讓你的 Bot 可以在 Telegram 上回覆你。

B-1：取得 Bot Token

1. 在 Telegram 搜尋 @BotFather
2. 傳送
3. 輸入 Bot 顯示名稱（例如：）
4. 輸入 Bot username（必須唯一，例如：）
5. BotFather 會回覆一串 Token，複製它

⚠️ 注意：如果你貼的是舊 Token，會連到舊的 Bot（不是新建的）。

B-2：設定 allowFrom

精靈會問：

強烈建議：填你的 user id（純數字），比 @username 更穩定、不會因為改名而失效。

取得 user id 的方法：在 Telegram 搜尋 ，傳 ，它會回覆你的 ID。

精靈會問：

建議先裝這兩個就好（低風險、最實用）：

其他 skill 先不急，用到再補。看到「缺 XX 個 requirements」是正常的。

精靈會問：

新手建議勾選：

⚠️ 會持續累積上下文，可能耗 token 也有隱私考量 → 等你熟悉後再開。

精靈會問：

建議選：
理由：最穩、適合貼 log 和長內容，像是工程控制台。

搜尋你剛才建立的 Bot username（例如 ）

傳送：

如果畫面出現 pairing code，照 TUI 端的指示輸入或 approve 即可。

你應該看到：Bot 回覆你（內容由 AI 模型產生）
如果沒回覆：檢查 TUI 畫面是否有錯誤訊息

做什麼：確保敏感資料只有你本人能存取。

你應該看到：

• 、、、、 顯示 （700）
• 、、、、 顯示 （755）

做什麼：每天凌晨自動備份重要資料，保留 30 天，超過自動清理。

確認備份成功：

你應該看到：、、 等資料夾

你應該看到：每個項目顯示 已備份

如果問你選擇編輯器，選 （最簡單）。

在打開的檔案最底部加上這一行：

意思是：每天凌晨 2:00 執行備份腳本。

儲存並離開（nano 的話：按 儲存 → 確認 → 離開）。

你應該看到：包含 的那一行

做什麼：從頭到尾確認每個環節都正常。

openclaw docker 教程

你應該看到：一行包含 PID 數字和 的輸出
如果看到 ：執行 重新安裝

用瀏覽器打開：

在 Telegram 傳 或 給你的 Bot。

回到 階段一 步驟 1-2，重新設定 PATH 後執行：

重新跑一次設定精靈。

1. 確認 daemon 在跑：
2. 確認 Bot Token 正確：檢查 裡的設定
3. 確認 是你的 user id

如果之前用 nvm 裝了 Node.js，現在想改用 brew：

然後確認 顯示 。

📝 備忘：這份文件假設你是一般 Mac 使用者，不需要 Docker 容器化。備份系統透過 cron + shell script 實現，資料存放在 目錄，權限嚴格控管，敏感資料只有你本人能存取。