🐧

Part 13: Linux 安裝教學

在 Linux 上安裝 OpenClaw

Ubuntu / Debian 一鍵安裝 systemd 服務

📋 系統需求

項目 需求
作業系統Ubuntu 20.04+ / Debian 11+ / 其他 Linux 發行版
Node.jsv22.0.0 或更高版本(必要)
記憶體建議 4GB 以上
網路需要穩定的網路連線
其他LLM API 金鑰(Gemini / OpenAI / Claude)

⭐ 方法一:一鍵安裝(推薦)

方式 A:使用官方安裝腳本

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

這個腳本會自動:檢測作業系統、安裝 Node.js 22+、安裝 OpenClaw、設定環境變數

方式 B:先下載再執行(推薦,可看完整訊息)

# 1. 下載腳本
curl -fsSL https://openclaw.ai/install.sh -o install.sh

# 2. 查看腳本內容(可選,確認安全)
cat install.sh

# 3. 執行安裝
bash install.sh

📦 方法二:npm 安裝(最穩定)

如果你已經有 Node.js 22+,這是最穩定的方式:

步驟 1:確認 Node.js 版本

node -v  # 應顯示 v22.x.x 或更高

步驟 2:安裝 OpenClaw

npm install -g openclaw@latest

步驟 3:執行初始化

openclaw onboard --install-daemon
💡 如果沒有 Node.js 22+,請先用 nvm 安裝:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

🚀 啟動 Gateway 服務

方式一:手動啟動(前景模式,方便除錯)

openclaw gateway --port 18789 --verbose

方式二:使用 systemd 服務(背景執行)

# 啟動服務
systemctl --user start openclaw-gateway

# 開機自動啟動
systemctl --user enable openclaw-gateway

# 查看狀態
systemctl --user status openclaw-gateway
驗證安裝:
openclaw --version
openclaw doctor

🌐 安裝 ngrok(內網穿透)

由於 LINE Webhook 需要公開的 HTTPS URL,需要使用 ngrok。

方法一:使用 snap

sudo snap install ngrok

方法二:使用 apt

curl -sSL https://ngrok-agent.s3.amazonaws.com/ngrok.asc \
  | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null \
  && echo "deb https://ngrok-agent.s3.amazonaws.com buster main" \
  | sudo tee /etc/apt/sources.list.d/ngrok.list \
  && sudo apt update \
  && sudo apt install ngrok

設定 ngrok

# 註冊帳號後取得 authtoken
ngrok config add-authtoken <你的_authtoken>

# 啟動 ngrok
ngrok http 18789

💬 安裝 LINE 外掛

步驟 1:安裝 LINE 外掛

openclaw plugins install @openclaw/line

步驟 2:設定 LINE 憑證

# 方法一:使用指令設定
openclaw config set channels.line.channelAccessToken "你的_Token"
openclaw config set channels.line.channelSecret "你的_Secret"

# 方法二:編輯設定檔
nano ~/.openclaw/openclaw.json

步驟 3:重啟 Gateway

systemctl --user restart openclaw-gateway
# 或
openclaw gateway restart

❓ 常見問題

Q1:openclaw: command not found
# 將 npm 全域路徑加入 PATH
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc
Q2:Node.js 版本太舊
nvm install 22
nvm use 22
nvm alias default 22
Q3:ngrok URL 每次重啟都會變
免費方案無法固定 URL,考慮使用 Cloudflare Tunnel(免費且可固定)或 ngrok 付費方案。
🎉

Linux 安裝完成!

你已經在 Linux 上成功安裝 OpenClaw!

✅ OpenClaw ✅ ngrok ✅ LINE 外掛
➡️ Part 14:GitHub 版本安裝