OpenClaw（龍蝦 AI）完整安裝教學 2026：從零架設個人 AI 助理，串接 Telegram

OpenClaw（龍蝦）是目前 GitHub 成長速度最快的 AI agent 開源專案，讓你在自己的電腦上架設一個永遠在線的私人 AI 助理，並透過 Telegram、WhatsApp、Discord 等你平常就在用的通訊 App 和它對話。

這篇教學從零開始，帶你完成安裝、設定到發送第一則訊息，全程約 10 分鐘。

OpenClaw 是什麼？和 ChatGPT 有什麼不同？

ChatGPT 是問答工具，你問它一個問題，它給你一個回答，對話完成後就結束了。OpenClaw 是 AI agent：你交付一個任務，它會自己思考、呼叫工具、執行動作——查你的 Gmail、看你的日曆、搜尋網路、寫程式——然後把結果告訴你。

更關鍵的差異是：OpenClaw 跑在你自己的電腦上，資料完全由你掌控，不會上傳到任何第三方伺服器。它本身不包含 AI 模型，需要你自己提供 API Key（Anthropic Claude、OpenAI GPT、Google Gemini 等皆可），模型費用直接由你付給供應商。

安裝前準備

系統需求

macOS、Linux，或 Windows（建議使用 WSL2，穩定性更高）

Node.js 22.14 以上（推薦 Node 24）

至少一組 AI 模型的 API Key

安裝 Node.js

先確認有沒有安裝、版本夠不夠：

node -v

若版本低於 v22.14 或尚未安裝，依系統選擇安裝方式：

取得 AI 模型 API Key

OpenClaw 支援多種模型供應商，以下是最常用的三個選擇：

Anthropic Claude：前往 console.anthropic.com 建立帳號，在 API Keys 頁面新增金鑰。Claude Sonnet 4.x 是目前最主流的選擇。

OpenAI GPT：前往 platform.openai.com，建立 API Key。

Google Gemini：前往 aistudio.google.com，可免費取得 API Key。

把 API Key 複製好備用，等等安裝時會需要貼入。

第一步：安裝 OpenClaw

macOS 與 Linux 只需一行指令：

curl -fsSL | bash

Windows 用戶在 PowerShell 執行：

iwr -useb | iex

安裝完成後，確認指令可以使用：

openclaw --version

第二步：執行 Onboarding 向導

執行以下指令，啟動互動式設定向導，同時讓 OpenClaw 以背景服務形式隨系統啟動：

openclaw onboard --install-daemon

向導會依序詢問幾個問題：

選擇模型供應商：選你剛才取得 API Key 的那家（Anthropic、OpenAI、Google 等）

貼入 API Key：把剛才複製的金鑰貼進去

選擇模型：建議選最新的主力模型（如 claude-sonnet-4-5）

選擇安裝模式：新手選 QuickStart 即可，會用預設值完成所有設定

整個過程約 2 分鐘，大部分選項按 Enter 接受預設值就好。

第三步：確認 Gateway 正在運行

openclaw gateway status

若看到 Gateway 監聽在 port 18789，代表安裝成功。

開啟瀏覽器控制介面試試：

openclaw dashboard

瀏覽器會打開 Control UI，你可以在這裡直接傳訊息給 AI 助理，確認一切運作正常。

第四步：串接 Telegram（最快上手的方式）

Telegram 是 OpenClaw 官方支援最完整的通訊管道，設定也最簡單，只需要一組 Bot Token。

4-1 向 BotFather 申請 Bot Token

打開 Telegram，搜尋並開啟 @BotFather（確認旁邊有官方藍勾）

傳送 /newbot

依提示輸入 Bot 名稱（顯示名）和 Bot 帳號（需以 bot 結尾，如 my_ai_assistant_bot）

BotFather 會給你一組 Token，格式類似 123456789:AAGxxxxxxxxxxxxxxxxx，把它複製下來

4-2 設定 Token

編輯 OpenClaw 設定檔（預設路徑

~/.openclaw/config.json5

），加入 Telegram 設定：

{ channels: { telegram: { enabled: true, botToken: “在這裡貼入你的 Token”, dmPolicy: “pairing”, }, }, }

4-3 重啟 Gateway 並配對

openclaw gateway restart openclaw pairing list telegram

接著在 Telegram 找到你剛建立的 Bot，傳任一訊息給它，會得到一組配對碼。執行：

openclaw pairing approve telegram <配對碼>

完成後，在 Telegram 傳訊息給你的 Bot，就會收到 AI 助理的回覆。

常見問題 FAQ

Node 版本錯誤怎麼辦？

執行

node -v

確認版本。若低於 v22.14，依照上方表格重新安裝 Node.js。macOS 用戶若有安裝 Homebrew，執行 brew upgrade node 即可升級。

Gateway 無法啟動？

執行

openclaw gateway status

查看錯誤訊息。最常見的原因是 port 18789 被佔用，或 API Key 格式錯誤。可以執行 openclaw configure 重新設定。

如何更換 API Key？

執行

openclaw configure

，選擇 Model/Auth 步驟重新設定即可。

Token 會一直燒嗎？

預設情況下，OpenClaw 只在收到訊息時才呼叫 API，不會無故消耗 Token。但若你啟用了某些自動化 Skill 或排程任務，建議在模型供應商的後台設定每月用量上限，避免意外超支。

接下來可以做什麼

串接 Gmail、Google Calendar，讓助理幫你管理信件與行程

安裝 Skills，擴充助理的能力（網路搜尋、程式執行、記憶管理等）

雲端部署：透過 Cloudflare Tunnel 讓龍蝦 24 小時在線（進階教學，即將推出）

這篇文章 OpenClaw（龍蝦 AI）完整安裝教學 2026：從零架設個人 AI 助理，串接 Telegram 最早出現於 鏈新聞 ABMedia。