先說結(jié)論OpenClaw社區(qū)里也叫Clawdbot這套東西只要按順序走完環(huán)境準(zhǔn)備、安裝、初始化、模型接入四步新手也能在兩小時內(nèi)跑起來。我這篇文章不是官方文檔的復(fù)述而是我最近在Windows 11和一臺云服務(wù)器上從零部署OpenClaw的完整記錄里面包含了所有我踩過的坑、試錯后留下的命令以及那些官方文檔里根本不會寫的細(xì)節(jié)。如果你正打算在本地部署一個能自己寫代碼、操作文件、調(diào)用工具的AI智能體這篇文章應(yīng)該能幫你省下至少一個晚上的折騰時間。1. OpenClaw部署前先搞懂它到底是個什么東西1.1 一句話講清楚OpenClaw的定位OpenClaw本質(zhì)上是一個本地優(yōu)先的Agent Runtime也就是“智能體運(yùn)行時”。你可以把它理解成一個給大模型裝上手腳的框架大模型負(fù)責(zé)思考OpenClaw負(fù)責(zé)動手。它能把模型輸出的指令翻譯成真實(shí)的電腦操作比如讀取文件、執(zhí)行命令、調(diào)用瀏覽器、管理下載內(nèi)容甚至在公司內(nèi)部系統(tǒng)里做數(shù)據(jù)搬運(yùn)。很多第一次接觸的人會把它和ChatGPT這類聊天機(jī)器人搞混實(shí)際上差別非常大。聊天機(jī)器人是“你問我答”O(jiān)penClaw是“你說目標(biāo)、它跑流程”。舉個例子你跟OpenClaw說“幫我把這個文件夾里所有圖片壓縮成WebP格式并生成一份清單”它不是給你一段教程而是真的會去掃描文件、調(diào)用圖像處理工具、最后把清單放到workspace目錄里。這種“結(jié)果導(dǎo)向”的使用方式才是Clawdbot這類項(xiàng)目最核心的吸引力。1.2 為什么2026年大家開始扎堆本地部署OpenClaw我在部署前也猶豫過直接用線上Agent服務(wù)不香嗎折騰本地部署圖什么實(shí)際跑通之后我覺得本地部署的核心價值有三點(diǎn)。一是數(shù)據(jù)可控。OpenClaw默認(rèn)會把所有中間產(chǎn)物、臨時文件、執(zhí)行記錄存在本地workspace里不需要把敏感資料傳到第三方服務(wù)。對公司內(nèi)部文檔、財(cái)務(wù)報表這類數(shù)據(jù)來說這一條就足以決定要不要用本地方案。二是成本結(jié)構(gòu)清晰。通過Ollama接本地開源模型跑一次任務(wù)只花電費(fèi)不按token計(jì)費(fèi)。我自己實(shí)測用qwen2.5:14b跑批量文本處理速度和云API差距不大但成本幾乎為零。三是可擴(kuò)展性。OpenClaw的技能機(jī)制允許你隨時加新工具我今天加了一個定時日報的skill明天又想接飛書機(jī)器人通知這些都能在本地配置里直接改不用等上游廠商排期。當(dāng)然本地部署也挑人。如果你完全沒接觸過命令行、連PowerShell都不太敢碰那還是先用桌面版產(chǎn)品比較穩(wěn)妥。這篇文章默認(rèn)你至少會打開終端、復(fù)制粘貼命令剩下的我會盡量講到“照著抄就能跑”的程度。2. 環(huán)境準(zhǔn)備OpenClaw依賴的三大件2.1 系統(tǒng)要求和必備軟件清單OpenClaw對硬件的要求不算苛刻但也不是隨便一臺老電腦就能流暢跑起來。我個人的建議配置如下組件最低要求推薦配置備注操作系統(tǒng)Windows 10 22H2 / Ubuntu 20.04Windows 11 / Ubuntu 22.04云服務(wù)器選Debian系最省心內(nèi)存8GB16GB以上模型推理和框架同時跑很吃內(nèi)存磁盤10GB空閑SSD 50GB模型文件動輒5GB起步顯卡可選NVIDIA顯卡8GB顯存純CPU也能跑速度慢一些Docker僅容器部署需要Docker Desktop 4.xLinux服務(wù)器裝docker-ce即可除了硬件軟件層面有三樣?xùn)|西是繞不開的命令行終端、Git、以及容器環(huán)境如果你選Docker路線。Windows用戶我建議直接用自帶的PowerShell 7別再用老舊的Windows PowerShell 5很多腳本命令在舊版本上表現(xiàn)不一樣容易白折騰。Git的話裝默認(rèn)配置就行OpenClaw在拉取skill插件時會用到。2.2 Ollama本地模型引擎的安裝與模型選型OpenClaw本身不帶大模型參數(shù)它需要連接一個“會思考的引擎”。目前社區(qū)里用得最多的就是Ollama。為什么選Ollama而不是其他推理框架因?yàn)樗鼘π率肿钣押冒惭b包點(diǎn)兩下就裝好后臺服務(wù)自動啟動命令行拉模型像拉Docker鏡像一樣簡單。Windows用戶去Ollama官網(wǎng)下載exe安裝包默認(rèn)配置一路Next即可。裝完打開終端驗(yàn)證ollama --version然后拉取一個適合跑智能體的模型。這里很多人會犯選擇困難癥我給一個經(jīng)過測試的選型參考內(nèi)存/顯存條件推薦模型說明16GB內(nèi)存無顯卡qwen2.5:7b日常文本處理夠用響應(yīng)快32GB內(nèi)存或8GB顯存qwen2.5:14b理解和生成質(zhì)量明顯提升推薦64GB內(nèi)存或16GB顯存qwen2.5:32b適合復(fù)雜代碼任務(wù)速度慢一些有API預(yù)算deepseek-chat直接走云端API效果最好拉取命令很簡單ollama pull qwen2.5:14b這里我多說一句不要貪大。我在16GB內(nèi)存的筆記本上跑過32b模型雖然能啟動但生成一個回答要等兩分鐘體驗(yàn)非常差。后來換回14b速度和質(zhì)量的平衡點(diǎn)反而最好。另外Ollama默認(rèn)端口是11434OpenClaw配置模型接口時要用到記一下。2.3 DeepSeek、NVIDIA NIM等云端模型接口的準(zhǔn)備工作如果你不想依賴本地模型或者覺得本地模型理解能力不夠OpenClaw也支持接OpenAI兼容接口DeepSeek、NVIDIA NIM、各種中轉(zhuǎn)站都走這個協(xié)議。準(zhǔn)備工作其實(shí)就三步拿到API Key、確認(rèn)Base URL、確認(rèn)模型名。以DeepSeek為例Base URL一般是https://api.deepseek.com/v1模型名是deepseek-chat這些信息在控制臺都能看到。中轉(zhuǎn)站的話Base URL要以平臺提供的地址為準(zhǔn)有些會帶路徑后綴不要想當(dāng)然地拼接。我的建議是本地先跑通Ollama把OpenClaw的流程摸熟之后再切換云端模型做效果對比。這樣即使后面配置出問題你至少知道問題出在模型接入層還是OpenClaw本身。3. 正式部署OpenClaw安裝的兩條路線實(shí)操3.1 路線一Windows下PowerShell一鍵安裝OpenClaw官方提供了一條PowerShell安裝命令理論上粘貼進(jìn)去就能裝完。但社區(qū)里問得最多的問題恰恰是“怎么指定安裝目錄”。官方腳本默認(rèn)會裝到用戶目錄下想改成D盤需要先設(shè)置環(huán)境變量。$env:OPENCLAW_INSTALL_DIR D:\OpenClaw irm https://get.openclaw.sh | iex這段命令的原理是先定義一個名為OPENCLAW_INSTALL_DIR的環(huán)境變量然后再執(zhí)行遠(yuǎn)程安裝腳本。腳本檢測到這個變量存在時就會把OpenClaw的可執(zhí)行文件釋放到指定目錄。實(shí)測在Windows 11下這個過程大概需要三到五分鐘取決于網(wǎng)絡(luò)狀況。裝完之后腳本一般會自動把可執(zhí)行文件路徑寫入PATH。但這里有個很經(jīng)典的坑如果安裝前你已經(jīng)開著一個終端窗口這個窗口里的PATH不會自動刷新必須新開一個PowerShell窗口才能生效。驗(yàn)證安裝是否成功運(yùn)行openclaw --version如果看到版本號輸出說明安裝成功。如果你遇到的是“無法將openclaw項(xiàng)識別為cmdlet”的報錯先別慌九成是PATH沒生效或者安裝目錄沒寫進(jìn)去解決方案我在后面章節(jié)專門講。3.2 路線二Docker部署方式云端和Linux服務(wù)器推薦如果你要在云服務(wù)器上部署或者希望環(huán)境隔離得更干凈一些Docker路線更合適。OpenClaw官方維護(hù)了鏡像一條命令就能起一個完整的運(yùn)行時。docker run -d --name openclaw \ -v ~/.openclaw:/root/.openclaw \ -v /var/run/docker.sock:/var/run/docker.sock \ -e OPENCLAW_MODELollama/qwen2.5:14b \ -p 3000:3000 \ openclaw/openclaw:latest我來解讀一下這條命令里每個參數(shù)的作用方便你按需調(diào)整-v ~/.openclaw:/root/.openclaw把宿主機(jī)的配置目錄映射到容器內(nèi)這樣配置、workspace、審批記錄都能持久化容器刪了重裝也不會丟數(shù)據(jù)。-v /var/run/docker.sock:/var/run/docker.sock掛載Docker套接字讓容器內(nèi)的OpenClaw能調(diào)用宿主機(jī)的Docker來創(chuàng)建隔離環(huán)境。這一步對自動化能力很關(guān)鍵但同時也意味著容器有較高權(quán)限生產(chǎn)環(huán)境要慎重。-e OPENCLAW_MODELollama/qwen2.5:14b指定默認(rèn)大模型。這里的前綴ollama/表示走Ollama協(xié)議。-p 3000:3000把OpenClaw的Web控制臺端口映射出來這樣你可以在瀏覽器里訪問。啟動之后通過docker logs -f openclaw查看運(yùn)行日志。如果容器一直重啟最常見的原因是Docker套接字權(quán)限不夠或者掛載目錄沒有正確創(chuàng)建。在我的云服務(wù)器上腳本自動創(chuàng)建的目錄權(quán)限是root我在~/.openclaw前面加了一層用戶目錄才解決。3.3 安裝完成后必須做的三步驗(yàn)證安裝完成不意味著萬事大吉我習(xí)慣按順序做三步驗(yàn)證確認(rèn)整個鏈路是通的。第一步檢查版本和幫助信息openclaw --version openclaw --help第二步初始化運(yùn)行時。OpenClaw在首次啟動時會自動生成配置目錄和工作目錄openclaw init運(yùn)行之后在你的用戶目錄下會出現(xiàn).openclaw文件夾里面有config.json、workspace等目錄。這一步如果報錯通常和權(quán)限有關(guān)Windows用戶用管理員PowerShellLinux用戶檢查目錄寫權(quán)限。第三步跑一個最簡單的對話任務(wù)驗(yàn)證模型連接是否正常openclaw run 你好請用一句話介紹你自己如果模型正確返回一段自我介紹那恭喜你整個部署鏈路已經(jīng)通了。如果提示連接失敗或超時大概率是模型引擎的地址沒配對下一步我們就來解決配置問題。4. 初始化配置OpenClaw運(yùn)行時的四個核心文件4.1 workspace工作區(qū)機(jī)制AI的“安全辦公桌”O(jiān)penClaw初始化完成后默認(rèn)會在~/.openclaw/workspace生成一個工作區(qū)。這個目錄就是AI的活動范圍所有文件讀寫、臨時腳本、下載內(nèi)容都會被限制在這個沙箱里。為什么要設(shè)置工作區(qū)很簡單大模型在執(zhí)行任務(wù)時可能會產(chǎn)生意外操作如果把整個系統(tǒng)盤暴露給它風(fēng)險太高。把它限制在一個專屬目錄里就算模型跑飛了最多污染workspace不會動到系統(tǒng)關(guān)鍵文件。我建議根據(jù)實(shí)際用途調(diào)整工作區(qū)位置。如果你打算讓OpenClaw配合Obsidian做項(xiàng)目管理就可以把workspace指向你的筆記目錄openclaw config set workspace D:\ObsidianVault注意這里有個小細(xì)節(jié)修改workspace后舊目錄里的歷史文件不會自動遷移需要你手動復(fù)制。另外不要讓workspace直接指向C盤根目錄或者系統(tǒng)目錄否則權(quán)限模型會變得很難控制。4.2 exec-approvals.json執(zhí)行審批機(jī)制OpenClaw有一個非常重要的安全設(shè)計(jì)當(dāng)AI要執(zhí)行系統(tǒng)命令時會先檢查一個名為exec-approvals.json的審批文件。比如你在日志里看到類似提示——legacy exec approvals exist at /root/.openclaw/exec-approvals.json——意思就是系統(tǒng)檢測到了歷史審批記錄正在加載它們。首次運(yùn)行時OpenClaw會為每條高風(fēng)險的命令詢問你是否允許。你選擇“總是允許”后這條命令的規(guī)則會被寫入審批文件。文件內(nèi)容大概是這樣的結(jié)構(gòu){ approvals: { npm install: allow, rm -rf /tmp/cache: ask, curl http://example.com: deny } }這里我的經(jīng)驗(yàn)是白名單規(guī)則越具體越好。比如npm install是常見操作允許沒問題但像rm -rf這種危險命令寧可每次讓它問一遍也不要圖省事直接allow。很多人在部署初期覺得反復(fù)確認(rèn)很煩就一次性把所有命令都設(shè)成自動執(zhí)行這是我在真實(shí)項(xiàng)目中最不建議的做法——一旦模型被惡意prompt引導(dǎo)執(zhí)行了破壞性命令后悔都來不及。4.3 模型接入配置Ollama、DeepSeek和中轉(zhuǎn)站OpenClaw的主配置文件是~/.openclaw/config.json。首次初始化后文件里只有很基礎(chǔ)的設(shè)置。把模型接進(jìn)去就是在model字段里指定provider和地址。接Ollama本地模型的配置示例{ model: { provider: ollama, name: qwen2.5:14b, base_url: http://localhost:11434/v1 } }接DeepSeek云端接口的配置示例{ model: { provider: openai-compatible, name: deepseek-chat, base_url: https://api.deepseek.com/v1, api_key_env: DEEPSEEK_API_KEY } }注意api_key_env這個字段它指定的是環(huán)境變量的名字而不是直接把密鑰寫在配置文件里。這樣做的目的是防止配置文件被同步到Git倉庫或者分享出去時泄露密鑰。設(shè)置環(huán)境變量的方式Windows在PowerShell里$env:DEEPSEEK_API_KEY sk-你的密鑰Linux則在~/.bashrc里加一行export然后source ~/.bashrc。如果你使用中轉(zhuǎn)站原理和DeepSeek一樣只是base_url換成中轉(zhuǎn)站提供的地址。這里有個容易踩的坑有些中轉(zhuǎn)站的接口路徑不帶/v1后綴有些帶一定要以平臺文檔為準(zhǔn)否則會報404或模型不存在。NVIDIA NIM的接入方式也類似把base_url指向NIM推理端點(diǎn)即可只是模型名要寫NIM里實(shí)際部署的模型標(biāo)識符。4.4 Runtime metadata運(yùn)行時信息的查看與調(diào)優(yōu)部署完成后我建議看一眼openclaw runtime metadata這個命令的輸出。它會列出當(dāng)前運(yùn)行時的版本、模型連接狀態(tài)、workspace路徑、審批策略等元信息。openclaw runtime metadata這個命令的價值在于排查問題。有一次我明明改了config.json但任務(wù)執(zhí)行時還在用舊模型查了半天發(fā)現(xiàn)是容器鏡像里的runtime緩存沒刷新。執(zhí)行openclaw runtime metadata才確認(rèn)是元信息里的模型地址沒變。所以在調(diào)整任何配置后先看這個命令的輸出確認(rèn)配置真的生效了再繼續(xù)往下測試。5. 進(jìn)階使用把OpenClaw從玩具變成生產(chǎn)力工具5.1 Skill技能擴(kuò)展給智能體加“新本領(lǐng)”O(jiān)penClaw的Skill機(jī)制是整個框架里最值得研究的擴(kuò)展點(diǎn)。一個Skill其實(shí)就是一組預(yù)定義的提示詞加上配套工具腳本用來告訴模型“遇到這類任務(wù)時按這個流程來可以調(diào)用這些工具”。Skill的安裝命令很直觀openclaw skill install write-doc安裝后會放在~/.openclaw/skills目錄下。手動創(chuàng)建Skill也不復(fù)雜目錄結(jié)構(gòu)一般是這樣的write-doc/ ├── SKILL.md ├── tools/ │ └── generate_docx.py └── assets/其中SKILL.md是核心里面包含這個Skill的說明、使用場景、步驟引導(dǎo)。OpenClaw在每次執(zhí)行任務(wù)時會根據(jù)任務(wù)描述自動匹配并加載對應(yīng)的Skill提示詞。我自己寫過一個“日報生成”的Skill流程是掃描workspace里當(dāng)天的文件修改記錄結(jié)合git log生成工作摘要再按模板輸出成Markdown文件。這個Skill寫完之后每天下班跑一條命令就能拿到日報初稿省了不少重復(fù)勞動。建議新手先裝社區(qū)里現(xiàn)成的Skill研究幾天結(jié)構(gòu)之后再動手寫自己的第一個Skill。5.2 Cau Computer設(shè)置讓AI直接操作鼠標(biāo)鍵盤很多人在安裝后都會問“openclaw的cau computer如何設(shè)置”。Cau Computer指的是Computer Use能力開啟后AI可以模擬鼠標(biāo)點(diǎn)擊、鍵盤輸入、查看屏幕內(nèi)容像人一樣操作系統(tǒng)界面。這個功能對處理老舊系統(tǒng)、沒有API的網(wǎng)頁軟件特別有用。配置上在config.json里加一段{ computer: { enabled: true, display: 1, resolution: [1920, 1080], require_approval: true } }關(guān)鍵參數(shù)是require_approval我強(qiáng)烈建議保持true。因?yàn)樽孉I控制鼠標(biāo)鍵盤意味著它能做任何你能做的事一旦任務(wù)理解有偏差可能會出現(xiàn)亂點(diǎn)窗口、誤刪文件等意外。開啟真實(shí)操作前先用測試模式跑幾個簡單任務(wù)觀察它的操作路徑是否符合預(yù)期。5.3 接入飛書機(jī)器人實(shí)現(xiàn)消息通知部署完智能體后最實(shí)用的集成就是消息通知。你可以在飛書群里建一個自定義機(jī)器人拿到Webhook地址然后通過Skill方式讓OpenClaw在任務(wù)完成時推送結(jié)果。具體做法是寫一個簡單的飛書通知Skill核心是用curl觸發(fā)飛書機(jī)器人APIcurl -X POST -H Content-Type: application/json \ -d {msg_type:text,content:{text:任務(wù)執(zhí)行完成結(jié)果見附件}} \ https://open.feishu.cn/open-apis/bot/v2/hook/你的Webhook地址把這段邏輯封裝成Skill的工具腳本后OpenClaw就具備了主動匯報的能力。我在云服務(wù)器上跑定時數(shù)據(jù)清洗任務(wù)時每天早上九點(diǎn)會在飛書群里收到一條執(zhí)行結(jié)果手機(jī)上就能看到。配置時注意Webhook地址不要泄露這個地址等于群里的消息權(quán)限任何人拿到都能往群里發(fā)消息。5.4 結(jié)合Obsidian做項(xiàng)目管理以及云端部署的監(jiān)控問題Obsidian用戶可以把OpenClaw的workspace直接指向Obsidian的Vault目錄這樣AI生成的筆記、會議紀(jì)要、項(xiàng)目計(jì)劃都會以Markdown文件的形式落到Vault里Obsidian這邊自動索引和可視化。我實(shí)際操作中把workspace指向Vault下的一個_agents子文件夾OpenClaw生成的中間文件不會打亂正常筆記結(jié)構(gòu)。云端部署場景下如果你對穩(wěn)定性要求高建議給OpenClaw掛一個簡單的健康檢查。它內(nèi)置了metrics接口可以接到Prometheus里做監(jiān)控。企業(yè)Linux服務(wù)器上用systemd守護(hù)OpenClaw進(jìn)程加一行自動重啟策略能省掉半夜爬起來手動拉容器的麻煩。6. 常見問題排查與避坑套路我踩過的坑都在這6.1 安裝階段的經(jīng)典報錯和解決思路報錯信息原因解決辦法無法將“openclaw”項(xiàng)識別為 cmdlet、函數(shù)、腳本文件或可運(yùn)行程序的名稱PATH未生效或未寫入重新打開終端手動把安裝目錄加入PATH無法加載文件因?yàn)樵诖讼到y(tǒng)上禁止運(yùn)行腳本PowerShell執(zhí)行策略限制Set-ExecutionPolicy -Scope CurrentUser RemoteSignedDocker容器一直重啟掛載目錄權(quán)限不足或docker.sock不可用檢查目錄權(quán)限把用戶加入docker組ollama連接被拒絕Ollama服務(wù)未啟動運(yùn)行ollama serve確認(rèn)服務(wù)在11434端口監(jiān)聽其中“無法將openclaw識別為cmdlet”出現(xiàn)頻率最高。手動修復(fù)方法找到openclaw可執(zhí)行文件實(shí)際路徑比如D:\OpenClaw\bin然后在PowerShell里執(zhí)行[Environment]::SetEnvironmentVariable(Path, $env:Path ;D:\OpenClaw\bin, User)執(zhí)行完務(wù)必關(guān)掉所有終端窗口再重新打開否則環(huán)境變量不會刷新。Windows下如果裝了WebView應(yīng)用或者某些安全軟件攔截了遠(yuǎn)程腳本執(zhí)行也會導(dǎo)致安裝失敗臨時關(guān)掉安全軟件再裝即可裝完記得打開。6.2 模型接入和任務(wù)執(zhí)行中的問題排查任務(wù)執(zhí)行時常見的坑集中在模型這層。我的排查順序是先看OpenClaw日志再看模型服務(wù)日志最后才考慮改配置?，F(xiàn)象排查點(diǎn)模型不回復(fù)超時報錯確認(rèn)Ollama已啟動ollama list能顯示模型返回內(nèi)容為空檢查base_url是否帶了/v1后綴中文輸出混亂換更大模型把temperature調(diào)低到0.3以下顯存不足程序崩潰換量化版模型或減小上下文長度這里特別強(qiáng)調(diào)一下Ollama作為后臺服務(wù)時的坑如果你的Ollama是手動啟動的終端一關(guān)服務(wù)就停了OpenClaw自然連不上。Windows用戶建議把Ollama設(shè)置為開機(jī)啟動安裝時默認(rèn)會勾選Linux用戶用systemd管理確保它在后臺常駐。6.3 OpenClaw的安全底線和正確卸載姿勢部署OpenClaw這種能直接操作系統(tǒng)的智能體安全這根弦必須繃緊。我給三條底線第一exec-approvals.json里的危險命令不要全部allow第二不要把API Key硬編碼進(jìn)config.json用環(huán)境變量第三Docker部署時不要給容器privileged權(quán)限除非你完全清楚后果。徹底卸載OpenClaw的話先跑官方卸載命令openclaw uninstall然后手動刪除遺留的配置目錄Windows在C:\Users\你的用戶名\.openclawLinux在~/.openclaw。卸載前記得備份workspace里的成果文件這些是你和AI共同產(chǎn)出的數(shù)據(jù)刪了就找不回來了。6.4 關(guān)于部署背后的思考本地智能體的未來空間部署OpenClaw這個動作本身并不難難的是理解這套體系背后代表的范式變化AI不再只是回答問題而是開始接管可執(zhí)行的任務(wù)。當(dāng)你能在自己的電腦或服務(wù)器上擁有這樣一個“數(shù)字員工”工作流程的設(shè)計(jì)、數(shù)據(jù)安全的邊界、效率和風(fēng)險的權(quán)衡都會成為新的課題。這篇教程給了你一個跑通的起點(diǎn)后面能折騰出什么完全取決于你的想象力和業(yè)務(wù)需求。以我個人的體會來說OpenClaw最讓我驚喜的時刻不是它第一次跑通命令而是我出差在外地用手機(jī)看它通過飛書匯報定時任務(wù)的執(zhí)行結(jié)果那一刻我才真正覺得這個“數(shù)字員工”進(jìn)入工作狀態(tài)了。希望你也能在部署過程中體會到這種樂趣。