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

但很多人都有一個(gè)共同的困擾：看了不少安裝教程，全是針對(duì)蘋果Mac的，自己只有Windows電腦，以為沒(méi)機(jī)會(huì)用，要么跟風(fēng)裝卻頻頻翻車，要么直接放棄。其實(shí)根本不用愁！現(xiàn)在Windows系統(tǒng)也能輕松安裝OpenClaw，全程不用復(fù)雜操作，新手也能一次成功。

不過(guò)實(shí)話實(shí)說(shuō)，Windows上部署OpenClaw，確實(shí)比Mac容易遇到幾個(gè)小問(wèn)題：比如CLI顯示安裝成功，輸入命令卻沒(méi)反應(yīng)；Gateway服務(wù)死活啟動(dòng)不了；好不容易裝完，卻連不上本地大模型；甚至調(diào)用API模型時(shí)直接報(bào)錯(cuò)，越裝越煩躁。

今天這篇深度教程，就從零基礎(chǔ)開(kāi)始，一步步教你在Windows上安裝、配置OpenClaw，從環(huán)境準(zhǔn)備到啟動(dòng)服務(wù)，從配置大模型到測(cè)試AI Agent，把所有常見(jiàn)坑都提前避開(kāi)，全程保姆級(jí)講解，就算你是電腦小白，跟著做也能順利用上本地AI自動(dòng)化工具！

一、安裝前環(huán)境準(zhǔn)備（必做！少一步都可能報(bào)錯(cuò)）

Windows上安裝OpenClaw，前期環(huán)境準(zhǔn)備比安裝本身更重要——很多人安裝失敗，不是步驟錯(cuò)了，而是環(huán)境沒(méi)搭好。大家跟著下面的步驟來(lái)，一步都別省，就能避開(kāi)80%的坑。

1. 確認(rèn)Windows系統(tǒng)版本

首先先檢查一下自己的Windows版本，老系統(tǒng)兼容性太差，容易出現(xiàn)各種報(bào)錯(cuò)，建議大家滿足以下要求：

? 推薦系統(tǒng)：Windows 10 或 Windows 11（親測(cè)這兩個(gè)版本最穩(wěn)定，Win7及以下不建議嘗試）

? 額外建議：開(kāi)啟 PowerShell 7（推薦，比系統(tǒng)自帶的PowerShell更穩(wěn)定）、Windows Terminal（操作更方便，可選）

不用特意去升級(jí)系統(tǒng)，只要是Win10或Win11，基本都能正常安裝，重點(diǎn)是后面的Node環(huán)境。

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

OpenClaw的CLI工具是基于Node.js運(yùn)行的，沒(méi)有Node環(huán)境，根本裝不了，這是最基礎(chǔ)也是最容易出錯(cuò)的一步，大家一定要重視。

? 推薦Node版本：Node 18 或 Node 20（這兩個(gè)版本和OpenClaw兼容性最好，親測(cè)不會(huì)出現(xiàn)報(bào)錯(cuò)）

下載方法很簡(jiǎn)單，直接去Node.js官方網(wǎng)站下載，找到對(duì)應(yīng)版本（Windows系統(tǒng)，根據(jù)自己電腦是32位還是64位選擇），下載后雙擊安裝，一路下一步就好，不用特意修改安裝路徑（默認(rèn)路徑就可以）。

安裝完成后，驗(yàn)證一下是否成功：打開(kāi)PowerShell（或Windows Terminal），輸入下面兩個(gè)命令，按回車：

node -vnpm -v

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

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

這一步不是必須的，但非常推薦！如果你的電腦里裝了多個(gè)Node版本，或者以后需要切換Node版本，很容易和OpenClaw需要的版本沖突，導(dǎo)致CLI運(yùn)行報(bào)錯(cuò)、Gateway啟動(dòng)失敗。

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

安裝完成后，打開(kāi)PowerShell，輸入下面的命令，安裝并切換到Node 20版本（最穩(wěn)定）：

nvm install 20nvm use 20

切換完成后，再輸入node -v，確認(rèn)版本是20.x.x，這樣后續(xù)運(yùn)行OpenClaw就不會(huì)出現(xiàn)版本沖突的問(wèn)題了。

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

環(huán)境準(zhǔn)備好后，就可以正式安裝OpenClaw了，官方提供了Windows專屬的安裝腳本，不用手動(dòng)操作復(fù)雜步驟，新手也能輕松上手，重點(diǎn)注意：一定要用管理員身份打開(kāi)PowerShell！

第一步：打開(kāi)PowerShell（管理員）——在開(kāi)始菜單搜“PowerShell”，右鍵選擇“以管理員身份運(yùn)行”，別直接打開(kāi)普通PowerShell，否則會(huì)報(bào)錯(cuò)（權(quán)限不足）。

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

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

執(zhí)行命令后，系統(tǒng)會(huì)自動(dòng)開(kāi)始安裝，不用管它，等待1-2分鐘就好（根據(jù)電腦配置，速度會(huì)有差異）。這個(gè)腳本會(huì)自動(dòng)完成以下操作，不用你手動(dòng)干預(yù)：

• 安裝OpenClaw CLI核心工具

• 自動(dòng)創(chuàng)建用戶配置目錄

• 初始化Gateway后臺(tái)服務(wù)

• 設(shè)置環(huán)境變量（保證終端能識(shí)別openclaw命令）

當(dāng)終端顯示類似“OpenClaw installed successfully”（OpenClaw安裝成功）的提示，就說(shuō)明CLI已經(jīng)裝好了，下一步就是驗(yàn)證安裝是否成功。

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

安裝完成后，別著急啟動(dòng)服務(wù)，先驗(yàn)證一下CLI是否能正常使用，避免后續(xù)啟動(dòng)失敗又要回頭排查，步驟很簡(jiǎn)單：

在PowerShell中輸入下面這行命令，檢查版本號(hào)：

openclaw --version

如果終端返回類似“OpenClaw CLI v1.x.x”的版本號(hào)，說(shuō)明安裝成功了；如果提示“命令不是內(nèi)部或外部命令”，別慌，后面常見(jiàn)問(wèn)題里會(huì)講解決方法。

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

openclaw help

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

四、啟動(dòng)OpenClaw Gateway服務(wù)（后臺(tái)核心，必須啟動(dòng)）

OpenClaw在Windows上是通過(guò)Gateway后臺(tái)服務(wù)運(yùn)行AI Agent的，CLI裝好了只是第一步，必須啟動(dòng)Gateway服務(wù)，才能正常使用所有功能，步驟很簡(jiǎn)單，全程一條命令搞定。

在PowerShell中輸入啟動(dòng)命令：

openclaw gateway start

啟動(dòng)成功后，終端通常會(huì)顯示“Gateway running at http://localhost:3333”，說(shuō)明Gateway服務(wù)已經(jīng)正常啟動(dòng)了，只要看到這個(gè)提示，就可以進(jìn)行下一步了。

補(bǔ)充一句：如果希望Gateway服務(wù)開(kāi)機(jī)自動(dòng)啟動(dòng)（不用每次手動(dòng)輸入命令），可以輸入下面這行命令，系統(tǒng)會(huì)自動(dòng)創(chuàng)建Windows計(jì)劃任務(wù)，實(shí)現(xiàn)開(kāi)機(jī)自啟：

openclaw gateway install

適合經(jīng)常用OpenClaw的朋友，懶人福音，不用每次開(kāi)機(jī)都手動(dòng)啟動(dòng)服務(wù)。

五、訪問(wèn)Web控制臺(tái)（可視化操作，新手友好）

啟動(dòng)Gateway服務(wù)后，就可以通過(guò)瀏覽器訪問(wèn)OpenClaw的Web控制臺(tái)了，不用記復(fù)雜的命令，可視化操作，非常適合新手，步驟超簡(jiǎn)單：

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

http://localhost:3333

進(jìn)入Web控制臺(tái)后，你就可以輕松操作這些功能，實(shí)現(xiàn)AI自動(dòng)化：

• 創(chuàng)建屬于自己的AI Agent（根據(jù)需求設(shè)置自動(dòng)化任務(wù)）

• 運(yùn)行自動(dòng)化任務(wù)（比如批量處理文件、生成代碼、整理數(shù)據(jù)）

• 查看運(yùn)行日志（遇到問(wèn)題可以在這里排查原因）

• 管理workspace（存放任務(wù)數(shù)據(jù)、生成的文件等）

如果打開(kāi)頁(yè)面顯示“無(wú)法訪問(wèn)此網(wǎng)站”，別慌，先檢查Gateway服務(wù)是否在運(yùn)行，重新輸入啟動(dòng)命令即可，大概率是服務(wù)沒(méi)啟動(dòng)成功。

六、OpenClaw默認(rèn)目錄結(jié)構(gòu)（了解即可，方便后續(xù)維護(hù)）

安裝完成后，系統(tǒng)會(huì)在你的用戶目錄下自動(dòng)創(chuàng)建一個(gè)配置目錄，了解這些目錄的作用，后續(xù)遇到問(wèn)題（比如修改配置、排查日志）會(huì)更方便，不用到處找文件。

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

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

不用特意去修改這些目錄，了解它們的作用，后續(xù)需要修改配置、排查問(wèn)題時(shí)，能快速找到對(duì)應(yīng)文件就好。

七、配置大模型（關(guān)鍵步驟！沒(méi)這步用不了AI功能）

重點(diǎn)提醒：OpenClaw本身不包含任何大模型，只是一個(gè)AI Agent框架，想要實(shí)現(xiàn)自動(dòng)化任務(wù)，必須連接大模型——要么用本地模型（完全離線，隱私性強(qiáng)），要么用云端API模型（能力更強(qiáng)，需要聯(lián)網(wǎng)），下面分別教大家配置，新手推薦先試本地模型。

八、配置本地大模型（推薦，完全本地運(yùn)行，不用聯(lián)網(wǎng)）

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

1. 安裝Ollama

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

安裝完成后，驗(yàn)證一下是否成功：打開(kāi)PowerShell，輸入命令：

ollama --version

能顯示版本號(hào)，就說(shuō)明Ollama安裝成功了。

2. 下載本地模型

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

ollama pull llama3

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

ollama pull qwen2ollama pull mistral

下載速度根據(jù)你的網(wǎng)絡(luò)情況，耐心等一會(huì)兒，下載完成后會(huì)自動(dòng)保存到本地。

3. 啟動(dòng)模型服務(wù)

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

ollama serve

啟動(dòng)成功后，默認(rèn)的API地址是：http://localhost:11434，不用修改，記住這個(gè)地址，后面配置要用。

4. 在OpenClaw中配置模型

這是最后一步，也是最關(guān)鍵的一步，配置完成后，OpenClaw就能調(diào)用本地模型了：

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

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

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

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

openclaw gateway restart

重啟成功后，OpenClaw就已經(jīng)成功連接本地大模型了，接下來(lái)就可以測(cè)試AI Agent了。

九、配置云端大模型（OpenAI API，能力更強(qiáng)）

如果覺(jué)得本地模型性能不夠，想獲得更強(qiáng)的AI能力（比如更精準(zhǔn)的代碼生成、更智能的數(shù)據(jù)分析），可以接入云端模型，這里以O(shè)penAI API為例，步驟也很簡(jiǎn)單。

1. 獲取OpenAI API Key

首先去OpenAI官方平臺(tái)，注冊(cè)并登錄賬號(hào)，找到API Key（具體獲取方法可以搜“OpenAI API Key獲取教程”，很簡(jiǎn)單），復(fù)制你的API Key，保存好，后面要用。

2. 設(shè)置環(huán)境變量

打開(kāi)PowerShell，輸入下面的命令，設(shè)置環(huán)境變量（替換成你自己的API Key）：

setx OPENAI_API_KEY "你的APIKey"

輸入完成后，按回車，提示“成功設(shè)置環(huán)境變量”即可。

3. 修改OpenClaw配置文件

打開(kāi)OpenClaw的配置文件（C:\Users\用戶名\.openclaw\config），刪除原有內(nèi)容，復(fù)制粘貼下面的配置：

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

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

openclaw gateway restart

重啟成功后，OpenClaw就可以調(diào)用OpenAI的云端模型了，聯(lián)網(wǎng)狀態(tài)下就能使用更強(qiáng)的AI功能。

十、測(cè)試AI Agent（實(shí)操演示，快速上手）

配置好大模型后，我們來(lái)實(shí)操一下，運(yùn)行一個(gè)簡(jiǎn)單的任務(wù)，感受一下OpenClaw的自動(dòng)化功能，新手也能輕松操作，兩種方法任選其一。

方法一：直接運(yùn)行單個(gè)任務(wù)，在PowerShell中輸入：

openclaw run "summarize files in workspace"

這個(gè)命令會(huì)讓AI Agent自動(dòng)總結(jié)workspace目錄下的所有文件內(nèi)容，執(zhí)行完成后，終端會(huì)顯示總結(jié)結(jié)果。

方法二：進(jìn)入交互模式，和AI Agent對(duì)話，輸入：

openclaw chat

進(jìn)入交互模式后，你可以輸入任意任務(wù)，比如“Analyze the documents in workspace”（分析工作空間里的文檔），OpenClaw會(huì)自動(dòng)調(diào)用配置好的模型，完成任務(wù)后給你反饋。

大家可以多嘗試幾個(gè)命令，熟悉一下操作，很快就能上手，真正實(shí)現(xiàn)AI自動(dòng)化。

十一、常見(jiàn)安裝問(wèn)題（踩坑必看，快速解決，不用到處查）

就算跟著步驟來(lái)，也可能會(huì)遇到一些小問(wèn)題，這里整理了4個(gè)最常見(jiàn)的報(bào)錯(cuò)，給出具體的解決方法，新手遇到問(wèn)題直接對(duì)照著來(lái)，省時(shí)又省心。

1. 報(bào)錯(cuò)：openclaw 命令無(wú)法識(shí)別（最常見(jiàn)）

原因很簡(jiǎn)單：安裝完成后，環(huán)境變量沒(méi)有自動(dòng)刷新，終端識(shí)別不到openclaw命令。

解決方法：不用復(fù)雜操作，直接關(guān)閉當(dāng)前的PowerShell，重新打開(kāi)一個(gè)（管理員身份），再輸入openclaw --version，就能識(shí)別到了。

2. 報(bào)錯(cuò)：Gateway 無(wú)法啟動(dòng)

大概率是默認(rèn)端口3333被其他程序占用了，導(dǎo)致Gateway啟動(dòng)失敗（比如其他軟件也在用3333端口）。

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

netstat -ano | findstr 3333

終端會(huì)顯示占用端口的進(jìn)程ID，然后打開(kāi)任務(wù)管理器，找到對(duì)應(yīng)ID的進(jìn)程，結(jié)束進(jìn)程，再重新啟動(dòng)Gateway服務(wù)即可。

3. 報(bào)錯(cuò)：Ollama 無(wú)法連接，本地模型調(diào)用失敗

原因：Ollama的API服務(wù)沒(méi)有啟動(dòng)，或者啟動(dòng)失敗，導(dǎo)致OpenClaw連接不上。

解決方法：第一步，檢查Ollama API是否在運(yùn)行，打開(kāi)瀏覽器輸入：http://localhost:11434，如果無(wú)法訪問(wèn)，說(shuō)明服務(wù)沒(méi)啟動(dòng)。

第二步，重新啟動(dòng)Ollama服務(wù)，輸入命令：ollama serve，啟動(dòng)成功后，再重啟OpenClaw Gateway服務(wù)即可。

4. 報(bào)錯(cuò)：模型響應(yīng)慢，執(zhí)行任務(wù)卡頓

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

解決方案（3選1）：

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

• 升級(jí)電腦GPU（如果經(jīng)常用本地模型，建議升級(jí)，運(yùn)行速度會(huì)提升很多）；

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

十二、升級(jí)OpenClaw（后續(xù)更新，簡(jiǎn)單操作）

OpenClaw會(huì)不斷更新新功能、修復(fù)bug，后續(xù)如果想升級(jí)到最新版本，有兩種簡(jiǎn)單方法，二選一即可，不用重新安裝整個(gè)環(huán)境。

方法一：通過(guò)npm升級(jí)，在PowerShell中輸入：

npm update -g openclaw

方法二：重新運(yùn)行官方安裝腳本，自動(dòng)更新到最新版本，輸入：

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

兩種方法都很簡(jiǎn)單，升級(jí)完成后，輸入openclaw --version，就能看到最新的版本號(hào)了。

? 總結(jié)（重點(diǎn)劃重點(diǎn)，記不住就看這里）

其實(shí)在Windows上安裝、配置OpenClaw，一點(diǎn)都不復(fù)雜，不用羨慕蘋果用戶，核心就是5個(gè)步驟，抓好這5步，就能一次成功，避開(kāi)所有坑：

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

2. 安裝CLI：用管理員身份打開(kāi)PowerShell，運(yùn)行官方一鍵安裝腳本；

3. 啟動(dòng)服務(wù)：輸入命令啟動(dòng)Gateway后臺(tái)服務(wù)，可選設(shè)置開(kāi)機(jī)自啟；

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

5. 實(shí)操上手：運(yùn)行簡(jiǎn)單任務(wù)，測(cè)試AI Agent，熟悉操作。

完成以上步驟后，你就擁有了一套本地AI Agent自動(dòng)化系統(tǒng)，不管是自動(dòng)化文件處理、代碼生成，還是數(shù)據(jù)整理、本地AI工作流，都能輕松實(shí)現(xiàn)，不用依賴蘋果設(shè)備，Windows用戶也能玩轉(zhuǎn)OpenClaw！