??提示：資源鏈接地址放在文章結(jié)尾，往下翻就行

一、部署前核心準(zhǔn)備

1. 硬件與系統(tǒng)要求

配置項(xiàng)

最低要求

推薦配置

操作系統(tǒng)

Win10+/macOS12+/Ubuntu20.04+

Win11/macOS14+/Ubuntu22.04

內(nèi)存

4GB

8GB+

磁盤(pán)

2GB可用空間

10GB+ SSD

核心依賴

Node.js≥18.0

Node.js22.x LTS（必選，避坑關(guān)鍵）

2. 必備工具與憑證

Git：用于拉取源碼/更新

包管理器：npm/pnpm（推薦pnpm，速度更快）

大模型API Key：阿里云百煉/MiniMax/DeepSeek/Claude任選其一

網(wǎng)絡(luò)：可訪問(wèn)GitHub/npm（國(guó)內(nèi)配置鏡像加速）

【OpenClaw】安裝鏈接：https://pan.xunlei.com/s/VOnQTdQwGwij2Hva-hb7aqRuA1?pwd=h2f5#

（復(fù)制這段內(nèi)容后打開(kāi)迅雷，查看更方便）注：速存！資源會(huì)被和諧或轉(zhuǎn)換成其他文件

(打不開(kāi)換個(gè)瀏覽器即可，手機(jī)用戶別用百度瀏覽器）

??提示：更多觀影資源鏈接在文章中間，往下翻就行

??【更多游戲資源】鏈接：https://pan.xunlei.com/s/VOnQUGzM4FORI6A4_3tUWiCGA1?pwd=4e59#

??「筆趣閣小說(shuō)合集 」鏈接：https://pan.quark.cn/s/c694b99ebd6b?pwd=vhTG

??「熱門(mén)言情小說(shuō)大合集」鏈接:https://pan.baidu.com/s/1_JX8ak8UULtHlnz7lgxCOg?pwd=b2vr

??更多「國(guó)產(chǎn)珍藏電影合集」鏈接：https://pan.quark.cn/s/ef1892bb41ce?pwd=Vgrt

??更多【日韓歐美珍藏電影合集】鏈接：https://pan.quark.cn/s/e1797111e859?pwd=m7Q4

??《啄木鳥(niǎo)系列全集》鏈接：https://pan.xunlei.com/s/VOi8D_IMfBm8XlW3vPQmxFe3A1?pwd=4mqk#

??更多【熱門(mén)影視資源大全】鏈接：https://pan.xunlei.com/s/VOYej375a_Tp0fCD4yohm-guA1?pwd=isuf#

??【粉S專(zhuān)屬資源】鏈接：https://pan.quark.cn/s/f3f77a7f2cff?pwd=DizX

??【各國(guó)高清影視】：https://pan.quark.cn/s/a467ed1ec985?pwd=KYsw

??「B看視頻」鏈接：https://pan.quark.cn/s/e65c5ef7ab85?pwd=tUwd

??【最新學(xué)習(xí)資料】鏈接：https://pan.xunlei.com/s/VOlto-oc9dgZ3pT7N5soqvRkA1?pwd=62tm#

??「最新趣事」鏈接：https://pan.quark.cn/s/802cb379110e?pwd=Xe9J

??「豆瓣電影Top250」鏈接：https://pan.quark.cn/s/7001767a3e89?pwd=rUB8

??「豆瓣小說(shuō)Top250」鏈接：https://pan.quark.cn/s/5fe89c5659ca?pwd=AFun

二、全平臺(tái)基礎(chǔ)依賴安裝

Windows（管理員PowerShell執(zhí)行）

安裝NVM（Node版本管理，避免版本沖突）

iwr -usebhttps://raw.githubusercontent.com/coreybutler/nvm-windows/master/nvm-setup.exe| iex

安裝并啟用Node.js22

nvm install 22

nvm use 22.22.0

安裝Git與pnpm，配置國(guó)內(nèi)鏡像

# 安裝Git（官網(wǎng)下載后勾選Add to PATH）

npm install -g pnpm

pnpm config set registryhttps://registry.npmmirror.com/

解決執(zhí)行策略報(bào)錯(cuò)（必做）

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

macOS（終端執(zhí)行）

安裝Homebrew（已安裝跳過(guò)）

/bin/bash -c "$(curl -fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝Node.js22+Git

brew install node@22 git

brew link node@22 --overwrite

安裝pnpm并配置鏡像

npm install -g pnpm

pnpm config set registryhttps://registry.npmmirror.com/

Linux（Ubuntu/Debian）

安裝Node.js22源

curl -fsSLhttps://deb.nodesource.com/setup_22.x| sudo -E bash -

sudo apt install -y nodejs git build-essential

安裝pnpm與鏡像配置

npm install -g pnpm

pnpm config set registryhttps://registry.npmmirror.com/

依賴驗(yàn)證

執(zhí)行以下命令，輸出版本號(hào)即成功

node -v # ≥22.0

npm -v

git -v

pnpm -v

三、四種安裝方式（按需選擇）

方式1：一鍵腳本安裝（新手首選，5分鐘搞定）

國(guó)內(nèi)加速腳本（解決GitHub訪問(wèn)失?。?/p>

# macOS/Linux

curl -fsSL -oinstall.shhttps://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh&& bashinstall.sh

# Windows（PowerShell）

iwr -usebhttps://openclaw.ai/install.ps1| iex

驗(yàn)證安裝

openclaw --version # 輸出版本號(hào)即成功

方式2：npm全局安裝（穩(wěn)定兼容）

# npm安裝

npm install -g openclaw@latest

# pnpm安裝（更快）

pnpm add -g openclaw@latest

方式3：Docker部署（服務(wù)器/無(wú)環(huán)境沖突首選）

安裝Docker與Docker Compose

拉取鏡像并啟動(dòng)

# 克隆倉(cāng)庫(kù)

git clonehttps://github.com/openclaw/openclaw.git

cd openclaw

# 復(fù)制環(huán)境配置

cp .env.example .env

# 編輯.env填入大模型API Key

# 構(gòu)建并啟動(dòng)

docker-compose up -d

驗(yàn)證容器運(yùn)行

docker ps # 查看openclaw容器狀態(tài)

方式4：源碼編譯安裝（開(kāi)發(fā)者自定義）

克隆源碼

git clonehttps://github.com/openclaw/openclaw.git

cd openclaw

安裝項(xiàng)目依賴

pnpm install

構(gòu)建并鏈接全局命令

pnpm build

pnpm link --global

四、初始化配置與啟動(dòng)

1. 啟動(dòng)配置向?qū)?/p>

openclaw onboard

向?qū)Ы换ゲ襟E

同意風(fēng)險(xiǎn)提示：輸入Yes

啟動(dòng)模式：選擇Quick Start（快速啟動(dòng)）

設(shè)置管理員密碼：自定義8位以上密碼

填入大模型API Key：粘貼提前準(zhǔn)備的密鑰

開(kāi)啟功能：語(yǔ)音/畫(huà)布/插件按需開(kāi)啟

2. 啟動(dòng)服務(wù)

# 啟動(dòng)網(wǎng)關(guān)服務(wù)

openclaw gateway start

# 安裝系統(tǒng)守護(hù)進(jìn)程（開(kāi)機(jī)自啟，服務(wù)器必選）

openclaw onboard --install-daemon

3. 端口放行（遠(yuǎn)程訪問(wèn)必做）

默認(rèn)端口：18789

# Linux/macOS

sudo ufw allow 18789/tcp

sudo ufw reload

# Windows防火墻：放行18789端口入站規(guī)則

4. 訪問(wèn)驗(yàn)證

本地訪問(wèn)：http://localhost:18789

遠(yuǎn)程訪問(wèn)：服務(wù)器IP:18789

登錄：輸入管理員密碼/生成的Token

五、進(jìn)階配置（可選）

1. 多模型接入配置

openclaw config set 'models.providers.ollama' --json '{

"baseUrl": "http://localhost:11434/v1",

"apiKey": "ollama"

}'

2. 飛書(shū)機(jī)器人集成

飛書(shū)開(kāi)放平臺(tái)創(chuàng)建自建應(yīng)用，開(kāi)啟機(jī)器人能力

安裝飛書(shū)插件依賴

cd ~/.openclaw/extensions/feishu

pnpm install

配置應(yīng)用憑證與事件回調(diào)，重啟服務(wù)生效

六、常見(jiàn)問(wèn)題避坑

Node版本過(guò)低報(bào)錯(cuò)

解決：用NVM切換至22.x，刪除舊版本Node

端口被占用

解決：lsof -i:18789殺死占用進(jìn)程，或修改配置文件端口

npm安裝失敗

解決：切換pnpm、清理緩存pnpm cache clean --force

遠(yuǎn)程無(wú)法訪問(wèn)

解決：服務(wù)器安全組放行18789端口，檢查防火墻規(guī)則

API Key無(wú)效

解決：核對(duì)密鑰權(quán)限，確認(rèn)模型服務(wù)商區(qū)域支持

七、卸載方法

# 全局卸載

npm uninstall -g openclaw

pnpm remove -g openclaw

# 刪除配置文件

rm -rf ~/.openclaw

結(jié)語(yǔ)

OpenClaw龍蝦的核心門(mén)檻僅在Node版本與端口配置，按本文步驟操作基本零失敗。部署完成后可接入各類(lèi)大模型、集成辦公工具，打造專(zhuān)屬AI工作流。