OpenClaw 教學 - 從安裝到設定 調教您的 AI 助理

快速連結 = [ 首頁 ] [ OpenClaw 模型設定教學 ] [ OpenClaw 文件列印教學 ] [ OpenClaw XAMPP 教學 ] =

OpenClaw 是什麼？

OpenClaw 是一個可以在你的電腦上運行的 AI agent 。它的設計理念是讓您透過聊天軟體跟助理互動，並且由你掌控運算環境、金鑰與資料。 OpenClaw 的開發者是 Peter Steinberger ，此專案從原型開始快速成長，在短時間內累積了大量使用者與 GitHub stars，後續也開始建立維護者與貢獻流程。 您正在找 Clawdbot教學？ 也想自已學習養龍蝦？ 快來看看如何使用吧！

OpenClaw 官方網站 [ https://openclaws.io/zh-TW/ ]

OpenClaw 名稱演進

OpenClaw 的命名演進相當精彩，官網提到最初只是 Peter Steinberger 的 WhatsApp Relay 週末專案。

Clawd > 在 2025 年 11 月出現，但 Anthropic 來函要求改名，開發者基於商標與法律考量選擇改名。

Moltbot > 在社群討論中產生；molt（脫殼）象徵龍蝦成長。

OpenClaw > 官方做了商標檢索，最後選擇 OpenClaw 當做品牌名稱。

OpenClaw 能做什麼

從官方 GitHub README 與官方介紹，OpenClaw 的核心價值：

A) 讓您使用的聊天軟體進行操作

OpenClaw 的定位是你的的個人助理，能在 WhatsApp 等多種通道中回覆訊息，讓使用者用聊天方式跟助理互動。

B) "Your assistant. Your machine. Your rules."

OpenClaw 可在自已的電腦或 VPS 運行，你的金鑰與資料都是自已掌控，不需要將資料上傳到 SaaS 供應商的伺服器。

C) Gateway 是控制平面，助理才是產品本體 。

OpenClaw 安裝教學

本教學使用 Mac mini 展示安裝步驟，重點是先讓 OpenClaw 順利跑起來，再進行進一步的設定與增加技能。

實務上強烈建議先安裝 Homebrew 套件管理工具，因為 OpenClaw 在 macOS 上的安裝與運作會依賴多個系統工具，而 Homebrew 是最簡單、最穩定的管理方式，可以讓你用一行指令安裝、更新、移除各種開發工具與軟體，而不用手動下載與設定。

對於 OpenClaw 的 Skills、自動化或進階功能， Node.js 幾乎是必備的，安裝 OpenClaw 時建議一併安裝 Node.js 。

開啟終端機，輸入 curl -fsSL https://openclaw.ai/install.sh | bash 開始安裝。

OpenClaw 安裝成功後，將出現 Onboarding 初始設定畫面，這是 「 安全告知 」 與 「 選擇導引模式 」 訊息。

若是啟用讀檔、跑指令、執行操作，就具備能做很多事的能力，因此有風險，理解風險後是否繼續？

這些資訊安全上的建議 （ 包括白名單、權限設定、不對外網公開 ） 都很重要！

端機互動介面通常是 ↑↓ ： 移動選項 / Space ： 勾選 / Enter ： 確認

OpenClaw 需要搭配模型 （ OpenAI, Anthropic, Google ... ） 才能運行，也可以選擇 Skip for now 先跳過。本教學使用 OpenAI 。

OpenAI API key 可到官方網站申請，通常需要付費，這裡選擇 OpenAI API key 。

取得 OpenAI API key 後複製並在此貼上。 （ 圖片的 API key 僅用於展示，請使用自已的 API key ）

選擇 Default model 預設模型 ，代表 OpenClaw 已經讀取到 OpenAI API key，可以選一個預設要用的模型 。

建議可選 Keep current ，目前 openai / gpt-5.1-codex 模型穩定、相容性好，先讓 OpenClaw 架設流程跑完！

選擇通訊軟體，設定稍後從哪裡收訊息來互動 ，這裡可先選 Skip for now 跳過！

建議可申請一個提供 OpenClaw 的專用帳號，先不使用您的主要帳號做測試 …

使用網頁橋接方式，有時候需要重新登入、被踢下線、可能有停權的風險。

是否現在進行 OpenClaw 的技能（skills） 環境設定？

npm ： 最通用、最保守 （ Node.js 內建 ）

pnpm ： 更省空間、速度常更快，現在很常用 （ 推薦 ） ★

bun ： 很快，但相容性偶爾會遇到問題 （ 新手先不建議 ）

安裝技能，可先選擇 Skip for now 跳過，稍後再進行安裝。 先將設定完成，確認 OpenClaw 正常啟動與通道正常。

您可在稍後需要 Skill 時再來安裝，避免裝一堆用不到的佔空間。 後面也將提供更完整的 OpenClaw skills 教學。

接著是設定各種 Skills 需要的第三方 API key 的選項畫面。雖然剛才選了 Skip 不安裝 …

但系統仍會將「如果要用某些雲端服務型 skills 需要先輸入 API key 列出來，讓你填寫…

設定 GOOGLE_PLACES_API_KEY for goplaces ?

設定 GOOGLE_PLACES_API_KEY for local-places ?

設定 GEMINI_API_KEY for nano-banana-pro ?

設定 GEMINI_API_KEY ?

設定 NOTION_API_KEY for notion ?

設定 ELEVENLABS_API_KEY ?

選擇控制 OpenClaw bot 的方式，建議選擇 TUI 文字操作介面。

完成設定後將出現 Onboarding complete 訊息，

接著在開啟的 OpenClaw TUI 畫面操作，首先要進行角色設定，包括名字與風格，有點像是 RPG 遊戲的創造角色 …

您可以請 OpenClaw 使用繁體中文喔！

讓 OpenClaw 瞭解自已的角色，並將設定寫進檔案，套用到後續您與 OpenClaw 的所有對話。

相關的操作可參閱本站 [ OpenClaw TUI 教學 ]

如果剛才的 How do you want to hatch your bot ? 步驟，選擇 Open the Web UI 的話，網頁瀏覽器會開啟 OpenClaw 管理頁面。

Web UI 操作上與使用 TUI 稍有不同，提供瀏覽網頁般的直覺化操作，不過需要找到工具位置，本教學將以 TUI 操作方式為主。

OpenClaw Telegram 設定教學

使用 TUI / Web UI 都是在電腦前操作，接著介紹 Channels 設定步驟，讓您也能在遠端使用手機控制 OpenClaw 執行任務！

本教學先使用 Telegram 示範，因為設定上比較簡單。

無反應！

請在終端機執行 openclaw gateway restart 重新啟動！

請在終端機執行 openclaw channels add 開始新增操作！

請在終端機執行 pairing list telegram

… 設定完成！

OpenClaw 開始執行任務！

OpenClaw 安裝完成後，可以開始嘗試讓 OpenClaw 做些事了，首先使用 OpenClaw 撰寫程式，例如 ：

[ 請幫我在 Xcode 使用 Swift 寫一個最簡單的 HelloWorld 程式，然後放在桌面上的 HeloWorld 資料夾。 ]

接著 OpenClaw 就開始跑任務了，當然電腦需要先安裝開發工具，例如 Xcode 或 VS Code 之類的。

沒多久就完成了，執行 Hello World 程式！

補充說明 - 隨後請 OpenClaw 幫我撰寫一個拍貼機的程式，大約來回討論 不到 15 分鐘就完成了，除了美術的部份有待加強之外，功能性沒什麼問題，不過沒多久之後發現 OpenClaw 反應變慢，甚至不動了，才發現請 OpenClaw 撰寫程式用掉我在 OpenAI 預付的 Token 額度，因此想養 AI 龍蝦的話，也要考慮 Token 的問題，後面也會提供使用本地端模型的教學。

OpenClaw Skills 教學

您可以使用 openclaw skills 查詢技能（截圖有經過修改，僅供參考）。

OpenClaw 常用技能介紹

Brave Search

Brave Search 是由 Brave Software 開發的隱私導向搜尋引擎，採用自建的獨立搜尋索引，能直接從網路收錄與整理內容，而不依賴其他 Search Engine 的搜尋結果。它整合 AI 技術可在搜尋頁面上提供摘要式答案與相關來源，讓使用者快速理解問題與取得資訊。同時 Brave Search 強調隱私保護，不會建立個人搜尋檔案或追蹤使用者行為，確保搜尋過程保持匿名與安全。

Brave Search 能讓使用者快速查詢網站、影片、文件與各類網路資源，並透過 AI 提供整理後的答案與重點摘要，減少逐一開啟網站的時間。它也能作為 AI 應用或自動化系統的搜尋資料來源，提供可靠且可引用的網路資訊。此外，由於 Brave Search 採用獨立索引與透明的結果機制，開發者可將其 API 整合至 AI agent 或 Skills 系統，使應用程式能自動搜尋資料、取得最新內容，並支援資料擷取等功能。

Gog

本站 [ Google Workspace CLI 教學 ]

Gog 是 OpenClaw Skills 中用於整合 Google 服務的功能模組，讓 AI agent 能透過 Google 提供的官方 API 存取使用者授權的雲端資料與服務，例如 Google Drive、Gmail、Google Calendar 等。它透過 Google 的安全授權機制，使 OpenClaw 能與 Google 生態系互動，並將 Google 的資料與功能轉換為可由 AI 理解與操作的資源，讓 OpenClaw 不只是對話工具，而能直接連結雲端工作環境與文件系統。

透過 Gog，OpenClaw 可以搜尋與讀取 Google Drive 中的檔案內容、檢查或建立 Google Calendar 行程，或存取 Gmail 郵件資訊，使 AI 能根據雲端資料提供更準確的回應與自動化操作。例如使用者可以透過訊息要求 AI 查詢文件、整理資料或協助管理行程，而 OpenClaw 會透過 Gog 與 Google API 取得資料並完成任務。這使 OpenClaw 成為可實際操作雲端資源的 AI agent，而不只是單純提供建議的對話系統。

注意！ 建議不要連結您的主要帳號，可再申請一個新帳號使用。 網路上好像有看到因此被停權的報導。

Nano banana pro

Nano banana pro 是 OpenClaw Skills 中用於生成與編輯影像的 AI 技能，整合 Nano Banana Pro 影像模型，使 AI agent 能透過文字或圖片指令建立全新的視覺內容，或修改既有影像。該模型具備高階影像理解與生成能力，可透過自然語言完成圖像創作與編輯，並支援高解析度輸出與精準文字呈現，讓使用者能以對話方式直接產生專業品質的圖片與圖解。

透過 Nano banana pro 技能，OpenClaw 可以根據使用者指令生成插圖、海報、教學圖解或產品視覺，也能修改現有圖片內容，例如調整場景、加入物件或改變風格。它具備理解內容與邏輯的能力，可將文字資料轉換為資訊圖表或視覺說明，使 AI 能協助製作教材、簡報素材或設計草圖。這讓 OpenClaw 不僅能處理文字資訊，也能直接建立與編輯影像，成為具備完整多媒體創作能力的 AI agent。

ImageMagick

ImageMagick 是一套開源的影像處理工具與函式庫，可用於建立、編輯、轉換與分析多種格式的圖片，包括 PNG、JPEG、GIF、TIFF 等。它提供完整的影像處理功能，例如裁切、縮放、旋轉、合成與格式轉換，並可透過指令或程式呼叫方式自動執行。OpenClaw 的 ImageMagick 技能即是利用這套工具，使 AI agent 能透過指令直接控制影像處理流程，將影像操作轉化為可自動化執行的任務。

透過 ImageMagick 技能，OpenClaw 可以自動裁切圖片邊緣、調整尺寸、轉換格式或加入浮水印，並可批次處理資料夾中的多個影像檔案。例如當有新圖片加入指定位置時，AI 可立即進行裁切與最佳化，或轉換為特定格式供後續使用。這讓 OpenClaw 能協助完成原本需要人工操作的影像處理工作，使影像整理與轉換流程實現自動化，特別適合用於設計、文件處理與內容製作等應用情境。

例如 科勁數位編輯部 經常需要製作教學，使用 ImageMagick 批次裁切圖片，快速處理資料夾的圖檔已經節省了大量時間！

Obsidian

Obsidian 是一套以本機 Markdown 檔案為基礎的知識管理工具，讓使用者能以純文字方式建立筆記並透過雙向連結將內容彼此關聯，形成可視化的知識網路。根據官方說明，Obsidian 將資料儲存在使用者自己的裝置中，而非強制依賴雲端服務，使資料具備高度可控性與長期可存取性。OpenClaw 的 Obsidian 技能即是利用這種開放的檔案結構，使 AI 能讀取與管理筆記內容，並將知識庫納入可查詢與使用的資訊來源。

透過 Obsidian 技能，OpenClaw 可以搜尋筆記內容、讀取特定文件，或將新資訊寫入為 Markdown 筆記，使 AI 能協助整理知識與建立文件。例如使用者可要求 AI 查詢某個主題的筆記摘要，或將對話結果儲存為新的知識條目。由於 Obsidian 採用標準 Markdown 檔案格式，OpenClaw 能直接操作這些檔案，使筆記系統成為可持續累積並可被 AI 使用的本地知識庫，提升資料管理與知識整理效率。

Trello

Trello 是由 Atlassian 提供的專案管理工具，採用看板 ( Kanban ) 方式將工作組織為看板 ( Board ) 、清單 ( List ) 與卡片 ( Card ) ，讓使用者能以視覺化方式追蹤任務進度與協作內容。根據官方說明，Trello 支援透過 API 與外部應用程式整合，使系統能讀取與管理專案資料。OpenClaw 的 Trello 技能即是利用 Trello 官方 API，使 AI agent 能存取與操作專案資訊，將任務管理功能整合至自動化工作流程中。

OpenClaw 可以透過 Trello 技能讀取看板內容、建立新卡片、更新任務狀態或查詢專案進度，使 AI 能協助管理工作流程。例如使用者可透過對話要求建立任務、整理待辦事項或查詢目前專案狀態，而 OpenClaw 會將指令轉換為 Trello 操作並更新資料。這讓 OpenClaw 不僅能提供建議，也能直接參與專案管理流程，使 AI 成為能實際執行任務與協助團隊協作的智慧助理。

voice-call

voice-call 讓 OpenClaw 能透過語音通訊服務與使用者進行即時通話，將語音辨識（Speech-to-Text）與語音合成（Text-to-Speech）技術整合至 AI agent 中，使系統能以自然語音方式接收指令並回應內容。此技能通常建立在標準語音通訊與 VoIP 技術基礎上，使 OpenClaw 不僅能處理文字訊息，也能直接透過語音進行互動，讓 AI 從文字助理提升為可進行語音對話的智慧代理。

OpenClaw 可以透過 voice-call 技能接聽或發起語音通話，將使用者說出的內容轉換為文字進行理解與處理，再以語音方式回覆結果。例如使用者可透過電話詢問資訊、執行查詢或控制系統，而 OpenClaw 能即時回應並執行對應任務。這使 OpenClaw 能應用於客服系統、智慧助理或遠端控制情境，讓使用者即使不使用鍵盤或螢幕，也能透過語音與 AI 完成互動與操作。

openhue

openhue 用於串接 Philips Hue 智慧燈生態，核心概念是以 OpenHue 提供的規格與工具，讓開發者用一致性的方式呼叫 Hue 的 REST API 來控制燈具與橋接器。OpenHue 特別提供 Hue（CLIP）API 的 OpenAPI 規格，方便在自動化或 agent 系統中做穩定整合。

透過 openhue 技能，OpenClaw 可在取得授權後讀取 Hue 裝置狀態並下達控制指令，例如切換燈光開關、調整亮度與色溫/色彩、設定情境與群組控制等，並把「燈光事件」納入自動化流程（例如依時間、行程或訊息觸發燈光變化）。這些能力建立在 Philips Hue 官方提供的 API 能力之上，並可透過 OpenHue 的規格化介面更容易被 AI agent 使用。

Copyright © 2026 CG Digital Corp. All rights reserved.