最近本地AI Agent框架真的火到不行，OpenClaw作為輕量級選手，更是圈粉無數——很多人都想安裝它，用來做自動化文件處理、代碼生成分析、數據整理，或是搭建本地AI工作流，不用依賴云端，隱私又高效。

但很多人都有一個共同的困擾：看了不少安裝教程，全是針對蘋果Mac的，自己只有Windows電腦，以為沒機會用，要么跟風裝卻頻頻翻車，要么直接放棄。其實根本不用愁！現在Windows系統也能輕松安裝OpenClaw，全程不用復雜操作，新手也能一次成功。

不過實話實說，Windows上部署OpenClaw，確實比Mac容易遇到幾個小問題：比如CLI顯示安裝成功，輸入命令卻沒反應；Gateway服務死活啟動不了；好不容易裝完，卻連不上本地大模型；甚至調用API模型時直接報錯，越裝越煩躁。

今天這篇深度教程，就從零基礎開始，一步步教你在Windows上安裝、配置OpenClaw，從環境準備到啟動服務，從配置大模型到測試AI Agent，把所有常見坑都提前避開，全程保姆級講解，就算你是電腦小白，跟著做也能順利用上本地AI自動化工具！

一、安裝前環境準備（必做！少一步都可能報錯）

Windows上安裝OpenClaw，前期環境準備比安裝本身更重要——很多人安裝失敗，不是步驟錯了，而是環境沒搭好。大家跟著下面的步驟來，一步都別省，就能避開80%的坑。

1. 確認Windows系統版本

首先先檢查一下自己的Windows版本，老系統兼容性太差，容易出現各種報錯，建議大家滿足以下要求：

? 推薦系統：Windows 10 或 Windows 11（親測這兩個版本最穩定，Win7及以下不建議嘗試）

? 額外建議：開啟 PowerShell 7（推薦，比系統自帶的PowerShell更穩定）、Windows Terminal（操作更方便，可選）

不用特意去升級系統，只要是Win10或Win11，基本都能正常安裝，重點是后面的Node環境。

2. 安裝Node.js（核心依賴，必須裝）

OpenClaw的CLI工具是基于Node.js運行的，沒有Node環境，根本裝不了，這是最基礎也是最容易出錯的一步，大家一定要重視。

? 推薦Node版本：Node 18 或 Node 20（這兩個版本和OpenClaw兼容性最好，親測不會出現報錯）

下載方法很簡單，直接去Node.js官方網站下載，找到對應版本（Windows系統，根據自己電腦是32位還是64位選擇），下載后雙擊安裝，一路下一步就好，不用特意修改安裝路徑（默認路徑就可以）。

安裝完成后，驗證一下是否成功：打開PowerShell（或Windows Terminal），輸入下面兩個命令，按回車：

node -vnpm -v

如果終端返回類似“v20.9.0”“9.8.1”這樣的版本號，說明Node安裝成功了；如果顯示“命令不是內部或外部命令”，說明安裝失敗，重新安裝一遍，記得勾選“添加到環境變量”（安裝時默認勾選，別取消）。

3. 推薦安裝Node版本管理器（可選，避免版本沖突）

這一步不是必須的，但非常推薦！如果你的電腦里裝了多個Node版本，或者以后需要切換Node版本，很容易和OpenClaw需要的版本沖突，導致CLI運行報錯、Gateway啟動失敗。

Windows用戶推薦安裝：nvm-windows（專門針對Windows的Node版本管理器），安裝方法很簡單，網上搜“nvm-windows下載”，找到官方安裝包，雙擊安裝即可。

安裝完成后，打開PowerShell，輸入下面的命令，安裝并切換到Node 20版本（最穩定）：

nvm install 20nvm use 20

切換完成后，再輸入node -v，確認版本是20.x.x，這樣后續運行OpenClaw就不會出現版本沖突的問題了。

二、安裝OpenClaw CLI（核心步驟，一鍵搞定）

環境準備好后，就可以正式安裝OpenClaw了，官方提供了Windows專屬的安裝腳本，不用手動操作復雜步驟，新手也能輕松上手，重點注意：一定要用管理員身份打開PowerShell！

第一步：打開PowerShell（管理員）——在開始菜單搜“PowerShell”，右鍵選擇“以管理員身份運行”，別直接打開普通PowerShell，否則會報錯（權限不足）。

第二步：復制粘貼下面這行命令，按回車（建議直接復制，避免手動輸入出錯，復制后右鍵粘貼到PowerShell即可）：

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

執行命令后，系統會自動開始安裝，不用管它，等待1-2分鐘就好（根據電腦配置，速度會有差異）。這個腳本會自動完成以下操作，不用你手動干預：

• 安裝OpenClaw CLI核心工具

• 自動創建用戶配置目錄

• 初始化Gateway后臺服務

• 設置環境變量（保證終端能識別openclaw命令）

當終端顯示類似“OpenClaw installed successfully”（OpenClaw安裝成功）的提示，就說明CLI已經裝好了，下一步就是驗證安裝是否成功。

三、驗證安裝是否成功（必做，避免白忙活）

安裝完成后，別著急啟動服務，先驗證一下CLI是否能正常使用，避免后續啟動失敗又要回頭排查，步驟很簡單：

在PowerShell中輸入下面這行命令，檢查版本號：

openclaw --version

如果終端返回類似“OpenClaw CLI v1.x.x”的版本號，說明安裝成功了；如果提示“命令不是內部或外部命令”，別慌，后面常見問題里會講解決方法。

另外，也可以查看OpenClaw的幫助文檔，熟悉一下基本命令，輸入：

openclaw help

終端會顯示所有可用的命令，不用記，后續用到再查就好，新手不用有壓力。

四、啟動OpenClaw Gateway服務（后臺核心，必須啟動）

OpenClaw在Windows上是通過Gateway后臺服務運行AI Agent的，CLI裝好了只是第一步，必須啟動Gateway服務，才能正常使用所有功能，步驟很簡單，全程一條命令搞定。

在PowerShell中輸入啟動命令：

openclaw gateway start

啟動成功后，終端通常會顯示“Gateway running at http://localhost:3333”，說明Gateway服務已經正常啟動了，只要看到這個提示，就可以進行下一步了。

補充一句：如果希望Gateway服務開機自動啟動（不用每次手動輸入命令），可以輸入下面這行命令，系統會自動創建Windows計劃任務，實現開機自啟：

openclaw gateway install

適合經常用OpenClaw的朋友，懶人福音，不用每次開機都手動啟動服務。

五、訪問Web控制臺（可視化操作，新手友好）

啟動Gateway服務后，就可以通過瀏覽器訪問OpenClaw的Web控制臺了，不用記復雜的命令，可視化操作，非常適合新手，步驟超簡單：

打開你電腦上的任意瀏覽器（Edge、Chrome、QQ瀏覽器都可以），在地址欄輸入下面的地址，按回車：

http://localhost:3333

進入Web控制臺后，你就可以輕松操作這些功能，實現AI自動化：

• 創建屬于自己的AI Agent（根據需求設置自動化任務）

• 運行自動化任務（比如批量處理文件、生成代碼、整理數據）

• 查看運行日志（遇到問題可以在這里排查原因）

• 管理workspace（存放任務數據、生成的文件等）

如果打開頁面顯示“無法訪問此網站”，別慌，先檢查Gateway服務是否在運行，重新輸入啟動命令即可，大概率是服務沒啟動成功。

六、OpenClaw默認目錄結構（了解即可，方便后續維護）

安裝完成后，系統會在你的用戶目錄下自動創建一個配置目錄，了解這些目錄的作用，后續遇到問題（比如修改配置、排查日志）會更方便，不用到處找文件。

主要目錄：C:\Users\用戶名\.openclaw（“用戶名”替換成你自己電腦的用戶名，比如C:\Users\Admin\.openclaw）

這個目錄里面包含4個核心文件夾，作用給大家整理清楚了，一看就懂，不用記：

不用特意去修改這些目錄，了解它們的作用，后續需要修改配置、排查問題時，能快速找到對應文件就好。

七、配置大模型（關鍵步驟！沒這步用不了AI功能）

重點提醒：OpenClaw本身不包含任何大模型，只是一個AI Agent框架，想要實現自動化任務，必須連接大模型——要么用本地模型（完全離線，隱私性強），要么用云端API模型（能力更強，需要聯網），下面分別教大家配置，新手推薦先試本地模型。

八、配置本地大模型（推薦，完全本地運行，不用聯網）

如果不想依賴云端，想完全本地運行AI，保護數據隱私，推薦使用Ollama（輕量級本地模型工具，Windows能直接裝，操作簡單），全程4步搞定，跟著做就好。

1. 安裝Ollama

直接去Ollama官方網站下載，找到Windows版本的安裝包，雙擊安裝，一路下一步，不用修改任何設置，安裝完成后自動啟動。

安裝完成后，驗證一下是否成功：打開PowerShell，輸入命令：

ollama --version

能顯示版本號，就說明Ollama安裝成功了。

2. 下載本地模型

Ollama安裝完成后，需要下載一個本地大模型（比如Llama3、Qwen2、Mistral），推薦新手先下載Llama3，體積適中，性能穩定，輸入命令：

ollama pull llama3

如果想下載其他模型，也可以輸入：

ollama pull qwen2ollama pull mistral

下載速度根據你的網絡情況，耐心等一會兒，下載完成后會自動保存到本地。

3. 啟動模型服務

模型下載完成后，需要啟動Ollama的API服務，這樣OpenClaw才能連接到本地模型，輸入命令：

ollama serve

啟動成功后，默認的API地址是：http://localhost:11434，不用修改，記住這個地址，后面配置要用。

4. 在OpenClaw中配置模型

這是最后一步，也是最關鍵的一步，配置完成后，OpenClaw就能調用本地模型了：

第一步：找到OpenClaw的配置文件，路徑是：C:\Users\用戶名\.openclaw\config（替換成自己的用戶名）。

第二步：用記事本打開這個config文件，刪除里面的原有內容，復制粘貼下面的配置（注意替換成你下載的模型名稱，比如llama3）：

{"model": {"provider": "ollama","endpoint": "http://localhost:11434","model": "llama3"}

第三步：保存文件，關閉記事本，然后重啟Gateway服務，讓配置生效，輸入命令：

openclaw gateway restart

重啟成功后，OpenClaw就已經成功連接本地大模型了，接下來就可以測試AI Agent了。

九、配置云端大模型（OpenAI API，能力更強）

如果覺得本地模型性能不夠，想獲得更強的AI能力（比如更精準的代碼生成、更智能的數據分析），可以接入云端模型，這里以OpenAI API為例，步驟也很簡單。

1. 獲取OpenAI API Key

首先去OpenAI官方平臺，注冊并登錄賬號，找到API Key（具體獲取方法可以搜“OpenAI API Key獲取教程”，很簡單），復制你的API Key，保存好，后面要用。

2. 設置環境變量

打開PowerShell，輸入下面的命令，設置環境變量（替換成你自己的API Key）：

setx OPENAI_API_KEY "你的APIKey"

輸入完成后，按回車，提示“成功設置環境變量”即可。

3. 修改OpenClaw配置文件

打開OpenClaw的配置文件（C:\Users\用戶名\.openclaw\config），刪除原有內容，復制粘貼下面的配置：

{"model": {"provider": "openai","model": "gpt-4o-mini"}

保存文件，然后重啟Gateway服務，輸入命令：

openclaw gateway restart

重啟成功后，OpenClaw就可以調用OpenAI的云端模型了，聯網狀態下就能使用更強的AI功能。

十、測試AI Agent（實操演示，快速上手）

配置好大模型后，我們來實操一下，運行一個簡單的任務，感受一下OpenClaw的自動化功能，新手也能輕松操作，兩種方法任選其一。

方法一：直接運行單個任務，在PowerShell中輸入：

openclaw run "summarize files in workspace"

這個命令會讓AI Agent自動總結workspace目錄下的所有文件內容，執行完成后，終端會顯示總結結果。

方法二：進入交互模式，和AI Agent對話，輸入：

openclaw chat

進入交互模式后，你可以輸入任意任務，比如“Analyze the documents in workspace”（分析工作空間里的文檔），OpenClaw會自動調用配置好的模型，完成任務后給你反饋。

大家可以多嘗試幾個命令，熟悉一下操作，很快就能上手，真正實現AI自動化。

十一、常見安裝問題（踩坑必看，快速解決，不用到處查）

就算跟著步驟來，也可能會遇到一些小問題，這里整理了4個最常見的報錯，給出具體的解決方法，新手遇到問題直接對照著來，省時又省心。

1. 報錯：openclaw 命令無法識別（最常見）

原因很簡單：安裝完成后，環境變量沒有自動刷新，終端識別不到openclaw命令。

解決方法：不用復雜操作，直接關閉當前的PowerShell，重新打開一個（管理員身份），再輸入openclaw --version，就能識別到了。

2. 報錯：Gateway 無法啟動

大概率是默認端口3333被其他程序占用了，導致Gateway啟動失敗（比如其他軟件也在用3333端口）。

解決方法：第一步，檢查3333端口是否被占用，輸入命令：

netstat -ano | findstr 3333

終端會顯示占用端口的進程ID，然后打開任務管理器，找到對應ID的進程，結束進程，再重新啟動Gateway服務即可。

3. 報錯：Ollama 無法連接，本地模型調用失敗

原因：Ollama的API服務沒有啟動，或者啟動失敗，導致OpenClaw連接不上。

解決方法：第一步，檢查Ollama API是否在運行，打開瀏覽器輸入：http://localhost:11434，如果無法訪問，說明服務沒啟動。

第二步，重新啟動Ollama服務，輸入命令：ollama serve，啟動成功后，再重啟OpenClaw Gateway服務即可。

4. 報錯：模型響應慢，執行任務卡頓

主要原因：本地模型計算量大，電腦配置不夠（比如CPU、GPU性能不足），尤其是運行大型模型時，卡頓會更明顯。

解決方案（3選1）：

• 換更小的本地模型（比如qwen2:0.5b，體積小，運行更快）；

• 升級電腦GPU（如果經常用本地模型，建議升級，運行速度會提升很多）；

• 改用云端API模型（OpenAI API，響應速度快，不用依賴本地配置）。

十二、升級OpenClaw（后續更新，簡單操作）

OpenClaw會不斷更新新功能、修復bug，后續如果想升級到最新版本，有兩種簡單方法，二選一即可，不用重新安裝整個環境。

方法一：通過npm升級，在PowerShell中輸入：

npm update -g openclaw

方法二：重新運行官方安裝腳本，自動更新到最新版本，輸入：

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

兩種方法都很簡單，升級完成后，輸入openclaw --version，就能看到最新的版本號了。

? 總結（重點劃重點，記不住就看這里）

其實在Windows上安裝、配置OpenClaw，一點都不復雜，不用羨慕蘋果用戶，核心就是5個步驟，抓好這5步，就能一次成功，避開所有坑：

1. 安裝環境：裝Node 18/20，推薦裝nvm-windows避免版本沖突；

2. 安裝CLI：用管理員身份打開PowerShell，運行官方一鍵安裝腳本；

3. 啟動服務：輸入命令啟動Gateway后臺服務，可選設置開機自啟；

4. 配置模型：選本地模型（Ollama）或云端模型（OpenAI API），修改配置文件；

5. 實操上手：運行簡單任務，測試AI Agent，熟悉操作。

完成以上步驟后，你就擁有了一套本地AI Agent自動化系統，不管是自動化文件處理、代碼生成，還是數據整理、本地AI工作流，都能輕松實現，不用依賴蘋果設備，Windows用戶也能玩轉OpenClaw！