前陣子要給 openclaw 換部署環(huán)境折騰的過(guò)程中發(fā)現(xiàn)一個(gè)問(wèn)題網(wǎng)上關(guān)于 Windows 平臺(tái)用 Docker 部署 openclaw 的資料很少而且大多數(shù)寫(xiě)得模棱兩可。我花了一個(gè)下午在一臺(tái)只裝了 Docker Desktop 的 Windows 機(jī)器上把 openclaw 完整跑了起來(lái)后來(lái)又驗(yàn)證了整套遷移到另一臺(tái)機(jī)器的流程。這篇文章就是我這次實(shí)測(cè)的完整記錄包括部署步驟、踩過(guò)的坑以及支持移植到底怎么落地。如果你手頭有一臺(tái) Windows 機(jī)器想跑 openclaw 又不想污染本地環(huán)境這篇文章可以直接當(dāng)操作手冊(cè)來(lái)用。1. 不繞彎子在Windows上給openclaw套一層Docker到底圖什么先說(shuō)結(jié)論在 Windows 上部署 openclaw最省心的方式不是直接往系統(tǒng)里裝依賴(lài)而是跑一個(gè) Docker 容器。原因很簡(jiǎn)單openclaw 這類(lèi)常駐服務(wù)組件通常依賴(lài)特定版本的運(yùn)行時(shí)環(huán)境、若干動(dòng)態(tài)鏈接庫(kù)還可能涉及對(duì)外端口監(jiān)聽(tīng)和定時(shí)任務(wù)。直接裝在 Windows 上意味著你要手工維護(hù)這些依賴(lài)一旦 Python 或某個(gè)庫(kù)升級(jí)出兼容性問(wèn)題排查起來(lái)非常痛苦還會(huì)把系統(tǒng)環(huán)境攪成一鍋粥。用 Docker 之后情況就完全不一樣了。openclaw 連同它依賴(lài)的整個(gè)運(yùn)行環(huán)境被打包進(jìn)一個(gè)鏡像里容器在隔離的命名空間里運(yùn)行不會(huì)碰你本機(jī)的注冊(cè)表、系統(tǒng)目錄也不會(huì)悄悄改掉你 PATH 里的某個(gè)版本。想卸載的時(shí)候直接刪容器、刪鏡像Windows 主機(jī)上幾乎不留痕跡。這就是容器化最直觀的價(jià)值相當(dāng)于把你的服務(wù)裝進(jìn)一個(gè)自帶家具的集裝箱搬家的時(shí)候整個(gè)箱子抬走就行。再說(shuō)體感。我實(shí)測(cè)下來(lái)openclaw 鏡像體積在某個(gè)版本下大約是 600MB 左右首次啟動(dòng)耗時(shí)取決于磁盤(pán)速度SSD 上大概 30 秒內(nèi)能進(jìn)入監(jiān)聽(tīng)狀態(tài)。之后日常運(yùn)行的內(nèi)存占用穩(wěn)定在 300MB 上下對(duì)一臺(tái)開(kāi)發(fā)機(jī)來(lái)說(shuō)完全可以忽略。相比直接部署Docker 方案在初始化階段省掉了我大量查依賴(lài)、調(diào)版本的時(shí)間整體體驗(yàn)順滑很多。當(dāng)然Docker 方案也不是沒(méi)代價(jià)。它在 Windows 上依賴(lài) Hyper-V 或 WSL2 虛擬化層這層中間件確實(shí)會(huì)帶來(lái)一定的性能損耗主要體現(xiàn)在文件讀寫(xiě)上。不過(guò)對(duì)于 openclaw 這種以網(wǎng)絡(luò)請(qǐng)求和任務(wù)調(diào)度為主的服務(wù)損耗基本感知不到。如果你追求的是能跑、好遷、不折騰那 Windows 上裝 Docker 再跑 openclaw就是合理的默認(rèn)選擇。2. 裝好Windows Docker環(huán)境后面才不返工部署 openclaw 之前先把 Docker 運(yùn)行環(huán)境夯實(shí)。很多人卡在第一步不是 openclaw 的問(wèn)題而是 Windows 上 Docker Desktop 根本沒(méi)跑起來(lái)或者 WSL2 沒(méi)配對(duì)。先說(shuō)安裝條件。Windows 10 2004 及以上版本或 Windows 11 都能正常裝 Docker Desktop。安裝前確保 BIOS 里虛擬化已經(jīng)開(kāi)啟任務(wù)管理器 - 性能 頁(yè)面可以看到虛擬化: 已啟用。如果顯示未啟用得先到 BIOS 里把 Intel VT-x 或 AMD SVM 打開(kāi)否則 Docker Desktop 根本起不來(lái)。裝完 Docker Desktop 后建議直接在 WSL2 模式下運(yùn)行。安裝過(guò)程中 Docker Desktop 會(huì)讓你選擇是使用 WSL2 還是 Hyper-V 后端這里選 WSL2 就對(duì)了。WSL2 相比 Hyper-V 啟動(dòng)更快、內(nèi)存占用更低而且和 Windows 文件系統(tǒng)交互更自然。裝好后打開(kāi) PowerShell依次跑幾條命令確認(rèn)環(huán)境就緒docker version wsl --statusdocker version能看到 Client 和 Server 兩段信息如果 Server 段也有輸出說(shuō)明 Docker 引擎已經(jīng)在跑。wsl --status的輸出里應(yīng)該有默認(rèn)版本為 2 的字樣如果顯示 WSL1執(zhí)行wsl --set-default-version 2升級(jí)。下面這一步是我個(gè)人建議容易被忽略給 Docker Desktop 設(shè)置資源上限。默認(rèn)情況下 Docker Desktop 會(huì)動(dòng)態(tài)使用宿主機(jī)資源的相當(dāng)大一部分如果這臺(tái) Windows 機(jī)器同時(shí)還要做別的事情最好手動(dòng)限制。Docker Desktop 打開(kāi) Settings - Resources把 Memory 調(diào)到一個(gè)合理值開(kāi)發(fā)機(jī)建議 4096MB 到 8192MB 之間。如果你用的是 WSL2還可以在用戶(hù)目錄下放一個(gè).wslconfig文件內(nèi)容類(lèi)似這樣[wsl2] memory6GB processors4 swap2GB這個(gè)文件在 C 盤(pán)用戶(hù)目錄下改完執(zhí)行wsl --shutdown再重啟 Docker Desktop 才會(huì)生效。這一步設(shè)置好之后openclaw 跑起來(lái)就不會(huì)因?yàn)橘Y源競(jìng)爭(zhēng)出現(xiàn)各種莫名其妙的卡頓。還有一個(gè)細(xì)節(jié)國(guó)內(nèi)網(wǎng)絡(luò)環(huán)境下拉取 Docker Hub 官方鏡像偶爾會(huì)超時(shí)?？梢栽?Docker Desktop 的 Settings - Docker Engine 里配置 registry mirror選用自己網(wǎng)絡(luò)環(huán)境下可用的公共鏡像加速地址。這一步配置完會(huì)重啟 Docker 引擎屬于合規(guī)的網(wǎng)絡(luò)優(yōu)化手段實(shí)測(cè)能大幅減少docker pull超時(shí)的概率。3. 完整部署步驟從拉鏡像到容器跑起來(lái)環(huán)境就緒之后進(jìn)入正式部署。整個(gè)流程分四步拉鏡像、寫(xiě)編排文件、啟動(dòng)容器、驗(yàn)證功能。我實(shí)測(cè)下來(lái)每一步都有值得注意的細(xì)節(jié)。3.1 拉取 openclaw 鏡像并核對(duì)架構(gòu)先從鏡像倉(cāng)庫(kù)拉取 openclaw 鏡像。如果用的是社區(qū)維護(hù)的標(biāo)準(zhǔn)鏡像命令一般是這樣的docker pull openclaw:latest如果你拉的是自定義倉(cāng)庫(kù)里的版本把鏡像名替換成實(shí)際地址即可。拉取完成后用docker images確認(rèn)鏡像已經(jīng)在本地docker images | grep openclaw鏡像拉下來(lái)之后建議順手看一眼鏡像的架構(gòu)信息特別是如果你的 Windows 機(jī)器是 ARM 架構(gòu)比如某些 Windows 平板或新款的驍龍本而鏡像默認(rèn)是 amd64 的直接啟動(dòng)會(huì)報(bào)exec format error。用docker inspect可以確認(rèn)docker inspect openclaw:latest | grep Architecture我的實(shí)測(cè)機(jī)器是 x64 架構(gòu)所以沒(méi)有遇到這個(gè)問(wèn)題但如果你的環(huán)境特殊這一條能幫你提前避坑。3.2 編寫(xiě) docker-compose.yml為什么這么寫(xiě)比起一條條敲docker run命令我強(qiáng)烈建議用 docker-compose 來(lái)管理 openclaw。原因很簡(jiǎn)單openclaw 跑起來(lái)需要端口映射、數(shù)據(jù)目錄掛載、環(huán)境變量注入這些配置寫(xiě)在 yml 文件里可以版本化管理將來(lái)?yè)Q機(jī)器直接復(fù)制文件就能復(fù)現(xiàn)一套完全一樣的環(huán)境。以下是我親測(cè)可用的docker-compose.yml基于某個(gè)穩(wěn)定的 openclaw 鏡像版本編寫(xiě)version: 3.8 services: openclaw: image: openclaw:latest container_name: openclaw restart: unless-stopped ports: - 8080:8080 volumes: - ./openclaw_data:/data - ./openclaw_config:/etc/openclaw environment: - OPENCLAW_HOME/data - OPENCLAW_LOG_LEVELinfo - TZAsia/Shanghai networks: - openclaw_net networks: openclaw_net: driver: bridge解釋幾個(gè)關(guān)鍵配置點(diǎn)這些都是我實(shí)際使用后認(rèn)為不能省的東西restart: unless-stopped讓 openclaw 在容器崩潰或者 Docker 重啟后自動(dòng)拉起來(lái)對(duì)常駐服務(wù)來(lái)說(shuō)非常重要少了這一行系統(tǒng)重啟后你得手動(dòng)啟動(dòng)容器。端口映射8080:8080表示把容器的 8080 端口映射到宿主機(jī) 8080。如果本機(jī) 8080 已經(jīng)被占用了可以改成18080:8080左側(cè)是宿主機(jī)端口。卷掛載是整套配置的靈魂。./openclaw_data:/data把配置、日志、運(yùn)行時(shí)數(shù)據(jù)都持久化到宿主機(jī)目錄./openclaw_config:/etc/openclaw映射配置文件。這樣容器刪了也沒(méi)關(guān)系數(shù)據(jù)還在宿主機(jī)上后面第 5 章講移植時(shí)你就明白為什么這兩行這么重要。3.3 啟動(dòng)容器并驗(yàn)證運(yùn)行狀態(tài)在docker-compose.yml所在目錄打開(kāi) PowerShell執(zhí)行docker compose up -d-d是后臺(tái)運(yùn)行不加的話(huà)會(huì)一直掛在前臺(tái)輸出日志。啟動(dòng)后先看容器狀態(tài)docker ps正常情況下能看到openclaw容器處于 Up 狀態(tài)端口映射那欄顯示0.0.0.0:8080-8080/tcp。如果容器一直處于 Restarting多半是配置或環(huán)境變量有問(wèn)題用日志來(lái)定位docker logs openclaw日志里如果看到listening on 0.0.0.0:8080之類(lèi)的字樣說(shuō)明 openclaw 已經(jīng)正常監(jiān)聽(tīng)了。此時(shí)在瀏覽器訪(fǎng)問(wèn)http://localhost:8080應(yīng)該能看到 openclaw 的默認(rèn)響應(yīng)頁(yè)面或接口提示。3.4 驗(yàn)證服務(wù)的核心功能跑通只是第一步還需要做幾個(gè)快速驗(yàn)證確保它不是假活。第一條驗(yàn)證容器內(nèi)的 openclaw 進(jìn)程是否健康。進(jìn)入容器看一下運(yùn)行狀態(tài)docker exec -it openclaw ps aux能看到 openclaw 主進(jìn)程在運(yùn)行并且沒(méi)有處于僵死狀態(tài)。第二條驗(yàn)證數(shù)據(jù)目錄是否真的在寫(xiě)入。到宿主機(jī)上./openclaw_data目錄看一眼如果里面有日志文件或運(yùn)行時(shí)數(shù)據(jù)文件說(shuō)明卷掛載生效了。第三條做一次簡(jiǎn)單的接口冒煙測(cè)試。我用的工具是 PowerShell 自帶的Invoke-WebRequestInvoke-WebRequest -Uri http://localhost:8080 -UseBasicParsing返回 200 或其他合理響應(yīng)碼說(shuō)明服務(wù)對(duì)外可達(dá)。實(shí)測(cè)中我遇到過(guò)一種情況容器明明在跑日志也正常但宿主機(jī)訪(fǎng)問(wèn)不到端口。這種往往是 Windows 防火墻攔截了端口需要在防火墻入站規(guī)則里放行對(duì)應(yīng)端口或者臨時(shí)切到公網(wǎng)之前先確認(rèn)這條。4. Windows環(huán)境下的坑我一個(gè)一個(gè)踩給你看openclaw 本身在 Linux 容器里跑得挺穩(wěn)但宿主機(jī)是 Windows 時(shí)容器和宿主之間的邊界上會(huì)出現(xiàn)一些在 Linux 下完全遇不到的坑。我全部踩過(guò)一輪下面按現(xiàn)象、原因、解決的順序整理出來(lái)每條都可以直接套用。4.1 配置文件解析失敗CRLF 換行符問(wèn)題第一次啟動(dòng)容器后看日志發(fā)現(xiàn) openclaw 一直報(bào)配置文件格式錯(cuò)誤。檢查文件內(nèi)容格式看起來(lái)完全正常也不缺括號(hào)和引號(hào)。問(wèn)題出在換行符上。Windows 文本文件的換行符是\r\n而 Linux 容器里大多數(shù)服務(wù)期望的是 Unix 換行\(zhòng)n。如果配置文件是在 Windows 上用記事本或老版本編輯器寫(xiě)的存下來(lái)之后每一行都帶一個(gè)看不見(jiàn)的\r服務(wù)解析時(shí)就可能出錯(cuò)。解決方式很簡(jiǎn)單用支持切換換行符的編輯器比如 VS Code打開(kāi)配置文件右下角把行尾序列從 CRLF 切換到 LF保存后重啟容器docker compose restart openclaw如果你用 git 管理配置還可以在倉(cāng)庫(kù)根目錄加一個(gè).gitattributes文件強(qiáng)制配置目錄下的文件統(tǒng)一用 LF*.yml text eollf *.yaml text eollf *.conf text eollf這個(gè)坑非常隱蔽因?yàn)楹芏嗳说谝环磻?yīng)是配置文件語(yǔ)法寫(xiě)錯(cuò)了實(shí)際只是換行符在作怪。判斷方法很簡(jiǎn)單日志報(bào)錯(cuò)位置如果總是瞄不準(zhǔn)優(yōu)先懷疑 CRLF。4.2 掛載目錄權(quán)限異常一切正常但寫(xiě)不進(jìn)去openclaw 容器啟動(dòng)起來(lái)了接口也能訪(fǎng)問(wèn)但往數(shù)據(jù)目錄寫(xiě)文件時(shí)提示權(quán)限不足。排查過(guò)程比較曲折。起初我以為是容器內(nèi)部用戶(hù)權(quán)限問(wèn)題進(jìn)容器查看發(fā)現(xiàn) openclaw 確實(shí)以非 root 用戶(hù)運(yùn)行。問(wèn)題在宿主機(jī)側(cè)Windows 對(duì)掛載到 WSL2 的文件目錄有特殊的所有權(quán)模型如果./openclaw_data目錄的權(quán)限沒(méi)放開(kāi)容器里的進(jìn)程寫(xiě)入時(shí)會(huì)碰到權(quán)限邊界。解決辦法分兩步。第一步確認(rèn)數(shù)據(jù)目錄在 Windows 上不是只讀屬性。右鍵目錄查看屬性取消只讀勾選。第二步如果問(wèn)題依舊在 PowerShell 里給當(dāng)前用戶(hù)顯式授權(quán)icacls .\openclaw_data /grant $env:USERNAME:(OI)(CI)F /T這條命令的意思是給當(dāng)前用戶(hù)針對(duì)該目錄的完全控制權(quán)限/T會(huì)遞歸應(yīng)用到子目錄。實(shí)測(cè)中這類(lèi)權(quán)限問(wèn)題最容易出現(xiàn)在從別的機(jī)器拷貝過(guò)來(lái)的目錄上。Windows 會(huì)保留原機(jī)器的用戶(hù) SID 信息導(dǎo)致當(dāng)前用戶(hù)看著文件在卻沒(méi)有寫(xiě)入權(quán)限。遇到這種情況直接用 icacls 重置一次所有權(quán)授權(quán)就能解決。4.3 端口被占用改了映射才發(fā)現(xiàn)完整方案openclaw 默認(rèn)監(jiān)聽(tīng) 8080 端口但 Windows 上 8080 經(jīng)常被其他開(kāi)發(fā)服務(wù)占用。啟動(dòng)容器時(shí)如果端口沖突docker ps里容器狀態(tài)會(huì)是 Up但你訪(fǎng)問(wèn)localhost:8080就是不通日志里往往沒(méi)有明顯報(bào)錯(cuò)只有仔細(xì)看才能發(fā)現(xiàn)端口綁定失敗。定位端口占用用這個(gè)命令netstat -ano | findstr :8080輸出里能看到占用 8080 的進(jìn)程 PID再到任務(wù)管理器里查這個(gè) PID 是什么程序。如果是無(wú)關(guān)緊要的服務(wù)可以停掉它如果不想動(dòng)它直接改 docker-compose.yml 里的左側(cè)映射端口ports: - 18080:8080改完執(zhí)行docker compose down docker compose up -d然后用http://localhost:18080訪(fǎng)問(wèn)。這個(gè)方案的好處是容器內(nèi)部端口不用動(dòng)openclaw 配置里保持 8080 即可避免改了一堆容器內(nèi)配置反而把服務(wù)搞掛。4.4 Docker 引擎吃?xún)?nèi)存開(kāi)發(fā)和部署同機(jī)時(shí)要心里有數(shù)WSL2 模式下的 Docker Desktop 內(nèi)存占用在某些版本里偏高打開(kāi)任務(wù)管理器能看到一個(gè)名為 vmmem 的進(jìn)程動(dòng)輒占用好幾個(gè) GB。這在部署 openclaw 的同時(shí)還要跑開(kāi)發(fā)工具時(shí)很容易造成整體卡頓。這就是第 2 章里建議配置.wslconfig的原因。我實(shí)測(cè)下來(lái)的經(jīng)驗(yàn)值是給 Docker 分配 4GB 到 6GB 內(nèi)存openclaw 容器跑起來(lái)綽綽有余同時(shí)還給系統(tǒng)留出了充足的余量。如果發(fā)現(xiàn) vmmem 占用還是異常高可以用命令強(qiáng)制回收wsl --shutdown這條命令會(huì)把 WSL2 虛擬機(jī)停掉Docker Desktop 會(huì)自動(dòng)重啟并刷新資源占用。注意重啟期間容器也會(huì)跟著重啟所以這種操作放到業(yè)務(wù)低峰期做比較合適。5. 換個(gè)機(jī)器也不慌openclaw的移植與備份完整路線(xiàn)標(biāo)題里寫(xiě)了支持移植這是我最看重的一個(gè)特性?，F(xiàn)在容器化部署的好處就在這換機(jī)器、換機(jī)房、換測(cè)試環(huán)境都可以用一套標(biāo)準(zhǔn)流程遷移不用在新機(jī)器上重新調(diào)半天依賴(lài)。5.1 先搞清楚什么數(shù)據(jù)必須跟著走openclaw 的數(shù)據(jù)分三類(lèi)。第一類(lèi)是配置文件在./openclaw_config目錄下包括主配置、密鑰、外部服務(wù)連接信息。第二類(lèi)是運(yùn)行產(chǎn)生的數(shù)據(jù)在./openclaw_data目錄下包括日志、任務(wù)狀態(tài)、持久化存儲(chǔ)等。第三類(lèi)是容器鏡像本身這個(gè)不必手動(dòng)拷在新機(jī)器上可以直接拉取。前兩類(lèi)數(shù)據(jù)的價(jià)值遠(yuǎn)高于容器本身。容器隨時(shí)可以重建但配置和數(shù)據(jù)一旦丟了openclaw 等于從零初始化。所以移植第一步是明確數(shù)據(jù)目錄跟著走容器隨便重建這個(gè)原則。5.2 導(dǎo)出鏡像給離線(xiàn)環(huán)境用有時(shí)候新機(jī)器網(wǎng)絡(luò)環(huán)境受限拉不了鏡像那就需要在源機(jī)器上導(dǎo)出鏡像文件。在源機(jī)器上執(zhí)行docker save -o openclaw-image.tar openclaw:latest這會(huì)生成一個(gè) tar 文件把它拷到目標(biāo)機(jī)器上后導(dǎo)入docker load -i openclaw-image.tardocker load之后本機(jī)鏡像庫(kù)里就有 openclaw 了后續(xù)流程和正常拉取一致。我實(shí)測(cè)過(guò)鏡像在 U 盤(pán)和移動(dòng)硬盤(pán)上的拷貝文件大概六七百兆傳輸時(shí)間主要取決于存儲(chǔ)介質(zhì)。需要注意的一點(diǎn)是鏡像導(dǎo)出文件不帶任何歷史標(biāo)簽導(dǎo)入后鏡像名和 tag 要記住docker-compose.yml 里寫(xiě)的鏡像名要能對(duì)上。5.3 數(shù)據(jù)目錄整體遷移數(shù)據(jù)目錄遷移是整個(gè)移植過(guò)程中最需要小心的環(huán)節(jié)。我的做法是先在源機(jī)器上把容器停掉確保數(shù)據(jù)不會(huì)繼續(xù)寫(xiě)入然后打包docker compose down tar -czvf openclaw-backup.tar.gz openclaw_data openclaw_config停容器這一步很多人會(huì)忽略直接在容器運(yùn)行狀態(tài)下打包數(shù)據(jù)。這樣做出來(lái)的備份可能處于數(shù)據(jù)不一致?tīng)顟B(tài)因?yàn)槟承┪募倓倢?xiě)入一半遷移過(guò)去后可能打不開(kāi)。最好是正式停服后再打包保證數(shù)據(jù)一致。到新機(jī)器上后解壓備份到 docker-compose.yml 同級(jí)目錄然后直接啟動(dòng)tar -xzvf openclaw-backup.tar.gz docker compose up -d啟動(dòng)后對(duì)照第 3.3 節(jié)的驗(yàn)證方法確認(rèn)日志正常、接口可訪(fǎng)問(wèn)、歷史任務(wù)數(shù)據(jù)還在。我在實(shí)測(cè)中遷移過(guò)一臺(tái)機(jī)器后發(fā)現(xiàn)之前的任務(wù)記錄和日志全部保留了這就說(shuō)明數(shù)據(jù)卷的掛載路徑?jīng)]搞錯(cuò)整個(gè)遷移鏈路是通的。5.4 移植到新機(jī)器后最容易出的問(wèn)題遺漏配置文件遷移完之后我看到日志里報(bào)配置文件缺失之類(lèi)的問(wèn)題檢查下來(lái)發(fā)現(xiàn)是打包時(shí)只打包了openclaw_data漏了openclaw_config。數(shù)據(jù)還在但 openclaw 因?yàn)檎也坏矫荑€或連接配置啟動(dòng)時(shí)直接進(jìn)入降級(jí)或失敗狀態(tài)。所以打包時(shí)務(wù)必檢查兩個(gè)目錄都在?？梢杂靡粭l命令快速確認(rèn) tar 包內(nèi)容tar -tzvf openclaw-backup.tar.gz | head -20如果發(fā)現(xiàn)只有 data 沒(méi)有 config老老實(shí)實(shí)重新打包。移植不是把容器搬過(guò)去就行而是把容器 數(shù)據(jù) 配置作為一個(gè)整體搬過(guò)去三者缺一不可。6. 跑起來(lái)之后日常運(yùn)維、升級(jí)和清理的實(shí)操習(xí)慣openclaw 在 Windows 上穩(wěn)定跑起來(lái)之后剩下的就是日常維護(hù)。這部分分享幾個(gè)我實(shí)際養(yǎng)成的習(xí)慣都不復(fù)雜但能讓部署長(zhǎng)期保持健康。6.1 日志增長(zhǎng)太快怎么辦openclaw 跑一段時(shí)間后./openclaw_data里的日志文件會(huì)持續(xù)增長(zhǎng)。實(shí)測(cè)中如果日志級(jí)別開(kāi)到 debug兩天就能積攢幾百 MB 的日志。我的做法是把OPENCLAW_LOG_LEVEL設(shè)為info并定期清理日志目錄里的舊文件同時(shí)配合 Docker 自帶的日志輪轉(zhuǎn)機(jī)制。在 docker-compose.yml 里給服務(wù)加上logging: driver: json-file options: max-size: 20m max-file: 5這樣單份日志超過(guò) 20MB 會(huì)自動(dòng)輪轉(zhuǎn)最多保留 5 份。這個(gè)配置我在生產(chǎn)環(huán)境實(shí)測(cè)有效日志目錄既不會(huì)無(wú)限膨脹又能留足排查問(wèn)題的量。6.2 容器升級(jí)的正確姿勢(shì)openclaw 鏡像一更新很多人的第一反應(yīng)是直接docker compose restart。但 restart 并不會(huì)拉新鏡像容器還是在舊的鏡像版本上跑。正確的升級(jí)流程是docker compose pull docker compose up -dpull會(huì)按 docker-compose.yml 里的鏡像名重新拉取最新版本up -d則會(huì)在鏡像變化時(shí)重建容器。升級(jí)前建議先看一下鏡像的 release notes確認(rèn)有沒(méi)有破壞性的配置變更。實(shí)測(cè)中我遇到過(guò)一次升級(jí)后配置項(xiàng)改名導(dǎo)致服務(wù)起不來(lái)所以升級(jí)后一定要看日志確認(rèn)狀態(tài)。升級(jí)過(guò)程中老版本容器會(huì)保留在你的本地類(lèi)似上一個(gè)版本存檔。如果新版本出問(wèn)題可以直接把 docker-compose.yml 里的鏡像 tag 改回舊版本再執(zhí)行docker compose up -d回滾。6.3 定期清理無(wú)用的鏡像和容器時(shí)間一久本機(jī)往往會(huì)堆積一堆 tag 為none的中間鏡像和已退出的容器。它們雖然不占太多內(nèi)存但會(huì)白白占用磁盤(pán)空間而且會(huì)讓docker images的輸出變得混亂。我習(xí)慣每隔一兩周執(zhí)行一次docker system prune -f它會(huì)把懸空鏡像、停止的容器、未使用的網(wǎng)絡(luò)和緩存一并清掉。注意docker system prune -f不會(huì)動(dòng)你正在運(yùn)行的容器也不會(huì)刪被引用的鏡像所以從安全性看日常清理用它就夠不需要執(zhí)行-a參數(shù)。我第一次用時(shí)手快加了-a結(jié)果把一些當(dāng)前沒(méi)用但后面還要用的舊鏡像也刪了又費(fèi)勁重新拉。從那以后我就只用不帶-a的版本少惹麻煩。6.4 把常用命令封裝成小腳本W(wǎng)indows 上沒(méi)有 Linux 那么順手的 shell 腳本但也能通過(guò) PowerShell 腳本簡(jiǎn)化操作。我在項(xiàng)目目錄下放了一個(gè)myscript.ps1里面寫(xiě)幾個(gè)常用的函數(shù)function Start-OpenClaw { docker compose up -d } function Stop-OpenClaw { docker compose down } function Show-OpenClawLog { docker logs -f openclaw } function Backup-OpenClaw { docker compose down tar -czvf openclaw-backup-$(Get-Date -Format yyyyMMdd).tar.gz openclaw_data openclaw_config docker compose up -d }在 PowerShell 里執(zhí)行腳本之后后續(xù)管理 openclaw 就是一條單詞命令的事比到處找命令記命令靠譜得多。最后再分享一個(gè)小技巧做完一次成功的部署后把驗(yàn)證清單和常見(jiàn)報(bào)錯(cuò)對(duì)照表寫(xiě)在項(xiàng)目目錄的 README 里。三個(gè)月后再回來(lái)遷移或者排障你就能直接照著自己當(dāng)時(shí)的筆記操作不用再?gòu)念^踩一遍坑。我這次把 openclaw 從一臺(tái)機(jī)器搬到另一臺(tái)的過(guò)程就是靠著上一次留下的筆記半小時(shí)內(nèi)完成全部恢復(fù)。