免費 AI 助理自己架！安裝前搞懂這 3 件事，少走 10 小時冤枉路

🤖 OpenClaw
👤 S.M.Project
⏱ 15 分鐘閱讀

身邊三個朋友試了三個週末都卡在這一步，最後放棄了。
不是因為他們技術差——是網路上 90% 的 OpenClaw 安裝教學，都漏掉了「環境準備」這件事。
所以你照著輸入指令，按下 Enter——然後卡在 npm install 不動了。

這篇文章，就是讓你永遠不要經歷那個 moment。

⚡ 安裝 OpenClaw 之前，你只需要確認 3 件事

需求	說明	預估時間
Node.js	22.14+ 或 24 版	5 分鐘
AI 模型 API Key	申請一組 API Key	10 分鐘
網路連線	需能連線 GitHub / npm	—

說實話，這三樣東西看起來簡單，但 Node.js 版本選錯、API Key 申請方式不對——新手大概就卡在這裡。我自己第一次裝的時候，光 Node 版本衝突就搞了兩天。

🔧 一、Node.js 安裝（各系統）

為什麼需要 Node.js？

OpenClaw 是用 Node.js 開發的，所以你的機器必須先裝這個執行環境。它就像 Python 需要 Python Runtime 一樣。

macOS

Homebrew 方式（推薦）：

# 先裝 Homebrew（如果沒有的話）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 然後裝 Node.js
brew install node

# 確認版本
node --version

常見問題： 如果終端機噴 command not found，重開一個終端機視窗再試一次。

Linux（Ubuntu/Debian）

# 用 NodeSource 安裝（推薦，版本精準）
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash -
sudo apt-get install -y nodejs

# 確認
node --version

彩蛋： node --version 前面如果出現 v24 或 v22，代表安裝成功。沒有出現的話，試試重開終端機。

Windows：建議用 WSL2

老實說，Windows 原生跑 Node.js 偶爾會遇到一些莫名其妙的小問題。我身邊 10 個用 Windows 的朋友，9 個最後都改用 WSL2 了。

WSL2 的好處：

指令跟 Linux 一模一樣
npm install 那些套件完全不會出錯
以後要跑 Docker 也順手很多

設定方式見下方第三段。

🌐 二、API Key 申請（2026 年最新版）

這步驟我建議先完成再繼續，因為沒有 API Key 的話，就算 OpenClaw 裝起來了也沒辦法對話。

2026 年 3 月最新各家比較

提供商	模型	輸入（每 1M tokens）	輸出（每 1M tokens）	特色	適合誰
Anthropic	Claude Opus 4.6	$5.00	$25.00	品質評分最高	複雜推理、程式開發
Anthropic	Claude Sonnet 4.5	$3.00	$15.00	性價比均衡	日常助理任務
OpenAI	GPT-5.4	$2.50	$15.00	生態最完整	新手友善
OpenAI	GPT-5.4-mini	$0.75	$4.50	輕量快速	大量簡單任務
Google	Gemini 3 Pro	$2.00	$12.00	1M 上下文	長文字處理
Google	Gemini 3 Flash	$0.50	$3.00	極速、免費額度大	快速回應、輕量任務
MiniMax	M2.5	$0.15	$1.20	成本極低	量大、預算有限

💡 提醒：AI 模型定價波動頻繁，發布前建議再到各官網確認一次最新價格。

說實話省錢重點：

用 OpenAI 的話，GPT-5.4-mini CP 值最高
要省錢就選 MiniMax M2.5，輸出成本只要 $1.20/M，約是 GPT-5.4 的 1/12

Anthropic Claude 申請

前往 https://console.anthropic.com
點 Sign Up，填 Email 驗證
進去後找 API Keys → Create Key
複製那一串金鑰（開頭是 sk-ant-）

新帳號通常有 $5 免費額度，用多少付多少。

OpenAI GPT-5.4 申請

前往 https://platform.openai.com
右上角 Sign Up 註冊
驗證手機號碼
API Keys → Create new secret key
複製金鑰（開頭是 sk-）

Google Gemini 申請

前往 https://aistudio.google.com
登入 Google 帳號
Get API Key → Create API Key
複製

新手最推這個，給的免費額度最大方。

MiniMax M2.5 申請

前往 https://platform.minimax.io
註冊帳號
進入個人中心 → API Key
創建新的 API Key
複製

優點： 成本極低，性價比王。

⚠️ 重要提醒：金鑰別分享出去，遺失了就去官網撤銷重申請。

🖥️ 三、WSL2 設定（Windows 專用）

這段是給 Windows 用戶的，macOS / Linux 可以跳過。

Step 1：確認 Windows 版本

按 Win + R，輸入 winver

版本	結果
Windows 11	✅ 直接裝
Windows 10 21H2+	✅ 可以裝，但要手動開功能
更舊版本	❌ 不支援 WSL2

Step 2：以系統管理員開啟 PowerShell

在開始選單搜尋 PowerShell，按右鍵 → 以系統管理員身份執行。

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

完成後，電腦可能會要求重啟動。

Step 3：安裝 WSL2

下載這個更新套件：👉 https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

Step 4：安裝 Ubuntu

wsl --install -d Ubuntu-24.04

第一次執行時，會要求設定：

Username：建議用英文，不要有空格
Password：設定密碼，以後 sudo 會用到

Step 5：開啟 systemd（重要！）

sudo nano /etc/wsl.conf

貼入：

[boot]
systemd=true

按 Ctrl + O 儲存，Ctrl + X 離開。

wsl --shutdown

重新開 Ubuntu，驗證：

systemctl --user status

如果看到 systemd running，代表成功。

❌ WSL2 常見錯誤與解決方式

錯誤訊息	原因	解決方式
`WslRegisterDistribution failed`	WSL 核心未更新	執行 `wsl --update` 更新 WSL 核心
`Installation failed with error 0x80070003`	系統碟空間不足	確認 C 槽至少留 30GB
`WslInitializeDistribution failed`	BIOS 虛擬化未開啟	重開機進 BIOS，啟用 Intel VT-x / AMD-V
終端機一片空白	WSL 整合功能未開	PowerShell 執行 `wsl --shutdown` 再重開
`apt-get install` 失敗	網路問題	設定代理或確認網路可連線

✅ 安裝前檢查清單

□ node --version 顯示 v22.14+ 或 v24
□ npm --version 有數字輸出
□ API Key 已申請並備份
□ Windows 用戶：Ubuntu 正常開啟
□ Windows 用戶：systemctl --user status 有輸出
□ 網路可以連到 github.com

🚀 開始安裝

Linux / macOS / WSL2：

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

🧪 驗證：Hello World 測試

裝完之後，執行初始化：

openclaw onboard --install-daemon

然後測試有沒有真的運作：

openclaw gateway status

看到 listening on port 18789 就是成功了。

或是開啟控制台：

openclaw dashboard

瀏覽器會自動開啟，出現對話介面就是完成了。

💬 互動時間

你之前架 OpenClaw 的時候，最容易卡在哪一步？
留言告訴我 👇 我可以針對那個部分多寫一篇。

如果覺得這篇有幫助，歡迎分享給也在研究 OpenClaw 的朋友。

❄️ 有問題歡迎問我！

#OpenClaw
#AI助理
#自架AI
#OpenClaw安裝教學
#Nodejs安裝
#AI工具架設
#個人AI助理

免費 AI 助理自己架！安裝前搞懂這 3 件事，少走 10 小時冤枉路

免費 AI 助理自己架！安裝前搞懂這 3 件事，少走 10 小時冤枉路

⚡ 安裝 OpenClaw 之前，你只需要確認 3 件事

🔧 一、Node.js 安裝（各系統）

為什麼需要 Node.js？

macOS

Linux（Ubuntu/Debian）

Windows：建議用 WSL2

🌐 二、API Key 申請（2026 年最新版）

2026 年 3 月最新各家比較

Anthropic Claude 申請

OpenAI GPT-5.4 申請

Google Gemini 申請

MiniMax M2.5 申請

🖥️ 三、WSL2 設定（Windows 專用）

Step 1：確認 Windows 版本

Step 2：以系統管理員開啟 PowerShell

Step 3：安裝 WSL2

Step 4：安裝 Ubuntu

Step 5：開啟 systemd（重要！）

❌ WSL2 常見錯誤與解決方式

✅ 安裝前檢查清單

🚀 開始安裝

🧪 驗證：Hello World 測試

💬 互動時間

發佈留言取消回覆

筆電變慢怎麼辦？加速優化教學

🔥 你的舊電腦不是垃圾！用它跑 OpenClaw，差異只是「快」或「超快」