OpenClaw（龍蝦 🦞）是一套開源的個人 AI 助手，可以跑在你自己的設備上，透過 LINE、WhatsApp、Telegram、Discord 等你已經在用的通訊軟體來對話，完全不需要訂閱任何服務。這篇文章將一步步帶你從零開始安裝與設定。
OpenClaw 是什麼？
OpenClaw 是一個 Local-first（本地優先）的 AI Gateway，概念是：你的 AI 助手跑在你自己的電腦上，你用任何慣用的通訊 App 來聊天。
- 支援 LINE、WhatsApp、Telegram、Discord、Slack、iMessage 等 20+ 平台
- 支援 Claude、ChatGPT、Gemini 等主流 LLM
- 開源免費，資料存在本機
- 支援 macOS、Linux、Windows（WSL2）
安裝前的準備
安裝 OpenClaw 只需要以下兩項：
- Node.js 24（建議）或 Node.js 22.16+：前往 nodejs.org 下載安裝
- npm 或 pnpm（隨 Node.js 一起安裝）
安裝完後，開啟終端機（Terminal）確認版本：
node -v # 應顯示 v24.x.x 或以上
npm -v # 應顯示版本號Step 1：安裝 OpenClaw
在終端機執行以下指令，全域安裝 OpenClaw：
npm install -g openclaw@latest安裝完成後，確認是否成功：
openclaw --versionStep 2：執行引導精靈（Onboard）
OpenClaw 提供一個互動式的初始設定精靈，會自動引導你完成所有設定，包含 AI 模型選擇、通訊頻道連結、背景服務安裝等：
openclaw onboard --install-daemon--install-daemon 參數會將 OpenClaw Gateway 安裝為背景服務（macOS 使用 launchd、Linux 使用 systemd），讓它開機後自動啟動，隨時待命。
設定 AI 模型
精靈會詢問你要使用哪個 AI 模型，常見選項：
- Claude（Anthropic）：前往 Anthropic Console 申請 API Key
- ChatGPT（OpenAI）：前往 OpenAI Platform 申請 API Key，或使用 OAuth 登入
- Gemini（Google）：前往 Google AI Studio 申請免費 API Key
Step 3：啟動 Gateway
如果沒有安裝 daemon，也可以手動啟動 Gateway：
openclaw gateway --port 18789 --verbose看到 Gateway 啟動訊息後，即可開始連結你的通訊頻道。
Step 4：連結通訊頻道
OpenClaw 支援超過 20 種通訊平台，以下以幾個常見平台為例：
連結 Telegram
前往 @BotFather 建立一個 Telegram Bot，取得 Bot Token 後，在 config.yml 中加入：
channels:
telegram:
token: "你的 Bot Token"連結 Discord
在 Discord Developer Portal 建立應用程式，取得 Bot Token 後加入設定：
channels:
discord:
token: "你的 Discord Bot Token"Step 5：發送第一則訊息
設定完成後，測試 AI 助手是否正常運作：
# 直接用 CLI 對話
openclaw agent --message "你好，請介紹你自己"
# 發送訊息到指定頻道
openclaw message send --to @your_telegram --message "測試訊息"常用指令速查
| 指令 | 說明 |
|---|---|
openclaw onboard | 初始設定精靈 |
openclaw gateway | 啟動 Gateway 服務 |
openclaw agent --message "..." | 直接對話 |
openclaw doctor | 檢查設定是否正確 |
openclaw update | 更新到最新版本 |
openclaw pairing approve <channel> <code> | 核准新使用者配對 |
常見問題 FAQ
Windows 用戶可以安裝嗎？
可以，但強烈建議使用 WSL2（Windows Subsystem for Linux）來安裝，原生 Windows 支援仍在開發中。在 WSL2 Ubuntu 環境下，安裝流程與 Linux 完全相同。
使用 OpenClaw 需要付費嗎？
OpenClaw 本身完全免費開源（MIT License）。費用僅來自你連結的 AI 模型（如 Claude API、OpenAI API），這部分依照各服務商的計費方式收費。如果使用免費額度的模型，整體可以零成本運行。
安裝後 openclaw 指令找不到怎麼辦？
通常是 npm 全域安裝路徑未加入 PATH。執行 npm config get prefix 取得路徑，再將 /bin 子目錄加入你的 ~/.zshrc 或 ~/.bashrc，然後重新開啟終端機即可。
如何更新 OpenClaw 到最新版？
執行 openclaw update 即可自動更新，或手動執行 npm install -g openclaw@latest。更新後建議執行 openclaw doctor 確認設定無誤。
OpenClaw 讓你擁有一個跑在自己設備上、透過任何通訊 App 隨時呼叫的 AI 助手。如果你習慣用 LINE 或 Telegram，設定完成後就像多了一個隨叫隨到的 AI 好夥伴 🦞