---
title: "OpenClaw 龍蝦 Peekaboo AI 自動化助手安裝教學：4 步驟新手完整指南"
slug: openclaw-peekaboo-installation-guide
url: https://medici.work/posts/openclaw-peekaboo-installation-guide
published_at: 2026-02-08
modified_at: 2026-02-08
author: "林思翰 Hans - AI 品牌動畫導演"
category: "AI 相關知識"
tags: ["Peekaboo", "龍蝦", "OpenClaw"]
access: public_access
---

# OpenClaw 龍蝦 Peekaboo AI 自動化助手安裝教學：4 步驟新手完整指南

> 從安裝 Skill、CLI 工具到 macOS 權限設定，10 分鐘讓你的 AI 助手學會控制 Mac

By **林思翰 Hans - AI 品牌動畫導演** - Group.G 文化科技導演 | 2026-02-08

想讓你的 OpenClaw AI 助手不只會聊天，還能真正動手操作 Mac 嗎？這篇龍蝦 OpenClaw Peekaboo 自動化助手安裝教學，會用最白話的方式帶你從零完成所有設定。Peekaboo 是 OpenClaw 作者（Peter Steinberger）開發的核心擴充工具，安裝之後你的 OpenClaw AI 助手就能截圖、控制滑鼠、自動輸入文字，讓 macOS AI 自動化不再只是概念。不管你是用 Mac Mini 還是 MacBook，不管你有沒有碰過終端機，跟著這 4 個步驟走，10 分鐘就能搞定 Peekaboo 設定權限與全部安裝流程。 1. 龍蝦 OpenClaw Peekaboo 自動化助手安裝教學前必知在正式開始安裝之前，先花 2 分鐘搞懂 Peekaboo 到底是什麼、能做什麼。理解原理之後，後面每一步才不會心慌慌，也更清楚自己為什麼要做這些設定。1-1. Peekaboo 是什麼？為什麼你的 OpenClaw AI 助手需要它Peekaboo 是一套專為 macOS 設計的 AI 螢幕互動框架，由龍蝦 OpenClaw 的原作者親自開發。它扮演的角色很直接：把你的 OpenClaw AI 助手從「只能打字聊天的機器人」升級成「能看見螢幕、能動手操作的超級助手」。沒裝 Peekaboo 之前，你的 AI 助手頂多幫你回答問題、寫文章、跑簡單程式碼。裝了之後，它一口氣解鎖 5 大能力：看見螢幕內容（截圖加上畫面分析）精準控制滑鼠，點擊任何按鈕或連結自動輸入鍵盤文字和快捷鍵開啟、關閉、切換任何應用程式移動和縮放視窗，管理整個桌面社群裡常說「沒裝 Peekaboo 等於廢了一半」，這句話真的不誇張。因為 Peekaboo 直接決定了你的 AI 助手能不能從「動嘴」變成「動手」，是實現 macOS AI 自動化的必備基礎。1-2. 安裝前環境確認：macOS 版本、Mac Mini 與必備工具在動手之前，先確認你的環境符合以下條件。這步很多人跳過，結果安裝到一半才發現卡住，回頭浪費更多時間。系統需求清單：macOS 系統：Peekaboo 目前只支援 Mac，無論你是用 Mac Mini、MacBook Air、MacBook Pro 還是 iMac 都可以，但 Windows 和 Linux 暫時不支援OpenClaw 已安裝並正常運行：如果你還沒裝 OpenClaw，請先完成 OpenClaw 的安裝管理員權限：後面要改系統設定，需要輸入密碼授權網路連線：安裝過程需要下載套件你會用到兩個工具：終端機（Terminal）和系統設定。終端機聽起來很嚇人，但其實就是複製貼上指令而已，完全不需要會寫程式。📌 推薦閱讀：OpenClaw 完整安裝教學 2. 安裝 Peekaboo Skill：2 種方法任你選Skill 是 OpenClaw 的「技能包」機制，你可以把它想像成幫 AI 助手裝外掛。安裝 Peekaboo Skill 之後，你的助手才會「知道」自己有控制螢幕的能力。這一步是整個龍蝦 OpenClaw Peekaboo 自動化助手安裝教學的起點。2-1. 方法一：透過 OpenClaw Web 界面安裝（推薦新手）如果你對終端機完全陌生，這個方法最簡單。只要打字就能完成，三步搞定：第一步，確認你的 OpenClaw 正在運行，然後打開瀏覽器前往 OpenClaw 的操作界面。第二步，在對話框中直接輸入「請幫我安裝 Peekaboo skill」，按下送出。第三步，等待 AI 助手自動幫你處理，看到安裝成功的訊息就完成了。整個過程不需要碰終端機、不需要打任何指令，適合純新手第一次操作。2-2. 方法二：使用終端機手動安裝（進階用戶）如果你想學習怎麼用終端機，或者 Web 界面安裝遇到問題，可以改用手動方式。首先，按下 Cmd + 空白鍵 叫出 Spotlight 搜尋，輸入「Terminal」或「終端機」，按 Enter 開啟。接著，把下面這串指令完整複製貼上到終端機裡：npx skills add steipete/clawdis@peekaboo -g -y 按下 Enter 之後，畫面會跑一堆下載和安裝的文字，這是正常的。等到出現「Installation complete」就代表安裝成功。如果中間報錯，最常見的原因是網路不穩，重新執行一次通常就能解決。 3. 安裝 Peekaboo CLI 核心工具Skill 只是讓 AI 助手「知道」Peekaboo 的存在，但真正讓它能控制你電腦的，是 CLI 核心工具。CLI 是 Command Line Interface 的縮寫，你不需要理解它的技術細節，只要知道「這是讓 AI 能動手的引擎」就好。3-1. 透過 OpenClaw 一鍵安裝 CLI（最省事）跟上一步一樣，在 OpenClaw 的對話框輸入：請幫我安裝 Peekaboo CLI 工具 AI 助手會自動幫你跑完安裝流程，包括 OpenClaw Homebrew 安裝的部分也會一併處理。3-2. 手動 Homebrew 安裝與版本驗證如果你偏好手動操作，或者 OpenClaw 一鍵安裝沒有成功，可以自己來。開啟終端機，依序執行以下兩個指令。第一個指令是安裝 Peekaboo CLI：brew install steipete/tap/peekaboo 安裝完成後，用第二個指令確認是否成功：peekaboo --version 如果終端機回傳版本號，例如 Peekaboo 3.0.0-beta3，就代表安裝成功。如果出現 command not found，通常是 Homebrew 本身沒有安裝或 PATH 沒有設定好，這也是 OpenClaw Homebrew 安裝環節最常見的卡關點。Mac Mini 和所有 Apple Silicon 機型的 Homebrew 預設安裝在 /opt/homebrew/，Intel Mac 則在 /usr/local/，確認路徑正確即可。 4. Peekaboo 設定權限：螢幕錄製與輔助使用（最多人卡關）這是整個安裝流程中最關鍵、也最多人卡住的環節。macOS 為了安全，預設不會讓任何程式控制你的電腦。你必須手動到系統設定裡開權限，AI 助手才能真正「看見」和「操作」你的 Mac。4-1. 設定螢幕錄製權限（讓 AI 看見你的畫面）Peekaboo 設定權限的第一步是開啟螢幕錄製權限，步驟如下：點擊左上角的 Apple 選單，選擇「系統設定」。在左側找到「隱私權與安全性」，點進去之後再找到「螢幕與系統音訊錄製」。進入後你會看到一個程式清單，點擊右側的「+」按鈕來新增程式。這裡是關鍵，也是最多新手卡住的地方：彈出檔案選擇器之後，你會發現根本找不到 openclaw 這個程式。這是正常的，因為它藏在 /opt/homebrew/bin 這個隱藏資料夾裡，Finder 預設不會顯示。不要慌，macOS 有一個「前往資料夾」的快捷功能可以直接跳過去。在檔案選擇器的畫面中，按下 Cmd + Shift + G（三個鍵同時按），上方會彈出一個路徑輸入欄位，直接輸入： /opt/homebrew/bin按 Enter 就會自動跳到那個資料夾。如果你是 Intel Mac，路徑改為 /usr/local/bin。Apple Silicon 機型（包括 Mac Mini M1 / M2 / M3 / M4）一律用 /opt/homebrew/bin。在資料夾裡找到「openclaw」，選取之後確認它被打勾。接著重複同樣的步驟，再加入「node」，同樣確認打勾。這兩個程式都要加，缺一不可。openclaw 是主程式，node 是執行環境。4-2. 設定輔助使用權限與重啟螢幕錄製之外，還需要設定輔助使用權限，AI 助手才能控制滑鼠和鍵盤。回到「隱私權與安全性」頁面，這次點進「輔助使用」。如果清單裡已經有 openclaw 和 node，直接打勾就好。如果沒有，用跟上面一樣的方法手動加入：按「+」、Cmd + Shift + G、輸入路徑、找到程式、確認打勾。4-3. 輔助使用頁面空白？用這招強制觸發授權視窗很多人照著上面的步驟點進「輔助使用」之後，發現清單裡完全空白，沒有任何程式可以勾選，按「+」手動加入也不一定會出現允許的彈窗。這是 macOS 的安全機制，系統只有在程式「真正嘗試使用」輔助使用功能的那一刻，才會彈出授權請求。解決方法很簡單：開啟終端機，執行一次 Peekaboo 的截圖指令，強制讓它去呼叫 Accessibility API：peekaboo image --mode screen執行之後，macOS 應該會立刻彈出一個視窗，問你是否要允許這個程式控制你的電腦。點擊「允許」就好。如果彈窗沒有出現，也可以直接在 OpenClaw 對話框輸入「請移動滑鼠到螢幕中央」，這個動作同樣會觸發輔助使用的授權請求。觸發之後再回到「系統設定 → 隱私權與安全性 → 輔助使用」，你就會看到 openclaw 或 node 出現在清單裡了，確認它們被打勾即可。全部設定完之後，一定要做這件事：完全關閉 OpenClaw，等 10 秒以上，再重新啟動。很多人設定完權限之後沒有重啟，結果怎麼測試都不成功，回頭才發現是忘了這一步。 5. 測試 Peekaboo 功能是否正常運作安裝和權限都搞定了，接下來花 2 分鐘跑測試，確認所有功能都正常。龍蝦 OpenClaw Peekaboo 自動化助手安裝教學的流程走到這裡，你離成功只剩最後一步。5-1. 檢查權限狀態在 OpenClaw 對話框中輸入： peekaboo permissions status正確的回傳結果應該是： Screen Recording (Required): Granted Accessibility (Required): Granted兩個都顯示 Granted 就代表權限設定成功。如果任何一個顯示 Not Granted，請回到第 4 步重新檢查。最常見的問題是選錯了程式（選成 Terminal 而不是 openclaw）、沒有重啟 OpenClaw、或路徑不對。5-2. 常用 4 項功能測試確認清單權限通過後，依序測試以下 4 項功能，全部成功就代表你的 macOS AI 自動化環境已經就緒：Peekaboo 功能測試一覽表測試項目在 OpenClaw 輸入的指令預期結果螢幕截圖「請用 peekaboo 幫我截圖」AI 回傳目前螢幕的截圖畫面應用程式列表「請列出目前運行的應用程式」AI 回傳所有開啟中的 App 清單滑鼠控制「請移動滑鼠到螢幕中央」滑鼠游標移動到螢幕正中間文字輸入「請輸入：Peekaboo 測試成功」AI 在目前游標位置自動打出文字如果 4 項全部通過，恭喜，你的 OpenClaw AI 助手現在擁有完整的 Peekaboo macOS 螢幕控制能力了。5-3. Peekaboo 常用指令速查：7 個你最常用到的 CLI 指令測試通過之後，接下來就是實際操作了。你可以在終端機執行 peekaboo --help 查看所有可用指令，不過大部分日常操作只需要用到以下 7 個。這邊直接整理好，複製貼上就能跑。Peekaboo CLI 常用指令一覽表你想做的事正確指令說明截圖peekaboo image擷取目前螢幕畫面，AI 助手可以用來分析畫面內容辨識 UI 元素peekaboo see讓 AI 看懂畫面上的按鈕、選單、文字欄位等互動元素點擊peekaboo click精準點擊指定位置或 UI 元素輸入文字peekaboo type在目前游標位置自動輸入文字內容列出執行中的 Apppeekaboo list查看目前所有開啟的應用程式清單檢查權限狀態peekaboo permissions status確認螢幕錄製和輔助使用權限是否已授權查看所有指令peekaboo --help顯示完整指令清單與使用說明建議先從 peekaboo image 和 peekaboo see 開始練習，這兩個是最基本的「讓 AI 看見畫面」指令。熟悉之後再搭配 peekaboo click 和 peekaboo type，就能組合出完整的自動化流程，例如「截圖 → 辨識按鈕 → 點擊 → 輸入文字」這樣的連續操作。 6. 常見問題 FAQ：Peekaboo 安裝疑難排解 6 問在社群裡蒐集了大家最常遇到的問題，整理成這份 FAQ。如果你在安裝過程中卡住，先來這裡找答案。6-1. 權限與路徑相關問題Q1：設定完權限後還是顯示「Not Granted」怎麼辦？最常見的原因有三個：第一，你勾選的是「終端機（Terminal）」而不是「openclaw」和「node」，請回到系統設定確認勾選正確的程式。第二，你沒有重啟 OpenClaw，權限設定改完之後一定要完全關閉再重新開啟。第三，路徑不對，Apple Silicon Mac（包括 Mac Mini M 系列）的路徑是 /opt/homebrew/bin，Intel Mac 是 /usr/local/bin，確認你選的是對的那個資料夾。Q2：找不到終端機怎麼開？最快的方法是按 Cmd + 空白鍵 叫出 Spotlight，輸入「Terminal」，就會看到「終端機」或「Terminal」的選項，點一下就開了。你也可以到「應用程式」資料夾裡的「工具程式」子資料夾找到它。Q3：安裝過程中出現錯誤訊息怎麼辦？大部分安裝錯誤都是網路問題。先確認你的網路連線正常，然後重新執行同一道安裝指令。如果還是不行，把電腦完全重啟一次再試。如果錯誤訊息提到 Homebrew 相關問題，先執行 brew update 更新 Homebrew 本身，再重新安裝。6-2. 硬體相容性與安全性問題Q4：我的 Mac Mini 是 Intel 版本，能裝嗎？可以。Peekaboo 同時支援 Intel 和 Apple Silicon（M1 / M2 / M3 / M4）架構。唯一的差異是 Homebrew 的安裝路徑不同，Apple Silicon 在 /opt/homebrew/bin，Intel 在 /usr/local/bin。安裝步驟和操作流程完全一樣。Q5：給這麼多權限會不會有安全問題？螢幕錄製權限是讓 AI 助手能「看見」你的畫面，輔助使用權限是讓它能操控滑鼠和鍵盤。這兩個權限是 Peekaboo 運作的必要條件，少一個都不行。至於安全性，OpenClaw 是開源專案，所有程式碼都公開透明，任何人都可以去 GitHub 上審查。比起很多要求相同權限但不開放原始碼的商業軟體，它反而更值得信任。如果還是擔心安全問題，其實沒有人可以保證完全安全，建議你就不要安裝。Q6：裝完之後可以隨時關掉權限嗎？當然可以。任何時候你都能回到「系統設定 → 隱私權與安全性」，取消勾選 openclaw 和 node 就行了。取消之後 Peekaboo 的螢幕控制功能會立即失效，你的 AI 助手會退回到只能文字對話的狀態。想重新啟用的時候，再打勾、重啟 OpenClaw 就好。Peekaboo 安裝常見問題速查表問題類型常見原因解決方法權限顯示 Not Granted勾錯程式 / 沒重啟確認勾選 openclaw 和 node，重啟 OpenClaw找不到終端機不熟悉 macOSCmd + 空白鍵 → 輸入 ter → 點選安裝指令報錯網路不穩 / Homebrew 過舊確認網路 → brew update → 重新安裝Intel Mac 路徑不同架構差異使用 /usr/local/bin 取代 /opt/homebrew/bin安全性疑慮對權限不放心OpenClaw 開源透明，隨時可取消權限 結論：龍蝦 OpenClaw Peekaboo 自動化助手安裝教學完成，下一步做什麼？走到這裡，整套龍蝦 OpenClaw Peekaboo 自動化助手安裝教學就全部完成了。回顧一下你剛才做了什麼：安裝 Peekaboo Skill 讓 AI 助手學會新能力，安裝 CLI 核心工具讓它真正能動手，完成 Peekaboo 設定權限讓 macOS 允許它看見螢幕和操控滑鼠鍵盤，最後跑測試確認一切正常。現在你擁有的不再只是一個聊天機器人，而是一個能看見畫面、精準操作、實現 macOS AI 自動化的超級 OpenClaw AI 助手。你可以馬上試試這些操作：讓它幫你開啟 Safari 搜尋新聞、截圖並分析頁面內容、甚至自動整理桌面上的檔案。不管你是用 Mac Mini 當工作站還是用 MacBook 當主力機，Peekaboo 都能大幅提升你的工作效率。最後提醒：Peekaboo 很強大，但請負責任地使用。用它來自動化重複性工作、提高生產力、輔助學習和創作，不要拿來做自動點擊廣告或其他違反平台規範的事。想了解更多進階玩法，可以到 Peekaboo 官網 查看最新文件，或者加入 OpenClaw 社群跟其他用戶交流。歡迎來到 AI 控制 macOS 的新時代，龍蝦 OpenClaw Peekaboo 自動化助手安裝教學到此結束，祝你玩得開心。參考資料Peekaboo 官方文件 — peekaboo.booApple macOS 隱私權與安全性官方說明Homebrew 官方安裝指南GitHub — OpenClaw 開源專案Apple 開發者文件 — Accessibility API維基百科 — 命令列介面（CLI）