🇨🇳 简体中文 🇹🇼 繁體中文 🇯🇵 日本語 🇰🇷 한국어 🇮🇳 हिन्दी 🇧🇩 বাংলা 🇮🇩 Bahasa Indonesia 🇪🇸 Español 🇧🇷 Português 🇫🇷 Français 🇩🇪 Deutsch
首頁 / 安裝教學

安裝教學

從零開始安裝 OpenClaw，其實很簡單！跟著下面的步驟一步一步來，大概 5-10 分鐘就能搞定。別擔心，我們會解釋每一步在做什麼。

📋 系統需求

在開始安裝之前，先確認你的電腦滿足這些基本需求：

  • Node.js 22 或更高版本 — 這是 OpenClaw 執行的基礎環境（別擔心，安裝腳本會幫你檢查）
  • 作業系統 — macOS、Linux、或 Windows（需要 WSL2）
  • 記憶體 — 至少 2GB 可用記憶體
  • 磁碟空間 — 至少 500MB 可用空間
  • 網路 — 需要連網下載和呼叫 AI 模型 API
ℹ️ 什麼是 Node.js？ 簡單來說，Node.js 就像一個「翻譯官」，讓你的電腦能夠執行用 JavaScript 寫的程式。OpenClaw 就是用 JavaScript 寫的，所以需要 Node.js 來執行。你不需要學 JavaScript，只需要安裝好 Node.js 就行。
ℹ️ 什麼是 WSL2？ Windows 使用者需要注意：OpenClaw 不直接在 Windows 上執行，而是需要 WSL2（Windows Subsystem for Linux 2），它相當於在 Windows 裡裝了一個迷你 Linux 系統。如果你用的是 Windows，安裝腳本會自動幫你處理這個。

🌟 方法一：一鍵安裝腳本（推薦新手使用！）

這是最簡單的安裝方式。只需要在終端機裡複製貼上一行指令，腳本就會自動幫你完成所有事情。其實很簡單，跟著做就行！

💡 什麼是「終端機」？ 終端機就是一個可以輸入文字指令的視窗。在 macOS 上叫「終端機」（Terminal），在 Windows 上叫「PowerShell」或「命令提示字元」。你可以在電腦上搜尋「Terminal」或「終端機」來找到它。
1

開啟終端機

按下 Command + 空白鍵，輸入「Terminal」，然後按 Enter。一個黑色（或白色）的命令列視窗就會彈出來。

2

複製貼上安裝指令

複製下面這行指令，貼到終端機視窗裡，然後按 Enter：

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

這行指令會做以下幾件事情：

  • 檢查你的電腦上有沒有安裝 Node.js，如果沒有就自動幫你安裝
  • 下載並安裝 OpenClaw 最新版
  • 執行初始設定精靈（onboarding），引導你完成基本設定
3

等待安裝完成

安裝過程大概需要 2-5 分鐘，取決於你的網速。你會看到終端機裡有一堆文字在捲動，這是正常的，別擔心！安裝完成後，會自動進入設定精靈。

1

開啟終端機

在 Linux 上，你可以按 Ctrl + Alt + T 來開啟終端機，或者在應用程式選單裡搜尋「Terminal」。

2

複製貼上安裝指令

跟 macOS 一樣，複製下面的指令，貼到終端機裡，按 Enter：

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

腳本會自動檢查 Node.js、下載安裝 OpenClaw、執行設定精靈。

3

等待安裝完成

耐心等待幾分鐘，看到設定精靈的提示就說明安裝成功了！

1

開啟 PowerShell（以系統管理員身分執行）

在開始功能表搜尋「PowerShell」，右鍵點選它，選擇「以系統管理員身分執行」。這一步很重要，因為安裝過程需要系統管理員權限。

2

複製貼上安裝指令

Windows 使用者使用下面這個專用指令：

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

這個腳本會自動幫你：

  • 檢查並設定 WSL2（如果還沒安裝的話）
  • 安裝 Node.js
  • 下載安裝 OpenClaw
  • 執行初始設定精靈
3

等待安裝完成

Windows 上的安裝可能稍微慢一點（因為可能需要安裝 WSL2），大概 5-10 分鐘。安裝完成後會自動進入設定精靈。

⚠️ Windows 使用者注意：安裝 WSL2 後可能需要重新啟動電腦。如果腳本提示你重新啟動，請先重新啟動，然後重新執行安裝指令。

📦 方法二：透過 npm 安裝

如果你已經熟悉 Node.js 和 npm（Node.js 的套件管理器），可以用這種方式安裝。這個方法給你更多的控制權。

1

確認 Node.js 已安裝

開啟終端機，輸入以下指令檢查 Node.js 版本：

node --version

如果顯示 v22.x.x 或更高版本，說明你已經準備好了。如果沒有安裝或版本太低，請先去 nodejs.org 下載安裝最新版。

2

使用 npm 全域安裝 OpenClaw

在終端機中執行：

npm install -g openclaw@latest

解釋一下這個指令：

  • npm install — 使用 npm 來安裝軟體
  • -g — 全域安裝，這樣在任何地方都能使用 openclaw 指令
  • openclaw@latest — 安裝最新版本的 OpenClaw
3

執行初始設定並註冊背景服務

安裝完成後，執行：

openclaw onboard --install-daemon

這個指令做了兩件事：

  • onboard — 啟動設定精靈，引導你完成初始設定（選擇 AI 模型、輸入 API 金鑰等）
  • --install-daemon — 將 OpenClaw 註冊為背景服務（daemon），這樣它會在你開機時自動啟動，不需要每次手動開啟
💡 什麼是 daemon（守護程序）？ 簡單來說就是：一個在背景默默執行的程式，你看不到它的視窗，但它一直在工作。加上 --install-daemon 後，OpenClaw 會在背景安靜地執行，隨時等待你的訊息。

🐳 方法三：Docker 安裝

如果你喜歡使用 Docker（一種容器化技術），或者想讓 OpenClaw 在一個完全隔離的環境中執行，可以選擇這種方式。

ℹ️ 什麼是 Docker？ Docker 就像一個「虛擬盒子」，你可以把軟體放在裡面執行。這樣即使軟體出了問題，也不會影響你的電腦。如果你不知道 Docker 是什麼，建議使用方法一或方法二來安裝。
1

確保 Docker 已安裝

如果你還沒安裝 Docker，去 docker.com 下載安裝 Docker Desktop。

2

執行 OpenClaw Docker 容器

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/openclaw/openclaw:latest

這個指令會下載 OpenClaw 的 Docker 映像檔並啟動容器。-v 參數把設定檔映射到你的電腦上，這樣資料不會遺失。

✅ 安裝後驗證

安裝完成後，讓我們確認一切正常。跟著下面的步驟來檢查：

1

執行健康檢查

openclaw doctor

這個指令就像給 OpenClaw 做一次「體檢」。它會檢查所有必要的元件是否正常運作。如果一切正常，你會看到一堆綠色的勾勾。

2

檢查執行狀態

openclaw status

這個指令告訴你 OpenClaw 是否正在執行。如果顯示 "running"，說明一切正常！

3

開啟 Web 控制面板

openclaw dashboard

這個指令會自動開啟瀏覽器，存取 OpenClaw 的 Web 控制面板。網址是：

http://127.0.0.1:18789/

在這個面板裡，你可以看到 OpenClaw 的所有設定和狀態，非常直覺！

🎉 如果三個指令都沒有報錯，恭喜你！OpenClaw 已經成功安裝了！接下來去 快速上手 章節，學習如何開始使用。

🛠️ 常見安裝問題

遇到問題別慌張！下面列出了安裝過程中最常見的問題和解決方法：

問題 1：找不到指令（command not found: openclaw）

這通常是 PATH 環境變數的問題。簡單來說，你的電腦不知道 openclaw 指令在哪裡。

解決方法：

# 查看 openclaw 安裝在哪裡
which openclaw || npm list -g openclaw

# 如果用的是 bash，把路徑加到設定檔裡
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 如果用的是 zsh（macOS 預設）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

問題 2：Node.js 版本太低

如果你看到類似 "Node.js v18 is not supported" 的錯誤，說明你需要升級 Node.js。

解決方法：

# 使用 nvm（Node Version Manager）來管理 Node.js 版本
# 先安裝 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安裝 Node.js 22
nvm install 22

# 切換到 Node.js 22
nvm use 22

# 確認版本
node --version

問題 3：連接埠衝突（EADDRINUSE）

如果你看到 "EADDRINUSE: address already in use :::18789"，說明連接埠 18789 已經被其他程式佔用了。

解決方法：

# 查找佔用連接埠 18789 的程序
lsof -i :18789

# 如果是舊的 OpenClaw 程序，先停止它
openclaw stop

# 然後重新啟動
openclaw start

問題 4：權限不足（EACCES）

在 Linux/macOS 上使用 npm 全域安裝時可能遇到權限問題。

解決方法：

# 方法 A：修改 npm 全域安裝目錄
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 然後重新安裝
npm install -g openclaw@latest
⚠️ 千萬不要用 sudo npm install -g！ 雖然加上 sudo 可以解決權限問題，但這樣做可能會導致其他安全問題。請使用上面的方法來修改 npm 的全域安裝目錄。

問題 5：網路逾時

如果下載速度很慢或逾時，可能是因為網路問題。

解決方法：

# 設定 npm 使用替代映像源
npm config set registry https://registry.npmmirror.com

# 然後重新安裝
npm install -g openclaw@latest