C 盤(pán)爆紅這件事我已經(jīng)不是第一次經(jīng)歷了。這次為了把 openclaw 的本地開(kāi)發(fā)環(huán)境完整跑起來(lái)我又被 WSL2 的虛擬磁盤(pán)折磨了一回最后不得不把整個(gè) WSL2 發(fā)行版從 C 盤(pán)搬遷到 D 盤(pán)順手裝上了 Node.js 24才終于把環(huán)境穩(wěn)定下來(lái)。如果你也在折騰 openclaw同時(shí)對(duì) C 盤(pán)空間告急這件事非常頭疼那么這篇文章應(yīng)該能幫你少走很多彎路。先說(shuō)下背景。openclaw 是一個(gè)偏個(gè)人工作流方向的開(kāi)源智能助手框架核心思路是用 Node.js 把本地筆記、聊天應(yīng)用、任務(wù)工具串起來(lái)讓它們之間可以互相觸發(fā)。它不是一個(gè)單純聊天的“殼子”更像是一個(gè)事件驅(qū)動(dòng)的自動(dòng)化中樞可以接 Microsoft Teams、Obsidian也能自己定義技能和工作流。因?yàn)樯婕按罅慨惒绞录?、WebSocket 長(zhǎng)連接和本地文件監(jiān)聽(tīng)它需要一個(gè)真正的 Linux 環(huán)境一個(gè)較新的 Node.js 運(yùn)行時(shí)最好還能用 systemd 或進(jìn)程守護(hù)工具讓服務(wù)穩(wěn)定常駐。這三樣?xùn)|西正好是 WSL2 的強(qiáng)項(xiàng)。1. 為什么非搬不可C 盤(pán)空間與 WSL2 的那些賬1.1 openclaw 是個(gè)什么項(xiàng)目為什么值得本地折騰openclaw 跟很多現(xiàn)成的 AI 助手項(xiàng)目不一樣它不提供一套固定功能的客戶端而是給你一整套可以自定義的“工作流骨架”。你在配置里聲明好觸發(fā)條件比如“Teams 收到某個(gè)關(guān)鍵詞的消息”或者“Obsidian 里新生成了一篇筆記”openclaw 就會(huì)把這些事件拉起來(lái)按你預(yù)設(shè)的流程去執(zhí)行可能調(diào)用一個(gè)本地腳本也可能調(diào)用外部 API再把結(jié)果通過(guò) Teams 或筆記插件返回。這種依賴(lài)事件驅(qū)動(dòng)的架構(gòu)對(duì)運(yùn)行環(huán)境的要求很明確文件系統(tǒng)事件監(jiān)聽(tīng)要可靠網(wǎng)絡(luò)端口要能穩(wěn)定監(jiān)聽(tīng)如果涉及并發(fā)任務(wù)調(diào)度還需要運(yùn)行時(shí)對(duì)異步 IO 支持得好。在 Windows 上文件監(jiān)聽(tīng)事件丟失是出了名的老大難權(quán)限模型也經(jīng)常讓 Node.js 項(xiàng)目在讀取某些目錄時(shí)報(bào)錯(cuò)。我在 PowerShell 里部署過(guò)一次項(xiàng)目能啟動(dòng)但 Obsidian 文件觸發(fā)經(jīng)常延遲甚至不觸發(fā)后來(lái)切到 WSL2 之后問(wèn)題基本消失。原因很簡(jiǎn)單openclaw 對(duì) Linux 原生文件系統(tǒng)和 Node.js 的fs.watch依賴(lài)太深Windows 的文件系統(tǒng)事件模型跟 Linux 有很大差異這種項(xiàng)目天然生存在 Linux 環(huán)境里更合適。1.2 C 盤(pán)被吃掉的“罪魁禍?zhǔn)住辈⒉恢挥性创a很多朋友以為 C 盤(pán)空間不足是源碼工程太大其實(shí)源碼加依賴(lài)也就幾百 MB 到 1GB 左右真正的空間黑洞往往藏在下面幾處WSL2 的虛擬磁盤(pán)文件也就是ext4.vhdx。它掛在%LOCALAPPDATA%\Packages\...\LocalState\下面會(huì)隨著發(fā)行版里安裝的軟件、日志、容器鏡像持續(xù)增長(zhǎng)。我裝完 openclaw 的各種依賴(lài)和構(gòu)建工具后這個(gè)文件一度膨脹到 30 多 GB。Node.js 的 npm 全局緩存。npm 默認(rèn)把緩存放在用戶目錄而 WSL2 的用戶目錄在發(fā)行版虛擬磁盤(pán)內(nèi)部等于還是在 C 盤(pán)。Docker Desktop 的數(shù)據(jù)。WSL2 里跑 Docker 容器、拉鏡像、存儲(chǔ)數(shù)據(jù)默認(rèn)也都塞在虛擬磁盤(pán)里。openclaw 運(yùn)行時(shí)的日志、臨時(shí)文件、本地向量數(shù)據(jù)。這部分增量不大但日積月累也挺可觀。把這些加起來(lái)一個(gè)看似輕量的開(kāi)發(fā)環(huán)境吃 40GB 一點(diǎn)不夸張。對(duì)系統(tǒng)盤(pán)不寬裕的人唯一的靠譜方案就是把整個(gè) WSL2 發(fā)行版遷走然后把各類(lèi)緩存路徑也重新規(guī)劃到 D 盤(pán)。1.3 為什么選 WSL2而不是虛擬機(jī)或者純 Windows 方案有人可能問(wèn)既然要占空間為什么不用 Windows 自帶的 Hyper-V 虛擬機(jī)或者 VirtualBox傳統(tǒng)虛擬機(jī)要給整個(gè)系統(tǒng)留固定大小的磁盤(pán)鏡像啟動(dòng)一個(gè)完整 Linux 桌面對(duì)內(nèi)存和 CPU 開(kāi)銷(xiāo)都很大日常使用太笨重。WSL2 不一樣它共享 Windows 的內(nèi)核服務(wù)和文件系統(tǒng)橋接啟動(dòng)一個(gè)發(fā)行版就跟打開(kāi)一個(gè)終端一樣快內(nèi)存占用也遠(yuǎn)低于一整個(gè)虛擬機(jī)。而對(duì) openclaw 來(lái)說(shuō)WSL2 提供的 Linux 內(nèi)核已經(jīng)足夠跑 Node.js 服務(wù)、監(jiān)聽(tīng)端口、操作文件系統(tǒng)省掉的復(fù)雜度反而能讓環(huán)境更清爽。最終方案也就確定下來(lái)Windows 做桌面openclaw 的開(kāi)發(fā)運(yùn)行環(huán)境全部放進(jìn) WSL2再把 WSL2 的虛擬磁盤(pán)從 C 盤(pán)遷到 D 盤(pán)。這樣系統(tǒng)盤(pán)不再吃緊又能享受完整的 Linux 生態(tài)。下面就從搬遷開(kāi)始一步步來(lái)。2. WSL2 發(fā)行版搬遷實(shí)操?gòu)?C 盤(pán)挪到 D 盤(pán)2.1 搬遷前先摸清底細(xì)先別急著搬搞清楚現(xiàn)狀再說(shuō)。打開(kāi) Windows Terminal 或 PowerShell執(zhí)行wsl --list --verbose這會(huì)列出你當(dāng)前安裝的所有發(fā)行版名字后面帶 * 的是默認(rèn)發(fā)行版VERSION 一列會(huì)顯示當(dāng)前是 WSL1 還是 WSL2。如果你之前裝過(guò)一個(gè)舊的 Ubuntu還在 WSL1 模式建議先手動(dòng)升級(jí)到 WSL2 再遷移避免后面出現(xiàn)版本混亂的問(wèn)題。VERSION 確認(rèn)之后再找到 ext4.vhdx 的實(shí)際位置。打開(kāi)文件資源管理器進(jìn)入%LOCALAPPDATA%\Packages\CanonicalGroupLimited.Ubuntu..._*\LocalState\不同發(fā)行版的 PackageFamilyName 會(huì)不一樣找類(lèi)似 “Ubuntu” 或 “Debian” 的目錄就行。里面的ext4.vhdx就是完整虛擬磁盤(pán)右鍵看屬性就知道它占了多少空間。這一步一定要做因?yàn)閮H憑“我感覺(jué)沒(méi)裝多少東西”來(lái)判斷往往會(huì)漏掉已經(jīng)膨脹到幾十 GB 的鏡像。另外如果發(fā)行版里已經(jīng)跑了 openclaw記得提前把配置目錄、工作數(shù)據(jù)、.env文件額外復(fù)制一份到 D 盤(pán)。export tar 包雖然會(huì)包含全部數(shù)據(jù)但多做一道手工備份遷移時(shí)心里踏實(shí)很多。2.2 export / import 三步遷移法WSL2 的官方遷移方式是“導(dǎo)出再導(dǎo)入”不能直接把 vhdx 文件復(fù)制到 D 盤(pán)。直接復(fù)制會(huì)導(dǎo)致 WSL 不認(rèn)這個(gè)路徑還可能在下次啟動(dòng)時(shí)損壞發(fā)行版。正確流程分三步走。第一步關(guān)閉所有 WSL 會(huì)話。在 PowerShell 里執(zhí)行wsl --shutdown第二步導(dǎo)出發(fā)行版。以默認(rèn)的 Ubuntu 為例wsl --export Ubuntu D:\wsl-backup\ubuntu-full.tar如果你發(fā)行版不叫 Ubuntu先通過(guò)wsl --list查實(shí)際名字。導(dǎo)出過(guò)程根據(jù) vhdx 大小可能要幾分鐘到十幾分鐘期間別亂開(kāi) WSL 窗口也別把這個(gè) PowerShell 關(guān)掉。第三步注銷(xiāo)原發(fā)行版釋放 C 盤(pán)空間wsl --unregister Ubuntu這一步會(huì)從已安裝列表里移除 Ubuntu 并刪除 C 盤(pán)上的 vhdx。請(qǐng)務(wù)必定確認(rèn)上一步的 tar 包已經(jīng)完整導(dǎo)出。我第一次遷移時(shí)就是因?yàn)?tar 還沒(méi)導(dǎo)完就取消命令好在原發(fā)行版還在沒(méi)造成數(shù)據(jù)丟失。第二次老老實(shí)實(shí)等導(dǎo)出完成也沒(méi)花太久畢竟一次性把 30 多 GB 搬走才安逸。注銷(xiāo)之后在 D 盤(pán)創(chuàng)建目標(biāo)目錄例如D:\wsl\Ubuntu再執(zhí)行導(dǎo)入wsl --import Ubuntu D:\wsl\Ubuntu D:\wsl-backup\ubuntu-full.tar --version 2這個(gè)命令有兩個(gè)路徑第一個(gè)是將來(lái) vhdx 的存放位置第二個(gè)是剛才導(dǎo)出的 tar 包。導(dǎo)入完成后用wsl --list --verbose檢查Ubuntu 的 VERSION 應(yīng)該顯示 2。到這里發(fā)行版主體已經(jīng)從 C 盤(pán)挪到 D 盤(pán)了。2.3 遷移后必做的三件事遷移完不是直接開(kāi)干有三件事必須做否則后面大概率會(huì)踩坑。第一件解決默認(rèn)用戶問(wèn)題。export / import 之后默認(rèn)登錄用戶會(huì)變成 root。如果一直用 root 操作后面 openclaw 創(chuàng)建的文件、Obsidian 插件生成的緩存權(quán)限會(huì)全部變成 root 所有普通用戶再想去改就很麻煩。解決辦法是先啟動(dòng)一次 Ubuntu然后用命令設(shè)置默認(rèn)用戶ubuntu.exe config --default-user 你的用戶名更通用的方式是在 WSL 內(nèi)編輯/etc/wsl.conf[user] default你的用戶名然后從 Windows 執(zhí)行wsl --shutdown再重新進(jìn)入 WSL默認(rèn)用戶就恢復(fù)了。第二件檢查文件系統(tǒng)是否正常。執(zhí)行df -h確認(rèn)根目錄掛載點(diǎn)和可用空間沒(méi)有問(wèn)題。第三件檢查 openclaw 源碼和配置路徑有沒(méi)有問(wèn)題。導(dǎo)入后相對(duì)路徑通常不變但如果有 git 子模塊偶爾會(huì)因?yàn)槁窂揭脝?wèn)題失效建議進(jìn)入項(xiàng)目目錄執(zhí)行g(shù)it submodule status看一眼。2.4 順手把緩存目錄也搬到 D 盤(pán)遷完 vhdxC 盤(pán)空間會(huì)釋放一大塊但如果 npm 緩存、Docker Desktop 數(shù)據(jù)還留在默認(rèn)位置后續(xù)還是會(huì)一點(diǎn)一點(diǎn)蠶食系統(tǒng)盤(pán)。建議趁熱打鐵把這些緩存路徑統(tǒng)一規(guī)劃到 D 盤(pán)。npm 緩存可以在 WSL 內(nèi)修改~/.npmrccache/mnt/d/wsl-cache/npm全局包安裝目錄也可以一起改npm config set prefix /mnt/d/npm-globalDocker Desktop 的數(shù)據(jù)目錄需要在 Docker Desktop 設(shè)置里的 Resources 頁(yè)面把 Disk image location 改成 D 盤(pán)路徑。這樣以后 Docker 拉取鏡像和存儲(chǔ)容器數(shù)據(jù)都不再觸碰系統(tǒng)盤(pán)。別小看這一步很多人遷完發(fā)行版結(jié)果 Docker 還在 C 盤(pán)悶頭寫(xiě)入過(guò)兩周又紅了。3. 為什么是 Node.js 24版本選擇與安裝完整流程3.1 openclaw 對(duì) Node.js 版本的隱性要求openclaw 這類(lèi)同時(shí)處理 WebSocket、文件監(jiān)聽(tīng)、任務(wù)調(diào)度的項(xiàng)目對(duì) Node.js 版本其實(shí)相當(dāng)敏感。它內(nèi)部用了不少較新的異步 API 和 stream 行為改進(jìn)在我看來(lái)版本太低確實(shí)會(huì)觸發(fā)各種詭異的運(yùn)行時(shí)錯(cuò)誤。我最初在 WSL2 里用的是 Ubuntu 自帶源里的 Node.js 18跑 openclaw 構(gòu)建腳本時(shí)頻繁遇到依賴(lài)版本不匹配的報(bào)錯(cuò)切換到 Node.js 24 之后立刻安靜了。Node.js 24 目前處于 LTS 維護(hù)周期是當(dāng)前環(huán)境里安全性和穩(wěn)定性都兼顧的版本線。對(duì)本地開(kāi)發(fā)來(lái)說(shuō)它自帶的特性支持、日常性能、調(diào)試體驗(yàn)都足夠好。尤其是事件驅(qū)動(dòng)的服務(wù)Node 24 對(duì)并發(fā)和異步 IO 的調(diào)度優(yōu)化比早期版本明顯更平滑openclaw 這種“多路事件同時(shí)進(jìn)來(lái)”的場(chǎng)景跑起來(lái)更從容。3.2 用 nvm 安裝 Node.js 24在 WSL2 里安裝 Node.js我強(qiáng)烈建議用 nvm而不是直接下載 Linux 安裝包或者用系統(tǒng) apt 源。nvm 允許你在同一個(gè)環(huán)境里隨意切換多個(gè) Node 版本openclaw 以后升級(jí)要求更高版本時(shí)直接nvm install 新版本切過(guò)去就行不用折騰系統(tǒng)級(jí)安裝器。在 Ubuntu 終端里執(zhí)行curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash如果當(dāng)前網(wǎng)絡(luò)環(huán)境訪問(wèn)官方腳本地址不順暢也可以用公共鏡像源下載這份腳本本質(zhì)是一樣的。安裝完成后重開(kāi)終端或者手動(dòng)執(zhí)行source ~/.bashrc然后安裝 Node.js 24nvm install 24 nvm alias default 24 nvm use 24驗(yàn)證版本node -v npm -v如果輸出是 v24 開(kāi)頭的版本號(hào)說(shuō)明安裝成功。此時(shí)用which node確認(rèn)路徑落在 nvm 管理的目錄下不要是/usr/bin/node這種系統(tǒng)路徑否則后續(xù)nvm use切換不會(huì)生效。3.3 corepack 啟用 pnpm并配置依賴(lài)下載速度openclaw 這類(lèi)項(xiàng)目大多使用 pnpm 作為包管理器因?yàn)?pnpm 通過(guò)硬鏈接和內(nèi)容尋址存儲(chǔ)在依賴(lài)樹(shù)很大時(shí)的空間占用和安裝速度都有優(yōu)勢(shì)。Node.js 24 自帶 corepack完全不需要單獨(dú)裝 pnpmcorepack enable corepack prepare pnpmlatest --activate pnpm --version如果 corepack 報(bào)權(quán)限錯(cuò)誤試試用sudo corepack enable或者先把用戶目錄權(quán)限理順。然后設(shè)置 npm 和 pnpm 的鏡像源npm config set registry https://registry.npmmirror.com pnpm config set registry https://registry.npmmirror.com這一步不是必須的但對(duì)國(guó)內(nèi)網(wǎng)絡(luò)環(huán)境來(lái)說(shuō)幾乎等于必做。鏡像源只優(yōu)化下載速度不會(huì)改變依賴(lài)本身的內(nèi)容安裝行為是安全的。4. openclaw 本地部署從拉取代碼到接入 Teams / Obsidian4.1 源碼部署和 Docker 一鍵部署怎么選openclaw 給用戶提供了兩條常見(jiàn)部署路徑一種是本地一鍵部署的 Docker Compose 方式會(huì)自動(dòng)拉起數(shù)據(jù)庫(kù)和運(yùn)行時(shí)另一種是基于源碼的 Node.js 部署方式。Docker 部署省事但你已經(jīng)手動(dòng)搭好了 WSL2 Node.js 24我建議直接用源碼方式部署。源碼部署的好處是調(diào)試方便項(xiàng)目結(jié)構(gòu)一目了然改完代碼重啟一下就能看到效果對(duì)理解 openclaw 的工作流機(jī)制特別有幫助。進(jìn)入代碼目錄并拉取倉(cāng)庫(kù)mkdir -p ~/projects cd ~/projects git clone https://github.com/你的fork/openclaw.git cd openclaw pnpm install如果你不確定倉(cāng)庫(kù)地址在搜索引擎里搜 openclaw 官方倉(cāng)庫(kù)即可。pnpm install過(guò)程中如果報(bào) node-gyp 編譯錯(cuò)誤通常是缺少編譯工具鏈先執(zhí)行sudo apt update sudo apt install build-essential python3裝完再重新執(zhí)行pnpm install。這一步在干凈的 WSL2 環(huán)境里幾乎都會(huì)碰到不用慌裝了再跑一遍就好。4.2 構(gòu)建和啟動(dòng) openclaw依賴(lài)裝完后通常要先執(zhí)行構(gòu)建命令把 TypeScript 編譯成 JavaScript。openclaw 的項(xiàng)目腳本一般會(huì)提供pnpm build啟動(dòng)命令可能是pnpm start或者pnpm dev。具體以項(xiàng)目 README 為準(zhǔn)但整體流程是一致的cp .env.example .env # 編輯 .env配置端口、數(shù)據(jù)庫(kù)連接、密鑰等 pnpm build pnpm start啟動(dòng)后看到類(lèi)似 “Server listening on port 3000” 的日志說(shuō)明服務(wù)已經(jīng)起來(lái)了。此時(shí)在 Windows 瀏覽器訪問(wèn)http://localhost:3000WSL2 的 localhost 轉(zhuǎn)發(fā)機(jī)制會(huì)自動(dòng)幫你映射到 WSL 內(nèi)的服務(wù)。如果訪問(wèn)不到先檢查服務(wù)有沒(méi)有監(jiān)聽(tīng)0.0.0.0再檢查 Windows 防火墻是否攔截了 WSL 的流量。這里補(bǔ)一句如果你后續(xù)打算在 openclaw 里調(diào)用本地模型做推理WSL2 天然支持 NVIDIA CUDA 加速Windows 側(cè)裝好顯卡驅(qū)動(dòng)后WSL 內(nèi)直接識(shí)別 GPU不需要額外安裝任何驅(qū)動(dòng)。這一步可以放到環(huán)境調(diào)優(yōu)時(shí)再搞搭建階段先專(zhuān)注把服務(wù)跑通。4.3 接入 Microsoft Teams 的配置要點(diǎn)openclaw 與 Microsoft Teams 聯(lián)動(dòng)是很多人最想玩的部分。這里提醒一下接入 Teams 的關(guān)鍵不在 openclaw 側(cè)而在微軟開(kāi)發(fā)者后臺(tái)的應(yīng)用注冊(cè)。你需要先在 Microsoft Teams 開(kāi)發(fā)者平臺(tái)創(chuàng)建一個(gè) Bot 應(yīng)用拿到 Tenant ID、Client ID、Client Secret并配置 Bot 的消息回調(diào)地址指向 openclaw 對(duì)外暴露的接口。本地開(kāi)發(fā)沒(méi)有公網(wǎng)地址通常需要借助內(nèi)網(wǎng)穿透工具或者直接在服務(wù)器上部署生產(chǎn)環(huán)境也會(huì)走 HTTPS 回調(diào)。在 openclaw 的.env里配置項(xiàng)大致如下TEAMS_TENANT_ID你的TenantId TEAMS_CLIENT_ID你的ClientId TEAMS_CLIENT_SECRET你的ClientSecret TEAMS_REDIRECT_URIhttp://localhost:3000/auth/teams/callbackMicrosoft Teams 平臺(tái)對(duì)回調(diào)地址有嚴(yán)格規(guī)則純本地測(cè)試時(shí)可以用 localhost 白名單。如果一直報(bào) unauthorized優(yōu)先檢查三件事Client Secret 是否復(fù)制完整、回調(diào)地址是否與應(yīng)用注冊(cè)頁(yè)面完全一致、.env改完后是否重啟了服務(wù)。我見(jiàn)過(guò)太多因?yàn)?env改完沒(méi)重啟就反復(fù)排查配置的例子。4.4 接入 Obsidian 的配置要點(diǎn)openclaw 聯(lián)動(dòng) Obsidian核心需求就是讓 openclaw 能讀取 Obsidian vault 里的筆記或者監(jiān)聽(tīng)文件變化。Obsidian 本身沒(méi)有官方對(duì)外 HTTP API需要安裝社區(qū)插件來(lái)提供本地 REST API。在 Obsidian 里啟動(dòng)對(duì)應(yīng)插件設(shè)置一個(gè) API Key然后在 openclaw 配置里填入三項(xiàng)信息Vault 路徑也就是 Obsidian 倉(cāng)庫(kù)在 WSL 里的路徑比如/mnt/d/ObsidianVaultAPI Base URL默認(rèn)通常是http://localhost:27124API Key插件生成的那串密鑰配置完成后可以試一條簡(jiǎn)單規(guī)則比如“當(dāng) Obsidian 新增標(biāo)題包含 TODO 的筆記時(shí)調(diào)用某個(gè)腳本”。如果聯(lián)動(dòng)沒(méi)反應(yīng)先查路徑權(quán)限。從 WSL 訪問(wèn)/mnt/d/下的 Windows 文件需要轉(zhuǎn)換路徑速度會(huì)慢一點(diǎn)但讀寫(xiě)正常。注意別把 Windows 路徑D:\ObsidianVault直接填進(jìn)去WSL 里必須寫(xiě)成/mnt/d/ObsidianVault格式。4.5 讓 openclaw 在 WSL2 里穩(wěn)定常駐啟動(dòng) openclaw 只是第一步讓它長(zhǎng)期穩(wěn)定跑著才是第二步。WSL2 的終端一旦關(guān)閉前臺(tái)運(yùn)行的服務(wù)就會(huì)退出所以我建議把 openclaw 交給 systemd 托管。新版 WSL2 支持在/etc/wsl.conf里開(kāi)啟 systemd[boot] systemdtrue然后創(chuàng)建一個(gè) systemd service 文件比如/etc/systemd/system/openclaw.service[Unit] Descriptionopenclaw service Afternetwork.target [Service] User你的用戶名 WorkingDirectory/home/你的用戶名/projects/openclaw ExecStart/home/你的用戶名/.nvm/versions/node/v24.x.x/bin/node server.js Restartalways RestartSec10 [Install] WantedBymulti-user.target注意ExecStart里的 Node 路徑要以which node實(shí)際輸出為準(zhǔn)不要照抄我的。然后執(zhí)行sudo systemctl daemon-reload sudo systemctl enable openclaw sudo systemctl start openclaw用 systemd 而不是 nohup 的好處很直接崩潰自動(dòng)拉起、開(kāi)機(jī)自啟、日志統(tǒng)一用journalctl查看對(duì)長(zhǎng)期運(yùn)行的服務(wù)來(lái)說(shuō)省心太多。如果你的 WSL 版本不支持 systemd用 pm2 也能達(dá)到類(lèi)似效果二選一就行。5. 常見(jiàn)問(wèn)題與踩坑排查清單5.1 遷移和安裝階段最常見(jiàn)的 8 個(gè)問(wèn)題整理一下我折騰過(guò)程中遇到的高頻問(wèn)題基本覆蓋新手階段 80% 的報(bào)錯(cuò)現(xiàn)象可能原因處理辦法wsl --list --verbose 顯示 VERSION 為 1發(fā)行版還在 WSL1 模式wsl --set-version Ubuntu 2遷移導(dǎo)入后默認(rèn)用戶變成 rootexport / import 不保留默認(rèn)用戶用ubuntu.exe config --default-user 用戶名或修改 /etc/wsl.confWSL 啟動(dòng)報(bào) 0xffffffffWSL 內(nèi)核版本過(guò)舊或虛擬化未開(kāi)啟wsl --update重啟電腦檢查 BIOS 的虛擬化開(kāi)關(guān)pnpm install 報(bào) node-gyp 編譯錯(cuò)誤缺少 build-essential 和 python3sudo apt install build-essential python3后重裝npm 和 pnpm 下載依賴(lài)速度極慢默認(rèn) registry 是官方源設(shè)置 registry 為 npmmirror 鏡像Windows 瀏覽器訪問(wèn) localhost:3000 失敗服務(wù)監(jiān)聽(tīng) 127.0.0.1 或防火墻攔截讓服務(wù)監(jiān)聽(tīng) 0.0.0.0檢查 Windows Defender 防火墻 WSL 規(guī)則WSL 內(nèi)存占用過(guò)高Windows 卡頓WSL2 默認(rèn)可使用全部?jī)?nèi)存在/mnt/c/Users/你的用戶名/.wslconfig里限制 memory 和 processorsopenclaw 服務(wù)啟動(dòng)后一直重啟.env 配置項(xiàng)不完整或端口被占用查看 systemd 日志sudo journalctl -u openclaw -f檢查端口占用5.2 一個(gè)隱蔽的坑C 盤(pán)又快滿了根源卻是 Docker 鏡像這是個(gè)很容易被忽略的事。你以為 WSL2 發(fā)行版搬到 D 盤(pán)就萬(wàn)事大吉結(jié)果過(guò)了兩周 C 盤(pán)又紅了。查下來(lái)發(fā)現(xiàn)Docker Desktop 的數(shù)據(jù)目錄還是在默認(rèn)的 C 盤(pán)位置。如果你打算用 Docker 方式跑 openclaw 或它依賴(lài)的數(shù)據(jù)庫(kù)一定要在 Docker Desktop 設(shè)置里把 Disk image location 改到 D 盤(pán)。Docker Desktop 運(yùn)行狀態(tài)下修改這個(gè)路徑會(huì)自動(dòng)把現(xiàn)有虛擬磁盤(pán)遷移過(guò)去。搬完之后再檢查一次 C 盤(pán)空間釋放效果肉眼可見(jiàn)。5.3 另一個(gè)容易踩坑的點(diǎn)項(xiàng)目文件放 /mnt/d/ 還是放 /home/openclaw 的源碼和運(yùn)行數(shù)據(jù)我建議放在 WSL2 的文件系統(tǒng)內(nèi)部也就是 /home 目錄不要放在/mnt/d/這種跨文件系統(tǒng)掛載路徑上。雖然/mnt/d/也能正常讀寫(xiě)但每一次文件操作都要經(jīng)過(guò) 9P 協(xié)議跨系統(tǒng)轉(zhuǎn)發(fā)npm install 這種動(dòng)輒幾萬(wàn)次小文件操作的場(chǎng)景會(huì)被拖慢好幾倍。Obsidian vault 因?yàn)槭?Windows 文件只能放在/mnt/d/這部分單次讀取可以接受。但 openclaw 工程本體、Node 依賴(lài)、緩存這些高頻讀寫(xiě)的內(nèi)容一律放到 Linux 內(nèi)部路徑。因?yàn)檎麄€(gè)發(fā)行版已經(jīng)搬到 D 盤(pán)所以 /home 下的項(xiàng)目文件并不占 C 盤(pán)空間運(yùn)行速度還快兩全其美。踩過(guò)幾次坑之后我現(xiàn)在的習(xí)慣是WSL2 發(fā)行版放 D 盤(pán)openclaw 工程在 /home 下Obsidian vault 在 /mnt/d/ 下npm / pnpm 緩存和 Docker 鏡像也都指向 D 盤(pán)。遷一次把盤(pán)符規(guī)劃好后面基本不用再操心 C 盤(pán)空間的問(wèn)題。如果你也準(zhǔn)備搭這套環(huán)境建議先把這幾個(gè)路徑規(guī)劃清楚再動(dòng)手省下來(lái)的時(shí)間和心情足夠你多折騰幾個(gè) openclaw 的玩法和技能了。