本機安裝 OpenClaw 與 Ollama 完整教學(CMD 版)
前置準備
- 確保 Windows 系統為 Windows 10/11(建議版本)
- 以管理員身分開啟 CMD(滑鼠右鍵點擊 CMD 圖示 → 以管理員身分執行)
- 網路暢通,預留至少 5GB 磁碟空間
第一步:安裝 Node.js(含 npm)
Node.js 是執行 OpenClaw 的基礎環境,npm 是 Node.js 的套件管理工具,需先完成安裝。
1.1 下載 Node.js 安裝包
開啟 CMD,執行以下命令下載 LTS 穩定版 Node.js(以 v20.12.2 為例):
# 切換到下載目錄(可自定義,如 D:\Downloads)
cd C:\Users\你的使用者名稱\Downloads
# 下載 Node.js 安裝包(64位元)
curl -o node-v20.12.2-x64.msi https://nodejs.org/dist/v20.12.2/node-v20.12.2-x64.msi
提示:
如果提示 curl 不是內部命令,代表系統未內建 curl,可手動造訪 Node.js 官方網站 下載 Windows 安裝包(.msi)。
1.2 安裝 Node.js
執行以下命令啟動安裝程式:
msiexec /i node-v20.12.2-x64.msi /qn
/i:表示安裝/qn:靜態安裝(無需手動點擊下一步,推薦新手使用)
等待安裝完成(約 1-2 分鐘),驗證安裝結果:
# 檢查 Node.js 版本
node -v
# 檢查 npm 版本
npm -v
成功標誌:
輸出類似 v20.12.2(Node.js)和 10.5.0(npm)的版本號。
第二步:安裝 Git
Git 用於複製(clone)OpenClaw 的原始碼倉庫,是取得開源專案的必備工具。
2.1 下載 Git 安裝包
在 CMD 中執行以下命令下載 Git(64位元):
# 仍在下載目錄執行
curl -o Git-2.45.0-64-bit.exe https://github.com/git-for-windows/git/releases/download/v2.45.0.windows.1/Git-2.45.0-64-bit.exe
替代方案:
手動下載 Git for Windows。
2.2 安裝 Git
執行靜態安裝命令:
Git-2.45.0-64-bit.exe /verysilent /norestart
/verysilent:超靜態安裝(無介面)/norestart:安裝後不重新啟動系統
驗證安裝:
git --version
成功標誌:
輸出 git version 2.45.0.windows.1 類似版本號。
第三步:安裝 Ollama(本地大模型執行環境)
Ollama 是輕量級的大模型管理工具,支援一鍵執行 Llama 3、Qwen 等模型,是 OpenClaw 的核心依賴。
3.1 下載 Ollama 安裝包
在 CMD 中執行:
# 下載 Ollama Windows 版本
curl -o ollama-setup.exe https://ollama.com/download/windows
3.2 安裝並啟動 Ollama
執行安裝命令:
ollama-setup.exe /S
/S:靜態安裝
安裝完成後,啟動 Ollama 服務:
ollama serve
注意:
此命令會保持 CMD 視窗執行,不要關閉,需另外開一個 CMD 視窗執行後續操作。
3.3 驗證 Ollama 安裝
新開 CMD 視窗,執行:
ollama -v
成功標誌:
輸出 ollama version 0.1.48 類似版本號。
(選擇性)拉取測試模型(如 Llama 3 8B):
ollama pull llama3:8b
等待模型下載完成(約 4.7GB),後續可用於測試 OpenClaw。
第四步:安裝並執行 OpenClaw
OpenClaw 是基於 Ollama 的開源 UI 管理工具,需透過 Git 複製原始碼並使用 npm 安裝依賴。
4.1 複製 OpenClaw 倉庫
選擇存放目錄(如 C:\Projects),執行:
# 建立專案目錄
mkdir C:\Projects
cd C:\Projects
# 複製 OpenClaw 原始碼
git clone https://github.com/huoyijie/OpenClaw.git
4.2 安裝依賴並啟動
進入 OpenClaw 目錄,安裝 npm 依賴:
cd OpenClaw
npm install
提示:
若安裝速度緩慢,可切換台灣/淘寶鏡像:
npm config set registry https://registry.npm.taobao.org
npm install
啟動 OpenClaw:
npm run dev
等待啟動完成,CMD 會輸出類似內容:
VITE v5.2.8 ready in 300 ms
➜ Local: http://localhost:5173/
開啟瀏覽器,存取 http://localhost:5173,即可進入 OpenClaw 介面,選擇已下載的模型(如 llama3:8b)即可使用。
常見問題解決
- 1.
CMD 提示「命令不存在」:
安裝完成後關閉所有 CMD 視窗,重新開啟(環境變數需刷新)。 - 2.
npm install 失敗:
檢查網路,或執行npm cache clean --force清理快取後重試。 - 3.
Ollama 啟動失敗:
確保以管理員身分執行 CMD,或手動在開始功能表啟動 Ollama 服務。
總結
- 安裝順序:Node.js → Git → Ollama → OpenClaw,前兩者是基礎環境,後兩者是核心工具;
- Ollama 需保持
ollama serve持續執行,OpenClaw 依賴此服務才能連接本地模型; - 每一步安裝後透過版本命令驗證,可快速定位問題並排除。
依照以上步驟,你已完成 OpenClaw + Ollama 的本地部署,可在瀏覽器中直接使用本地大模型,無需依賴雲端服務。
