OpenClaw 安裝教學 從零開始完整攻略
不是工程師也能自己裝 一步一步帶你搞定
OpenClaw 是什麼 為什麼你需要它
OpenClaw 是一個開源的 AI 助理框架 簡單來說 它可以讓你在 Telegram、LINE、Discord 上面跑自己的 AI 助理 不用依賴別人的服務 不用月付訂閱費 你的資料也不會被第三方平台拿走
如果你已經在用 ChatGPT 但覺得每次都要開網頁很麻煩 或是想要一個能直接在通訊軟體裡回答你的 AI 助理 OpenClaw 就是你要的東西
安裝前準備
在開始之前 你需要準備這三樣東西
- 一台電腦 — Mac 或 Windows 都可以 不需要很好的硬體 一般筆電就行
- Node.js — 這是讓 OpenClaw 跑起來的運行環境 等一下會教你怎麼裝
- API Key — 你需要一組 OpenAI 或 Anthropic 的 API Key 用來連接 AI 模型 可以到 OpenAI 或 Anthropic 的官網申請
Mac 安裝步驟
第一步：安裝 Node.js
打開「終端機」(Terminal) 你可以用 Spotlight 搜尋
Terminal 找到它
先安裝 Homebrew（Mac 的套件管理工具）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"裝好之後 用 Homebrew 安裝 Node.js
brew install node確認有沒有裝成功
node -v如果看到版本號（像是 v22.x.x）就代表成功了
第二步：下載 OpenClaw
git clone https://github.com/open-claw/open-claw.git
cd open-claw
npm install第三步：設定環境變數
cp .env.example .env用文字編輯器打開 .env 檔案 把你的 API Key 填進去
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx第四步：啟動
npm start看到 OpenClaw is running 就代表成功了
Windows 安裝步驟
第一步：安裝 Node.js
到 Node.js 官網 下載 LTS 版本 然後一路「下一步」裝到底就好
裝完之後 打開「命令提示字元」或「PowerShell」 輸入
node -v看到版本號就代表成功
第二步：安裝 Git
Windows 通常沒有內建 Git 到 git-scm.com 下載安裝 一樣一路下一步就好
第三步：下載 OpenClaw
git clone https://github.com/open-claw/open-claw.git
cd open-claw
npm install第四步：設定環境變數
copy .env.example .env用記事本打開 .env 填入你的 API Key
第五步：啟動
npm start連接通訊平台
連接 Telegram
- 在 Telegram 搜尋
@BotFather建立一個新的 Bot - 拿到 Bot Token 之後 填到
.env裡面
TELEGRAM_BOT_TOKEN=你的token重新啟動 OpenClaw 就可以在 Telegram 跟你的 AI 助理聊天了
連接 LINE
- 到 LINE Developers 建立一個 Messaging API Channel
- 拿到 Channel Secret 和 Channel Access Token
- 填到
.env
LINE_CHANNEL_SECRET=你的secret
LINE_CHANNEL_ACCESS_TOKEN=你的tokenLINE 比較麻煩的是需要設定 Webhook URL 你的電腦需要一個公開的網址 可以用 ngrok 或是把 OpenClaw 部署到雲端伺服器上
常見問題
npm install 跑到一半出錯
最常見的原因是 Node.js 版本太舊 確認你的版本是 18 以上 如果不是 重新裝一次最新版
啟動之後連不上
檢查 .env 裡面的 API Key 有沒有打錯
特別注意前後不要有多餘的空格
LINE Webhook 設定失敗
LINE 的 Webhook 需要 HTTPS 的公開網址 本機開發的話建議用 ngrok 把 local server 暴露出去 或者直接部署到 VPS 上面
Windows 上 git clone 失敗
確認你有安裝 Git 打開 PowerShell 輸入
git --version 如果沒有反應 代表還沒裝好