提示：資源鏈接地址放在文章結(jié)尾，往下翻就行
一、部署前核心準(zhǔn)備
1. 硬件與系統(tǒng)要求
配置項
最低要求
推薦配置
操作系統(tǒng)
Win10+/macOS12+/Ubuntu20.04+
Win11/macOS14+/Ubuntu22.04
內(nèi)存
4GB
8GB+
磁盤
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ò)：可訪問GitHub/npm（國內(nèi)配置鏡像加速）
【OpenClaw】安裝鏈接：https://pan.xunlei.com/s/VOnQTdQwGwij2Hva-hb7aqRuA1?pwd=h2f5#
（復(fù)制這段內(nèi)容后打開迅雷，查看更方便）注：速存！資源會被和諧或轉(zhuǎn)換成其他文件
二、全平臺基礎(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，配置國內(nèi)鏡像
# 安裝Git（官網(wǎng)下載后勾選Add to PATH）
npm install -g pnpm
pnpm config set registryhttps://registry.npmmirror.com/
解決執(zhí)行策略報錯（必做）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
macOS（終端執(zhí)行）
安裝Homebrew（已安裝跳過）
/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/
依賴驗證
執(zhí)行以下命令，輸出版本號即成功
node -v # ≥22.0
npm -v
git -v
pnpm -v
三、四種安裝方式（按需選擇）
方式1：一鍵腳本安裝（新手首選，5分鐘搞定）
國內(nèi)加速腳本（解決GitHub訪問失?。?/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
驗證安裝
openclaw --version # 輸出版本號即成功
方式2：npm全局安裝（穩(wěn)定兼容）
# npm安裝
npm install -g openclaw@latest
# pnpm安裝（更快）
pnpm add -g openclaw@latest
方式3：Docker部署（服務(wù)器/無環(huán)境沖突首選）
安裝Docker與Docker Compose
拉取鏡像并啟動
# 克隆倉庫
git clonehttps://github.com/openclaw/openclaw.git
cd openclaw
# 復(fù)制環(huán)境配置
cp .env.example .env
# 編輯.env填入大模型API Key
# 構(gòu)建并啟動
docker-compose up -d
驗證容器運行
docker ps # 查看openclaw容器狀態(tài)
方式4：源碼編譯安裝（開發(fā)者自定義）
克隆源碼
git clonehttps://github.com/openclaw/openclaw.git
cd openclaw
安裝項目依賴
pnpm install
構(gòu)建并鏈接全局命令
pnpm build
pnpm link --global
四、初始化配置與啟動
1. 啟動配置向?qū)?/p>
openclaw onboard
向?qū)Ы换ゲ襟E
同意風(fēng)險提示：輸入Yes
啟動模式：選擇Quick Start（快速啟動）
設(shè)置管理員密碼：自定義8位以上密碼
填入大模型API Key：粘貼提前準(zhǔn)備的密鑰
開啟功能：語音/畫布/插件按需開啟
2. 啟動服務(wù)
# 啟動網(wǎng)關(guān)服務(wù)
openclaw gateway start
# 安裝系統(tǒng)守護(hù)進(jìn)程（開機(jī)自啟，服務(wù)器必選）
openclaw onboard --install-daemon
3. 端口放行（遠(yuǎn)程訪問必做）
默認(rèn)端口：18789
# Linux/macOS
sudo ufw allow 18789/tcp
sudo ufw reload
# Windows防火墻：放行18789端口入站規(guī)則
4. 訪問驗證
遠(yuǎn)程訪問：服務(wù)器IP:18789
登錄：輸入管理員密碼/生成的Token
五、進(jìn)階配置（可選）
1. 多模型接入配置
openclaw config set 'models.providers.ollama' --json '{
"baseUrl": "http://localhost:11434/v1",
"apiKey": "ollama"
}'
2. 飛書機(jī)器人集成
飛書開放平臺創(chuàng)建自建應(yīng)用，開啟機(jī)器人能力
安裝飛書插件依賴
cd ~/.openclaw/extensions/feishu
pnpm install
配置應(yīng)用憑證與事件回調(diào)，重啟服務(wù)生效
六、常見問題避坑
Node版本過低報錯
解決：用NVM切換至22.x，刪除舊版本Node
端口被占用
解決：lsof -i:18789殺死占用進(jìn)程，或修改配置文件端口
npm安裝失敗
解決：切換pnpm、清理緩存pnpm cache clean --force
遠(yuǎn)程無法訪問
解決：服務(wù)器安全組放行18789端口，檢查防火墻規(guī)則
API Key無效
解決：核對密鑰權(quán)限，確認(rèn)模型服務(wù)商區(qū)域支持
七、卸載方法
# 全局卸載
npm uninstall -g openclaw
pnpm remove -g openclaw
# 刪除配置文件
rm -rf ~/.openclaw
結(jié)語
OpenClaw龍蝦的核心門檻僅在Node版本與端口配置，按本文步驟操作基本零失敗。部署完成后可接入各類大模型、集成辦公工具，打造專屬AI工作流。
