MAR 12, 202612 分鐘閱讀openclaw

🦞 OpenClaw 完整安裝指南：打造你的私人 AI 助手

從零開始安裝 OpenClaw，讓你的 AI 助手住進 Telegram、WhatsApp 等通訊軟體。一行指令搞定安裝，手把手教你準備 Homebrew、OpenRouter API Key 和 Brave Search API Key。

openclaw

OpenClaw 是什麼？

openclaw.jpeg

OpenClaw 是一個開源、自架的 AI 助手框架，讓你在自己的電腦上跑一個 AI Gateway，然後透過你已經在用的通訊軟體（Telegram、WhatsApp、Discord、Slack、Signal、iMessage 等）跟 AI 對話。

一句話解釋：把 AI 的大腦，裝進你的電腦上，然後可以透過 Telegram / WhatsApp / Discord 來下指令。

跟直接用 ChatGPT / Claude / Gemini 有什麼差別？

  • ChatGPT / Claude / Gemini：開網頁或 App 才能用，要額外設定才能操作你的電腦。
  • OpenClaw：跑在你的電腦上，24/7 待命，可以讀你的檔案、跑指令、記住你是誰，而且透過你日常用的通訊軟體回覆你

簡單來說，ChatGPT 是「你去找 AI」，OpenClaw 是「AI 住在你的通訊軟體裡」。

核心架構

OpenClaw 的運作邏輯其實很直覺：

plaintext
你的訊息（Telegram / WhatsApp / Discord）
        ↓
   Gateway（控制中心）
        ↓
   AI 大腦（LLM）
        ↓
   工具 & 技能（Shell、瀏覽器、檔案管理）
        ↓
   回覆你

Gateway 是整個系統的核心，它負責接收訊息、分配給 AI、管理工具權限、然後把回覆送回給你。預設跑在 127.0.0.1:18789。

一、OpenClaw 可以做什麼？

  • 透過通訊軟體跟 AI 對話（支援 50+ 個平台）
  • 讀寫你電腦上的檔案
  • 執行終端機指令
  • 自動化瀏覽器操作
  • 排程任務（Cron）
  • 語音對話（macOS / iOS / Android）
  • 多 Agent 路由（不同聊天室用不同 AI 人格）
⚠️ 重要提醒：OpenClaw 可以存取你的本地檔案和終端機，權限很大。請把它當作密碼庫一樣保護，安裝時務必注意安全設定。

二、安裝前準備

在正式安裝 OpenClaw 之前，建議先準備好以下三樣東西。

1. 安裝 Homebrew（macOS 使用者）

homebrew

什麼是 Homebrew？ Homebrew 是 macOS 上最常用的套件管理工具，可以用一行指令安裝各種開發者工具。OpenClaw 的安裝腳本需要 Node.js 22+，Homebrew 可以幫你輕鬆搞定。

如果你還沒裝過 Homebrew，打開終端機（Terminal）輸入：

shell
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝完成後，確認一下：

shell
brew --version

看到版本號就代表安裝成功。

brew_version
💡 如果你已經裝過 Homebrew，可以跳過這步。

2. 準備 OpenRouter API Key

如果你想用ChatGPT的訂閱計劃可以直接跳過這一步

先說一下，什麼是 API Key？ 如果你沒接觸過，可以把 API Key 想像成一組「通行證密碼」。當你的程式想要使用別人的服務（例如讓 AI 幫你回答問題），就需要出示這組密碼來證明「我是付費用戶、我有權使用」。它就是一串文字（例如 sk-or-v1-xxxxxxxxxxxx），誰有這串字就能代表你花錢用服務，所以一定要像密碼一樣保管好，絕對不要公開分享。

什麼是 OpenRouter？ OpenRouter 是一個 AI 模型聚合平台，讓你用一個 API Key 就能存取多種 AI 模型（Claude、GPT、DeepSeek、Gemini 等）。不用分別去 Anthropic 和 OpenAI 各申請一個帳號，非常方便。

取得方式：

前往 openrouter.ai 並註冊帳號

登入後，進入 Settings -> API Keys 頁面

open-router-settings.

點擊 Create Key，取一個好記的名稱（例如 openclaw），你可以為這條API Key設定使用的Credit Limit 和 使用期限，但這裡因為長期使用，所以放空就可以了。

create-new-key

複製生成的 API Key（格式像 sk-or-v1-xxxxxxxxxxxx）

** 我這條API Key只用作Screen cap，已經disable，不是真正在用的，沒有風險 **

new-key
⚠️ API Key 只會顯示一次，而且只要別人知道了你的API Key的話，就能直接使用，請務必複製並妥善保存。建議存到密碼管理工具裡。
open-router-credit

最後儲值一些額度（建議先充 $5-10 美金試用）

🇭🇰 香港用戶的話不用擔心，Openrouter沒有任何限制，可以使用本地機構發行的信用卡也沒有問顯

💡 為什麼推薦 OpenRouter 而不是直接用 OpenAI / Anthropic / Gemini 的API？因為 OpenRouter 讓你可以隨時切換不同模型（Claude、GPT、Grok 等），不用綁定在一個平台

3. 準備 Brave Search API Key

什麼是 Brave Search API？ OpenClaw 的 AI 助手可以幫你搜尋網路資訊，但它需要一個搜尋引擎的 API Key 才能使用 web_search 功能（web_fetch 抓取網頁不需要 Key，但搜尋需要）。

取得方式：

brave-api.png
  1. 前往 brave.com/search/api 並註冊帳號
  2. 進入 API 管理頁面
  3. 選擇 Free 方案（每月 2,000 次免費查詢，個人使用很夠）
  4. 建立一個 API Key
  5. 複製並保存
💡 Brave Search 的免費方案對個人使用來說綽綽有餘。如果你暫時不需要搜尋功能，這步可以之後再做，不影響基本使用。安裝完成後可以用 openclaw configure --section web 補設。

準備清單

在開始安裝之前，確認你手邊有：

  • ✅ Homebrew 已安裝（macOS）
  • ✅ OpenRouter API Key（sk-or-v1-xxxxxxxxxxxx）
  • ✅ Brave Search API Key

三、安裝 OpenClaw

準備好之後，安裝本身非常簡單，一行指令搞定。

一鍵安裝（推薦）

打開終端機，輸入：

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

這個安裝腳本會自動幫你：

  1. 偵測你的系統環境
  2. 檢查 Node.js 版本（需要 22+），如果沒有會自動安裝
  3. 透過 npm 全域安裝 OpenClaw
  4. 啟動設定精靈（Onboarding Wizard）

之後基本上都是非常簡單明瞭，就是順著它的整個流程去做選擇就可以了

start-install.png

我們先等它把基本的東西跑完，然後就會出現一個安全性的警告。

onboarding-security-warning.png

選擇Yes，然後按下Enter，Onboarding mode 選擇 QuickStart

onboarding-mode.png

之後的Model Provider我們選擇OpenRouter

如果想要使用ChatGPT的訂閱計劃可以自行選擇OpenAI，也是只要按指示跟著做就可以
select-model-provider.png

然後選擇 Paste API now，再貼上我們之前已經預先準備好的API Key（sk-or-v1-xxxxxxxxxxxx）

enter-api-key.png

之後需要選擇default的LLM model，這裡可以按照自己的需求來選擇，我在這裡選擇了 openrouter/anthropic/claude-sonnet-4.6

select-default-model.png
🇭🇰 香港用戶注意，Openrouter註冊和付款充值都不用VPN，但最新的情況是即使透過Openrouter去調用御三家的模型還是需要VPN，簡單而言，如果使用ChatGPT，Claude，Gemini還是要VPN，其他模型不用，所以如果唔想開VPN，想快速完成setup的話，可以先選擇DeepSeek，之後再換成其他模型也OK

然後是選擇和OpenClaw溝通的通訊程式，這裡最方便的是Telegram

select-channel.png
又是🇭🇰 香港用戶注意 😅，我發現香港的電話號碼會經常收不到Telegram發出來的SMS，導致無法重新登入或是登記新帳號，這裡可能只有選擇先跳過了。不用擔心，完成設置後，還是可以在電腦上和Openclaw對話的，只是remote的通道之後另外再設置WhatsApp或是discord之類，這不在本篇教學文章的範圍內。

這裡我們首先要取得Telegram的Bot Token，打開Telegram 搜尋 BotFather

找到之後點進去，輸入 /newbot

botfather-search.PNG
newbot.png

BotFather 會先要求你輸入 bot 的顯示名稱（Display Name），這個可以隨便改，例如「My AI Assistant」。接著會要求你設定 username，這個才有命名限制：必須以 _bot 或 Bot 結尾（例如 my_ai_assistant_bot），而且不能跟其他 bot 重複。

botfather-bot-created.png

成功之後它就會給你這個bot的連結和Token，把Token取出來複製，然後貼回去Openclaw的安裝Terminal 流程

⚠️ Bot Token 跟 API Key 一樣敏感，任何人拿到你的 Bot Token 就可以完全控制你的 bot（讀取訊息、發送訊息、修改設定）。如果不小心洩漏了，立即到 @BotFather 輸入 /revoke 重新生成一個新的 Token，舊的會即時失效。

接下來到設置Web Search，我們選擇Brave Search，然後貼上我們之前準備好的Brave Search API Key

web-search.pngweb-search-brave-config.png

接下來會跳出一整個skills的列表去讓我們選擇安裝，這裡建議大家自己上網搜尋了解每個skill的作用 （這裡跳過了，之後還是可以隨時再安裝的）

install-skill-dependencies.png

我在這裡就只隨便選了兩個就直接過了

selected-skill.png

然後還有一堆API Key，全部選NO（如果你本身有使用這些服務，已經有API Key了，可以自行判斷要不要加入去，這篇教學是新手導向，因此先跳過 ）

skill-api-keys-setup.png

下一步是設置Hooks，在軟體開發中，「Hook」（鉤子） 的意思就是：「當某個事件發生時，自動觸發另一個動作」。

如果你是第一次使用，建議勾選：

✅ session-memory：對體驗 AI 很有幫助。

✅ command-logger：如果你想記錄自己的操作過程。

hooks-config-selected.png

其他兩個（boot-md 和 bootstrap-extra-files）如果你目前沒有特定的設定檔要載入，可以先不選，以後需要時再手動配置。

接下來讓它跑一會，會再要你選擇 How do you want to hatch your bot？ 這裡選擇Web UI

gateway-token-hatch-bot.png

繼續讓它跑，直至它顯示 Onboarding complete. Dashboard opened; keep that tab to control OpenClaw.

onboarding-complete-summary.png

然後它會自動打開browser，127.0.0.1:18789/chat 你應該會看到以下畫面

dashboard-chat-empty.png

和龍蝦Say個Hello吧

dashboard-chat-hello.png

恭喜 🎉 來到這一步，電腦的設置基本上都已經完成，就只差和 Telegram 進行配對。

不過在配對之前，可以先在原本進行安裝的Terminal 輸入

shell
source ~/.zshrc

然後再輸入

shell
openclaw --version

看到版本號就代表指令也沒有問題了。

四、配對Telegram

我們先回到Telegram，點擊剛剛BotFather給你Bot Token的那條連結，這將會是你和Openclaw進行對話的地方。

點擊Start，然後它會給你，你的user id 和 pairing code，把它們都記下來。

telegram-bot-empty.PNG
telegram-bot-pairing-code.png

再回到Terminal，輸入

shell
openclaw pairing approve telegram {你的pairing code}
cli-pairing-approve-telegram.png

接下來再回到Telegram，和龍蝦打招呼吧。

telegram-bot-paired-hello.PNG

恭喜你終於完成了🥳，現在已經可以在Telegram和Openclaw瘋狂對話了！

五、重要檔案與目錄

安裝完成後，OpenClaw 的設定和資料都放在 ~/.openclaw/ 目錄下：

路徑用途
~/.openclaw/openclaw.json主要設定檔（API Keys、頻道設定等）
~/.openclaw/agents/Agent 設定和 session 資料
~/.openclaw/logs/Gateway 日誌
~/.openclaw/workspace/工作區（AGENTS.md、SOUL.md、TOOLS.md）
⚠️ ~/.openclaw/ 目錄包含你的 API Keys 等敏感資料，務必確保權限設為 700（只有你自己可以存取）

六、常用指令速查

指令用途
openclaw start啟動 Gateway（前景）
openclaw start --daemon啟動 Gateway（背景）
openclaw gateway status查看 Gateway 狀態
openclaw gateway restart重啟 Gateway
openclaw health健康檢查
openclaw doctor診斷與修復
openclaw doctor --fix自動修復偵測到的問題
openclaw security audit安全審計（檢查設定是否有風險）
openclaw models list列出可用的 AI 模型
openclaw configure重新設定
openclaw configure --section web設定網路搜尋（Brave Search）
openclaw update更新到最新版
openclaw dashboard開啟 Web 控制台
openclaw daemon install安裝為系統背景服務（開機自啟）
openclaw daemon status查看背景服務狀態
openclaw daemon stop停止背景服務
openclaw daemon uninstall移除背景服務
openclaw --version查看版本

七、安全注意事項

OpenClaw 可以存取你的檔案和終端機，權限很大，安全問題不能馬虎：

  1. 權限保護：確保 ~/.openclaw/ 目錄權限為 700，在 terminal 輸入指令 chmod 700 ~/.openclaw。
  2. API Key 管理：建議為 OpenClaw 專門建立一個 API Key，設定每日花費上限（$5-10）
  3. Bot Token 保護：Telegram Bot Token 跟 API Key 同等敏感。不要在任何公開地方貼出 Token（包括 GitHub repo 和截圖），如果洩漏了，立即到 @BotFather 輸入 /revoke 重新生成
  4. Skills 審查：ClawHub 上的第三方 Skills 可能有安全風險。安裝前務必檢查它要求的權限，如果一個「天氣查詢」的 Skill 要求 shell 執行權限，那絕對有問題
  5. 頻道白名單：在設定中只允許你自己的 Telegram ID 可以跟 Bot 對話（見下方 Telegram 安全設定）
  6. 定期更新：openclaw update 保持最新版，官方會修補安全漏洞
  7. 執行安全審計：定期跑 openclaw doctor 和 openclaw security audit 檢查設定是否安全
⚠️ 曾有安全研究員發現第三方惡意 Skills 在 ClawHub 上進行資料竊取。務必只安裝信任來源的 Skills。

八、讓 Gateway 24/7 長期運行

如果你只是用 openclaw start 啟動 Gateway，一旦關閉 Terminal 視窗或電腦進入睡眠，Gateway 就會停止。要讓 OpenClaw 真正 24/7 待命，你需要把它安裝為系統背景服務。

安裝為背景服務（Daemon）

shell
openclaw daemon install

這個指令會根據你的作業系統自動設定：

  • macOS：建立 LaunchAgent（~/Library/LaunchAgents/com.openclaw.gateway.plist）
  • Linux：建立 systemd user service

安裝完成後，Gateway 會：

  • 在背景持續運行，關閉 Terminal 也不會停
  • 開機時自動啟動
  • 如果 crash 了會自動重啟

管理背景服務

shell
# 查看服務狀態
openclaw daemon status

# 手動啟動
openclaw daemon start

# 重啟（改完設定後用）
openclaw daemon restart

# 停止服務（暫時關閉，下次開機還會自動啟動）
openclaw daemon stop

完全關閉 24/7 運行

如果你想完全停止 OpenClaw 的背景服務，不再開機自啟：

shell
# 停止服務並移除開機自啟
openclaw daemon uninstall

移除之後，Gateway 就不會再自動啟動了。如果之後想恢復，重新執行 openclaw daemon install 即可。

💡 如果你需要更高的可靠性（例如跑在 VPS 上），可以考慮用 Docker 部署 OpenClaw，容器化可以提供更好的隔離性和管理彈性。

九、常見問題 FAQ

Q：OpenClaw 是免費的嗎？ A：OpenClaw 本身免費開源（MIT 授權），但你需要自備 AI 模型的 API Key，API 呼叫是要付費的。

Q：Gateway 一定要一直開著嗎？ A：如果你想隨時透過通訊軟體跟 AI 對話，Gateway 就需要持續運行。建議用 openclaw daemon install 設定開機自動啟動（見第八節）。

Q：可以同時連接多個通訊平台嗎？ A：可以，OpenClaw 支援同時連接 50+ 個平台。你可以在 Telegram 和 Discord 都跟同一個 AI 助手對話。

Q：手機可以用嗎？ A：OpenClaw 有 iOS 和 Android 的 companion app。但更常見的用法是在電腦上跑 Gateway，然後透過 Telegram 等通訊軟體從手機存取。

Q：安全嗎？ A：OpenClaw 提供了安全工具和設定選項（sandbox 模式、DM allowlist、安全審計指令等），但預設配置偏向方便而非安全——出廠狀態下，它可以執行任何 shell 指令、存取你的檔案系統，沒有 command allowlist。這代表你需要主動設定安全措施（參考第七節），而不是裝完就算。特別要注意第三方 Skills 的安全性，建議用 Docker 部署增加隔離性。

十、實用資源

作者：

Eric Lam