無蘋果設(shè)備也能養(yǎng)龍蝦？Windows養(yǎng)龍蝦全教程在這里！

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

node -vnpm -v

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

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

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

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

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

nvm install 20nvm use 20

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

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

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

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

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

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

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

• 安裝OpenClaw CLI核心工具

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

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

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

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

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

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

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

openclaw --version

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

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

openclaw help

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

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

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

在PowerShell中輸入啟動命令：

openclaw gateway start

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

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

openclaw gateway install

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

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

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

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

http://localhost:3333

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. 安裝Ollama

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

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

ollama --version

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

2. 下載本地模型

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

ollama pull llama3

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

ollama pull qwen2ollama pull mistral

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

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

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

ollama serve

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

4. 在OpenClaw中配置模型

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

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

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

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

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

openclaw gateway restart

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

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

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

1. 獲取OpenAI API Key

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

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

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

setx OPENAI_API_KEY "你的APIKey"

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

3. 修改OpenClaw配置文件

打開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功能。

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

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

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

openclaw run "summarize files in workspace"

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

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

openclaw chat

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

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

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

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

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

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

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

2. 報錯：Gateway 無法啟動

大概率是默認(rèn)端口3333被其他程序占用了，導(dǎo)致Gateway啟動失?。ū热缙渌浖苍谟?333端口）。

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

netstat -ano | findstr 3333

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

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

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

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

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

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

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

解決方案（3選1）：

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

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

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

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

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

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

npm update -g openclaw

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

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

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

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

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

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

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

3. 啟動服務(wù)：輸入命令啟動Gateway后臺服務(wù)，可選設(shè)置開機(jī)自啟；

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

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

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