封面圖
前言
OpenClaw（社區(qū)俗稱(chēng) “龍蝦”）是一款主打本地優(yōu)先、隱私安全、自主執(zhí)行的開(kāi)源 AI 自動(dòng)化智能體平臺(tái)，支持對(duì)接各類(lèi)云端與本地大模型，可通過(guò)聊天界面遠(yuǎn)程控制電腦完成文件處理、代碼編寫(xiě)、瀏覽器操作、任務(wù)自動(dòng)化等實(shí)際工作，憑借輕量化部署、跨平臺(tái)兼容和活躍的開(kāi)源生態(tài)，成為當(dāng)前極受歡迎的本地 AI 執(zhí)行工具。
Openclaw具有如下特點(diǎn)：
- 本地優(yōu)先，隱私可控：全本地部署，數(shù)據(jù)與記憶本地存儲(chǔ)不上傳云端，支持離線(xiàn)運(yùn)行，保障數(shù)據(jù)主權(quán)。
- 強(qiáng)執(zhí)行能力：具備系統(tǒng)級(jí)權(quán)限，可直接操作文件、終端、瀏覽器、訪(fǎng)問(wèn)外部服務(wù)，完成自動(dòng)化任務(wù)，而非僅文字對(duì)話(huà)。
- 模型無(wú)關(guān)：兼容 GPT、Claude和百煉等大模型服務(wù)商，此外還可以支持vLLM等本地大模型，可自由切換。
- 跨渠道交互：無(wú)需專(zhuān)用 App，通過(guò) Slack、Discord、微信、飛書(shū)等聊天工具遠(yuǎn)程控制。
- 主動(dòng)與持久化：支持 24/7 后臺(tái)運(yùn)行、定時(shí)任務(wù)、心跳檢測(cè)，可主動(dòng)監(jiān)控與觸發(fā)流程。
- 開(kāi)源可定制：MIT 協(xié)議開(kāi)源，模塊化架構(gòu)，支持自定義技能與二次開(kāi)發(fā)。
- 輕量跨平臺(tái)：支持 Windows/macOS/Linux，部署便捷、資源占用低。
本篇為大家講解Openclaw的部署和安裝。
安裝環(huán)境要求
Openclaw的安裝分為兩種方式，一種是直接安裝，另一種是通過(guò)Docker安裝。
直接安裝需要依賴(lài)系統(tǒng)下的Node.js，但Docker無(wú)此要求。Docker的安裝較為簡(jiǎn)單但如果出現(xiàn)問(wèn)題不容易排查（Openclaw的Docker鏡像為了精簡(jiǎn)，缺失大量系統(tǒng)工具），建議有能力的讀者采用直接安裝的方式。
注意：因Openclaw運(yùn)行的權(quán)限較高，可以操作機(jī)器所在文件系統(tǒng)。因AI的行為不可控，可能誤刪除文件或者是破環(huán)系統(tǒng)環(huán)境，造成不可估量的損失。因此建議不要在實(shí)際生產(chǎn)環(huán)境或者主力辦公機(jī)器上安裝。建議使用虛擬機(jī)或者是Docker環(huán)境，限制AI的操作范圍。
直接安裝
安裝Node.js
無(wú)論是Windows還是MacOS，Linux，需要事先安裝Node.js。Openclaw對(duì)Node.js的版本要求較高，如已經(jīng)安裝過(guò)，建議先升級(jí)到新版本。
MacOS 安裝Node.js，需要事先在MacOS中安裝好Homebrew。然后執(zhí)行：
brew install node
安裝Node.js。
Linux或者Windows WSL 安裝Node.js方法和實(shí)際上運(yùn)行的發(fā)行版本有關(guān)?？梢韵萻earch一下已存在的按照包，例如node，nodejs，npm等等。然后再根據(jù)提供的包，和系統(tǒng)中實(shí)際缺失的包的情況再安裝。以Ubuntu為例，可使用如下命令安裝。
apt install nodejs npm
Windows環(huán)境安裝可以從https://nodejs.org/download/release/latest/下載Windows安裝包（exe或者是msi格式文件），然后雙擊按照向?qū)О惭b。
安裝Openclaw
上一步Node.js安裝完畢之后執(zhí)行：
npm config set-registry https://registry.npmmirror.com
npm install -g openclaw@latest
首先設(shè)置Node.js的源為國(guó)內(nèi)源，加快下載速度。然后使用npm全局安裝openclaw的最新版本。
等待第二條命令執(zhí)行完成，openclaw安裝成功。
安裝后配置
Openclaw安裝之后需要簡(jiǎn)單配置下才能使用。
首先執(zhí)行：
openclaw onboard
進(jìn)入配置向?qū)?，首先是安全須知?yè)面
翻到最下面：
選擇Yes繼續(xù)。接著Onboarding mode選擇QuickStart。
接下來(lái)是配置模型提供商。根據(jù)自己申請(qǐng)的模型服務(wù)，選擇對(duì)應(yīng)的模型服務(wù)商，需要準(zhǔn)備好API key。
如果是本地獨(dú)立部署的服務(wù)，選擇vLLM?？梢詫?duì)接vLLM、Ollama等本地模型推理服務(wù)。
注意：經(jīng)過(guò)試用2026.2.x版本中沒(méi)有找到vLLM，使用本地模型服務(wù)的用戶(hù)建議安裝Openclaw的最新版。
這里我們以vLLM為例。
不知道如何安裝Ollama或者vLLm的讀者，可以參考：
Ollama 服務(wù)Docker部署簡(jiǎn)明教程
vLLM 部署和使用簡(jiǎn)介
選擇vLLM之后需要配置vLLM的地址，將其修改為實(shí)際環(huán)境的地址。
接著填寫(xiě)vLLM的API key。不知道API key的用戶(hù)可以在vLLM的運(yùn)行環(huán)境下執(zhí)行
ps -ef | grep vllm
返回示例如下：
root 21140 1 0 Mar05 ? 00:01:04 /root/vllm011/bin/python3 /root/bin/vllm serve /model/Qwen3_32B ... --api-key sk-xxxxxxx --served-model-name Qwen3_32B
找到--api-key參數(shù)，后面的值就是API key，將其復(fù)制到Openclaw安裝向?qū)е小?/p>
對(duì)于Ollama，由于Ollama本身不用配置API key，這一步API key可以任意填寫(xiě)。
緊接著是Model Name配置。同樣，在前面ps命令返回結(jié)果中找到--served-model-name參數(shù)，后面的名稱(chēng)即模型名。
如果使用的是Ollama，可以運(yùn)行ollama list命令，查看模型名。示意圖如下：
填寫(xiě)完模型名稱(chēng)之后，最后需要選擇默認(rèn)模型，這里選擇keep current，即剛剛配置的模型。
接著而來(lái)的是Channel配置。Channel配置可以讓openclaw接入Discord，Slack，國(guó)內(nèi)的飛書(shū)，QQ等IM工具，從而實(shí)現(xiàn)“遠(yuǎn)程控制”的功能。不配置channel的情況下仍可以通過(guò)網(wǎng)頁(yè)對(duì)話(huà)的方式操作Openclaw，并不影響其功能。具體方式在后續(xù)博客內(nèi)介紹。這里選擇最下方的Skip for now跳過(guò)配置。
然后是Skills配置。Skills即Openclaw的能力，可以具體做哪些事，對(duì)接哪些外部系統(tǒng)（例如web搜索，微博，小紅書(shū)等）。這里我們選擇No，暫不配置。
我們繼續(xù)，接下來(lái)是Hooks配置。Hooks可以讓外部系統(tǒng)觸發(fā)Openclaw動(dòng)作。同樣選擇Skip for now跳過(guò)配置。
最后是配置gateway。Gateway即網(wǎng)關(guān)服務(wù)，可以通過(guò)web頁(yè)配置和操作Openclaw。由于這里已經(jīng)安裝過(guò)Gateway，可以選擇Restart，重啟Gateway。
如果是首次接下來(lái)會(huì)自動(dòng)安裝gateway服務(wù)。
如果使用的是openclaw 2026.3.2版本，該步驟在Ubuntu系統(tǒng)下可能會(huì)出現(xiàn)如下錯(cuò)誤：
原因是該版本有bug，建議使用openclaw2026.3.1版本。也可以等待社區(qū)發(fā)布修復(fù)版本后嘗試。安裝openclaw2026.3.1的步驟首先使用
openclaw uninstall
卸載掉openclaw，然后指定版本重新安裝。
npm install -g openclaw@2026.3.1
配置完Gateway之后選擇操作方式（上一步出錯(cuò)的話(huà)，沒(méi)有這一步配置），是在控制臺(tái)中使用還是打開(kāi)瀏覽器Web UI。這里我們選擇Do this later。
配置 gateway
執(zhí)行openclaw gateway status，查看gateway狀態(tài)。如下圖所示：
從上圖我們找到：
Runtime: stopped (state inactive, sub dead, last exit 0, reason 0)
說(shuō)明Gateway處于停止?fàn)顟B(tài)。
執(zhí)行如下命令啟動(dòng)gateway：
openclaw configure --section gateway
選擇This Machine。
填寫(xiě)gateway端口，可以采用默認(rèn)的18789端口。
選擇綁定模式，如果只在本機(jī)訪(fǎng)問(wèn)（127.0.0.1），選擇Loopback，安全性最高。如果想在局域網(wǎng)訪(fǎng)問(wèn)，選擇LAN。這里選擇LAN模式。
接著是gateway認(rèn)證方式選擇，建議選擇token方式。
是否暴露Tailscale，選擇off。
最后一步，如果前面選擇的是token方式認(rèn)證，這里需要指定Gateway token。示例圖如下：
設(shè)置完token之后，gateway配置完成。
執(zhí)行：
openclaw gateway install
安裝gateway服務(wù)。
最后執(zhí)行：
openclaw gateway start
啟動(dòng)Gateway。
Web UI token配置
使用瀏覽器訪(fǎng)問(wèn)http://localhost:18789。出現(xiàn)如下頁(yè)面，并且無(wú)法操作Openclaw：
unauthorized: gateway token missing (open the dashboard URL and paste the token in Control UI settings)
很明顯是沒(méi)有認(rèn)證。
回到命令行執(zhí)行：
openclaw dashboard --no-open
找到下方的Dashboard URL：復(fù)制到瀏覽器打開(kāi)。錯(cuò)誤信息不再提示，大功告成。
可以嘗試在chat頁(yè)面和大模型對(duì)話(huà)。
到此為止Openclaw安裝和配置完成。
Docker安裝
Docker安裝較為簡(jiǎn)單，只有一條命令
執(zhí)行如下命令：
docker run -d --name openclaw -p 18789:18789 -e OPENCLAW_GATEWAY_TOKEN=abcedfg --network host ghcr.io/openclaw/openclaw:2026.3.2
如果鏡像無(wú)法拉取，請(qǐng)查找國(guó)內(nèi)Docker鏡像站獲取鏡像。具體方法可參考其他博客。
需要注意的是，啟動(dòng)Docker鏡像必須指定OPENCLAW_GATEWAY_TOKEN環(huán)境變量，配置gateway的token，否則會(huì)啟動(dòng)失敗。
然后執(zhí)行docker exec -it openclaw bash，進(jìn)入容器內(nèi)再執(zhí)行openclaw onboard開(kāi)始向?qū)渲?。配置過(guò)程和前面直接安裝類(lèi)似。但有一個(gè)問(wèn)題，向?qū)ё詣?dòng)重啟openclaw gateway的時(shí)候容器會(huì)停止執(zhí)行。此時(shí)可以執(zhí)行：
docker start openclaw
再次拉起容器。上次配置的內(nèi)容仍會(huì)保留。
其余配置方式和直接安裝完全相同。如果需要Docker內(nèi)的Openclaw操作本機(jī)文件或者是持久化保存一些資料到本機(jī)磁盤(pán)，可以將目錄掛載到Docker鏡像中。方法為docker run命令增加-v參數(shù)：
docker run -v /your_folder:/home/node ...
Docker安裝Openclaw的方法就介紹到這里。祝各位讀者養(yǎng)蝦快樂(lè)^_^
