OpenClaw 是什麼：如何安裝並連接 Telegram

去年冬天，OpenClaw 出現在我的動態消息中。那時專案在一週內改了兩次名字，並在 GitHub 上累積了數十萬顆星星。從那之後，搜尋「openclaw installation」和「openclaw telegram」的人越來越多。

以下我會依照官方文件，逐一介紹這個工具是什麼、它和 Claude Code 有什麼不同、如何在 Windows、macOS 或 Linux 上安裝、如何選擇模型，以及如何連接 Telegram 機器人。我也會另外談談安全性，因為 OpenClaw 曾牽涉幾起受到高度關注的事件。

請參閱 Ailoot 文件，了解如何使用這項服務。

用淺白的語言來說，OpenClaw 是什麼？#

OpenClaw 將 AI 模型連接到你的 Telegram 機器人。設定相關工具與權限後，它可以摘要訊息或安排提醒。閘道程序及本機設定在你的電腦或伺服器上執行，但這不代表所有對話都在本機處理：選擇雲端模型時，請求及相關對話上下文會傳送給該供應商。若透過 Ailoot 連接，請求會經過 Ailoot 送到所選模型供應商。本機推論需要使用本機模型，且不啟用雲端備援；Telegram 訊息仍會經過 Telegram，啟用的工具也可能連接其他服務。

這個專案由 OpenClaw 開源社群開發。GitHub 儲存庫建立於 2025 年 11 月 24 日，截至 2026 年 8 月 22 日，已有 38.7 萬顆星星和 8.1 萬個分支，是當年成長最快的開放專案之一。它使用 TypeScript。

這個專案的命名歷程滿有趣，值得了解，免得被舊文章搞糊塗。它最初叫 Warelay，是 WhatsApp 閘道。接著改名為 Clawdbot。2026 年 1 月，Anthropic 以商標為由要求更名，於是這個專案有幾天叫 Moltbot。2026 年 1 月 30 日，它終於有了最後的名字：OpenClaw。所以如果你看到「Clawdbot」或「Moltbot」的使用說明，那是同一個專案，只是文章寫在改名之前。

專案的吉祥物是龍蝦 Molty，而「蛻殼」（換殼）也成了每次改名的官方比喻。

OpenClaw 和 Claude Code、Hermes Agent 有什麼不同？#

我常被問到這個差異，因為從外表看，它們全都是「AI 代理程式」。以下是比較表：

如何看這張表？我用 Claude Code 開發，因為需要強大模型並處理程式碼時，它最擅長。OpenClaw 和 Hermes 則適合其他用途：全天候執行、待在 Telegram、記得昨天的對話，並按照排程完成工作的代理程式。OpenClaw 和 Hermes 之間的選擇更細微；這裡有一篇介紹安裝與設定的 Hermes 指南。

如果你只是在挑選工具，可以先看總覽：2026 年大家用什麼寫程式，以及哪些工作適合交給 AI 代理程式。我也另外寫了一篇文章，介紹如何安裝 Claude Code。

安裝 OpenClaw 前需要準備什麼？#

先確認 Node 版本——這是唯一嚴格的必要條件：

node --version

支援 22.22.3 以上、24.15 以上和 25.9 以上版本；建議使用 Node 26。如果指令回覆「command not found」或版本太舊，不用擔心：官方安裝程式會替你下載新版 Node，因此不必手動安裝任何東西。

剩下的問題就是模型。OpenClaw 不會自己思考：它會呼叫你選擇的模型。費用方面有兩種選擇：使用 Anthropic、OpenAI 或 Google 的金鑰，依實際使用量向供應商付費；或透過 Ollama 使用本機模型，不必花錢，但對硬體要求較高。下文會分別介紹這兩種選項。

如何在 macOS 和 Linux 上安裝 OpenClaw？#

建議使用官方安裝程式：

1. 執行安裝程式

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

   腳本會偵測你的作業系統、檢查 Node（必要時會安裝）、安裝 OpenClaw，然後開啟設定精靈。如果你想先看看內容再執行精靈，請加上這個旗標：bash -s -- --no-onboard。

2. 確認安裝完成

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   第一個指令會顯示版本，第二個會檢查設定，第三個會確認閘道正在執行並監聽連接埠 18789。

如果你使用 npm，並想自行管理安裝：

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

這裡有個近期常見的問題，文件中另有一章說明。npm 12 預設會封鎖套件安裝指令碼；如果沒有--allow-scripts=openclaw旗標，安裝會因 allowScripts 訊息而停止。npm 11.15 及更早版本尚無此限制，因此不需要這個旗標。使用npm --version檢查版本。

第二個指令中的--install-daemon旗標會設定自動啟動：macOS 使用 LaunchAgent，Linux 使用 systemd 服務。它依服務管理器條件在重啟或登入後啟動，不會防止睡眠，也不讓關機電腦繼續執行。Telegram 回覆需主機喚醒且上網；筆電睡眠或關機時要回覆，應用常駐伺服器。

如何在 Windows 上安裝 OpenClaw？#

第一種方式適合偏好視窗操作而非終端機的人。Windows Hub 是適用於 Windows 10（20H2 以上）和 Windows 11 的原生 OpenClaw 應用程式，目前仍為 Beta 版。前往 Windows Hub 發行頁面，下載適用於你處理器的安裝程式：一般電腦使用OpenClawCompanion-Setup-x64.exe，ARM 則使用arm64。安裝後，開始功能表會出現 OpenClaw Companion，並提供系統匣圖示、聊天視窗和設定。

第一次啟動時，應用程式會顯示「Set up locally」；請選擇它。應用程式會建立名為 OpenClawGateway 的專用 WSL 環境，在其中安裝閘道並連接到它。如果你已安裝 Ubuntu，它不會動到現有安裝。

第二種方式是使用 PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw gateway install

第一行會安裝 OpenClaw；第二行會透過 Windows 工作排程器註冊自動啟動。如果電腦的原則禁止建立工作，OpenClaw 會自行改用替代方式：在啟動資料夾建立捷徑，讓閘道在你登入時啟動。

第三種方式是 WSL2，文件稱它是在 Windows 上相容性最高的執行環境。安裝 Ubuntu、啟用 systemd，接著依照前一節的 Linux 指示操作：

wsl --install -d Ubuntu-24.04

在 WSL 中，於/etc/wsl.conf的[boot]區段啟用 systemd（也就是systemd=true這一行），接著在 PowerShell 執行wsl --shutdown以重新啟動 WSL，然後使用 Linux 指令安裝 OpenClaw。如果你不懂「發行版」和「systemd」是什麼，就用 Windows Hub；它會替你完成這些步驟。

如何選擇模型並完成初始設定？#

模型是助理的引擎。設定精靈會列出供應商，以下是三個實用選項：

Anthropic 有個方便的細節：如果你的電腦已安裝 Claude Code，且已登入，OpenClaw 就能使用該登入狀態。先在電腦上執行claude auth login，接著告訴 OpenClaw 使用它：

openclaw models auth login --provider anthropic --method cli --set-default

如果閘道以背景服務執行（使用--install-daemon時就是如此），服務必須能取得金鑰。請將金鑰放進~/.openclaw/.env——設定精靈會替你處理，不需要手動編輯檔案。任何變更後，重新啟動並檢查：

openclaw gateway restart
openclaw models status

如果付費不方便，可以使用 Ollama 一節介紹的本機模型。

如何將 OpenClaw 連接到 Telegram？#

Telegram 是最快能連接的頻道：你只需要機器人權杖，不必驗證商業帳號。文件稱這是用手機開始傳訊息給助理最簡單的方法。以下是完整流程：

1. 使用 BotFather 建立機器人

   在 Telegram 開啟與 @BotFather 的聊天（確認使用的就是這個確切帳號名稱，因為有許多冒牌帳號），傳送/newbot，然後選擇名稱和以 bot 結尾的使用者名稱。你會收到類似123456789:ABCdef...的權杖——這是機器人的金鑰，請像密碼一樣保管。

2. 在 OpenClaw 中輸入權杖

   最簡單的方式是使用設定精靈：執行openclaw configure並選擇 Telegram 頻道。另一種手動方式是設定channels.telegram.botToken，或使用TELEGRAM_BOT_TOKEN環境變數。文件特別指出，openclaw channels login telegram指令並不存在；Telegram 只能透過權杖連接。

3. 啟動閘道並傳訊息給機器人

   openclaw gateway
   

   在 Telegram 開啟你的機器人並傳送一則訊息。它會回覆一組 8 個字元的配對碼。這是保護措施：核准寄件者之前，訊息不會被處理。

4. 核准自己

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   配對碼有效時間為 1 小時，所以別等太久。第一個獲得核准的寄件者會自動成為特權指令的擁有者。

有兩個常見的棘手問題。

第一個是群組。OpenClaw 預設會封鎖所有群組：你必須在channels.telegram.groups設定中明確允許機器人，並在群組中維持requireMention: true模式。這樣只有在有人以使用者名稱呼叫它時，它才會回覆，不會插話加入一般對話。Telegram 也有自己的機器人隱私模式：在群組中，機器人預設只能看到指令。透過 @BotFather 使用/setprivacy關閉此模式。變更後必須先將機器人從群組移除再加回，否則 Telegram 不會套用設定。

第二個問題是不要向所有人開放存取。設定中有一種dmPolicy: "open"模式，會在存取清單中使用星號：任何找到機器人使用者名稱的人都能下指令。對個人助理來說，這等於直接把電腦的控制權交給別人。請保持啟用配對碼，或將你的數字 ID 填入allowFrom。

如何透過 Ollama 使用本機模型執行 OpenClaw？#

選擇沒有雲端備援的純本機路徑時，模型推論會留在你的硬體上，不需付費模型端點。但這不代表整個 Telegram 工作流程都在本機：訊息仍經過 Telegram，啟用的線上工具也可能將資料傳到其他服務。

1. 安裝 Ollama

   從 ollama.com/download 下載安裝程式；macOS、Windows 和 Linux 都有對應版本。

2. 下載模型

   ollama pull gemma4
   

3. 將 Ollama 連接到 OpenClaw

   openclaw onboard
   

   選擇 Ollama 供應商和模式：Local only（僅使用自己的模型）、Cloud only（僅使用 ollama.com 的模型），或 Cloud + Local。設定精靈會找到本機伺服器並顯示已安裝的模型。

4. 檢查

   openclaw models list --provider ollama
   

以下是坦白的限制，不然這一節聽起來就像廣告。OpenClaw 文件直接指出，使用本機模型進行流暢的代理工作，需要相當於兩台滿配 Mac Studio 的硬體；而 24 GB 顯示卡只能處理輕量請求，且會有延遲。小型且高度壓縮的模型會截斷上下文，也比較難抵禦隱藏在別人文字中的惡意指令。簡單來說，效能不錯的筆電上的本機模型，足以「試用並了解它是怎麼回事」，但如果日常工作需要助理使用工具，雲端模型仍可靠得多。

文件還針對想組建 WSL2 + Ollama + NVIDIA GPU 環境的人提出另一項警告：官方 Linux Ollama 安裝程式會設定自動啟動，重啟原則為「always」；在使用 GPU 的 WSL2 上，這可能讓電腦陷入重新啟動迴圈。解法是停用服務的自動啟動。如果你遇到此問題，請參閱文件中 Ollama 頁面的疑難排解一節。

執行 OpenClaw 安全嗎？#

先說最重要、但不是每個人都理解的一點。OpenClaw 能存取你的電腦：檔案、指令和瀏覽器。文件說得很清楚：這個專案是為一位受信任的使用者設計的，你不該讓外人存取你的機器人。如果有人能傳訊息給你的代理程式，他就能利用它在你的電腦上執行操作。

最低限度的實務做法：

1. 保持啟用配對碼，或使用存取清單——如何設定已在 Telegram 一節說明。
2. 非必要時，不要從外部公開閘道。預設情況下，它只會在你的電腦上監聽；維持這樣即可。
3. 每次變更設定後，都執行內建檢查：

openclaw security audit

它會檢查是否開放存取、工具權限是否過於寬鬆、權杖是否薄弱，以及連接埠是否暴露。使用--fix旗標可自動修正部分問題。

另外提醒一下詐騙問題——這不是假設情境。2026 年 1 月，專案在倉促改名時，搶註者幾秒內就接管了舊位址，立刻張貼加密貨幣錢包；假冒的「OpenClaw 開發人員」也開始宣傳代幣詐騙。由此得出兩條明確規則：只從 openclaw.ai 或 github.com/openclaw/openclaw 下載 OpenClaw。這個專案沒有發行任何加密貨幣；任何「OpenClaw 代幣」都是詐騙。無論如何都不要匯款。

安裝後，OpenClaw 可以做什麼？#

以下是我會依序嘗試的功能：

1. 閘道與模型。 先執行 openclaw gateway status，再開啟 openclaw dashboard。面板載入只確認 Control UI 可以連線。在聊天中傳送「請回覆：model connection test」，確認 AI 回覆確實到達；單純開啟頁面並未測試模型。
2. Telegram 與預期任務。 設定機器人並核准自己的配對後，在 Telegram 傳送一則新訊息給該機器人，確認回覆出現在 Telegram。接著測試一項範圍有限、可查看結果的任務，例如摘要你已允許讀取的無害測試資料夾。提醒功能要分別檢查儲存的排程與實際送達的提醒。儀表板有回覆，不能證明 Telegram 傳遞或排程執行成功。
3. 排程工作。 助理可以依排程執行工作，例如每天早上在 Telegram 傳送摘要、定期檢查電子郵件。這就是讓閘道全天候執行的原因。
4. 記憶。 OpenClaw 會在工作資料夾中的一般 Markdown 檔案裡保存長期記憶：你是誰、要如何回覆你，以及從先前對話中記住的事情。你可以自行開啟並閱讀檔案——沒有黑箱。
5. 技能。 專案提供一個目錄，內含現成技能和外掛，並設有內建安全檢查。別人的技能就是在你電腦上執行別人的程式碼，因此目錄會對它們進行檢查。

這裡有一條規則：不要一次全部啟用。先從一段穩定的對話開始，再連接 Telegram，然後才設定排程。這樣每個問題都會在各自的步驟中出現，而不會變成「全部壞掉了，我也不知道問題出在哪裡」。

安裝出問題時該怎麼辦？#

以下看看三種常見情況。

安裝後立即出現「openclaw: command not found」。 幾乎總是路徑問題：npm 全域套件資料夾不在終端機的 PATH 中。文件提供的診斷指令如下：

node -v
npm prefix -g
echo "$PATH"

第二個指令顯示的路徑應該出現在第三個指令的結果中。如果沒有，請將它加到 shell 設定中，或直接關閉並重新開啟終端機：有時安裝後只有在新的工作階段中才會出現 Node 路徑。

閘道正在執行，但助理沒有回應。 文件常見問題中的症狀是：第一則訊息沒有得到回覆，而且 Token 計數器顯示 0。這表示代理程式根本尚未啟動——最常見的原因是模型沒有設定。請依照以下順序檢查：

openclaw gateway restart
openclaw status
openclaw models status

如果已設定模型但仍沒有回覆，openclaw logs --follow會顯示即時記錄和卡住的位置。

Telegram 機器人沒有回覆。 請依序確認：權杖屬於你正在傳訊息的機器人；閘道正在執行（openclaw gateway status）；而且你的配對已獲核准（openclaw pairing list telegram）。配對碼有效時間為 1 小時——如果你昨天傳過訊息，只要再傳一次並核准新代碼即可。

如果完全卡住，文件建議一個出乎意料但合理的方法：把診斷資料交給能查看你電腦的本機 AI 代理程式。提供openclaw status --all和openclaw doctor的輸出給 Claude Code 或 Codex，它們可能比支援聊天更快讀懂設定。兜了一圈——用 AI 修復 AI。

大家還會問哪些 OpenClaw 問題？#

認識 Ailoot。