📢提示：资源链接地址放在文章结尾，往下翻就行
一、部署前核心准备
1. 硬件与系统要求
配置项
最低要求
推荐配置
操作系统
Win10+/macOS12+/Ubuntu20.04+
Win11/macOS14+/Ubuntu22.04
内存
4GB
8GB+
磁盘
2GB可用空间
10GB+ SSD
核心依赖
Node.js≥18.0
Node.js22.x LTS（必选，避坑关键）
2. 必备工具与凭证
Git：用于拉取源码/更新
包管理器：npm/pnpm（推荐pnpm，速度更快）
大模型API Key：阿里云百炼/MiniMax/DeepSeek/Claude任选其一
网络：可访问GitHub/npm（国内配置镜像加速）
【OpenClaw】安装链接：https://pan.xunlei.com/s/VOnQTdQwGwij2Hva-hb7aqRuA1?pwd=h2f5#
（复制这段内容后打开迅雷，查看更方便）注：速存！资源会被和谐或转换成其他文件
(打不开换个浏览器即可，手机用户别用百度浏览器）
📢提示：更多观影资源链接在文章中间，往下翻就行
📢【更多游戏资源】链接：https://pan.xunlei.com/s/VOnQUGzM4FORI6A4_3tUWiCGA1?pwd=4e59#
📢「笔趣阁小说合集 」链接：https://pan.quark.cn/s/c694b99ebd6b?pwd=vhTG
📢「热门言情小说大合集」链接:https://pan.baidu.com/s/1_JX8ak8UULtHlnz7lgxCOg?pwd=b2vr
📢更多「国产珍藏电影合集」链接：https://pan.quark.cn/s/ef1892bb41ce?pwd=Vgrt
📢更多【日韩欧美珍藏电影合集】链接：https://pan.quark.cn/s/e1797111e859?pwd=m7Q4
📢《啄木鸟系列全集》链接：https://pan.xunlei.com/s/VOi8D_IMfBm8XlW3vPQmxFe3A1?pwd=4mqk#
📢更多【热门影视资源大全】链接：https://pan.xunlei.com/s/VOYej375a_Tp0fCD4yohm-guA1?pwd=isuf#
📢【粉S专属资源】链接：https://pan.quark.cn/s/f3f77a7f2cff?pwd=DizX
📢【各国高清影视】：https://pan.quark.cn/s/a467ed1ec985?pwd=KYsw
📢「B看视频」链接：https://pan.quark.cn/s/e65c5ef7ab85?pwd=tUwd
📢【最新学习资料】链接：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
📕「豆瓣小说Top250」链接：https://pan.quark.cn/s/5fe89c5659ca?pwd=AFun
二、全平台基础依赖安装
Windows（管理员PowerShell执行）
安装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，配置国内镜像
# 安装Git（官网下载后勾选Add to PATH）
npm install -g pnpm
pnpm config set registryhttps://registry.npmmirror.com/
解决执行策略报错（必做）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
macOS（终端执行）
安装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/
依赖验证
执行以下命令，输出版本号即成功
node -v # ≥22.0
npm -v
git -v
pnpm -v
三、四种安装方式（按需选择）
方式1：一键脚本安装（新手首选，5分钟搞定）
国内加速脚本（解决GitHub访问失败）
# 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全局安装（稳定兼容）
# npm安装
npm install -g openclaw@latest
# pnpm安装（更快）
pnpm add -g openclaw@latest
方式3：Docker部署（服务器/无环境冲突首选）
安装Docker与Docker Compose
拉取镜像并启动
# 克隆仓库
git clonehttps://github.com/openclaw/openclaw.git
cd openclaw
# 复制环境配置
cp .env.example .env
# 编辑.env填入大模型API Key
# 构建并启动
docker-compose up -d
验证容器运行
docker ps # 查看openclaw容器状态
方式4：源码编译安装（开发者自定义）
克隆源码
git clonehttps://github.com/openclaw/openclaw.git
cd openclaw
安装项目依赖
pnpm install
构建并链接全局命令
pnpm build
pnpm link --global
四、初始化配置与启动
1. 启动配置向导
openclaw onboard
向导交互步骤
同意风险提示：输入Yes
启动模式：选择Quick Start（快速启动）
设置管理员密码：自定义8位以上密码
填入大模型API Key：粘贴提前准备的密钥
开启功能：语音/画布/插件按需开启
2. 启动服务
# 启动网关服务
openclaw gateway start
# 安装系统守护进程（开机自启，服务器必选）
openclaw onboard --install-daemon
3. 端口放行（远程访问必做）
默认端口：18789
# Linux/macOS
sudo ufw allow 18789/tcp
sudo ufw reload
# Windows防火墙：放行18789端口入站规则
4. 访问验证
远程访问：服务器IP:18789
登录：输入管理员密码/生成的Token
五、进阶配置（可选）
1. 多模型接入配置
openclaw config set 'models.providers.ollama' --json '{
"baseUrl": "http://localhost:11434/v1",
"apiKey": "ollama"
}'
2. 飞书机器人集成
飞书开放平台创建自建应用，开启机器人能力
安装飞书插件依赖
cd ~/.openclaw/extensions/feishu
pnpm install
配置应用凭证与事件回调，重启服务生效
六、常见问题避坑
Node版本过低报错
解决：用NVM切换至22.x，删除旧版本Node
端口被占用
解决：lsof -i:18789杀死占用进程，或修改配置文件端口
npm安装失败
解决：切换pnpm、清理缓存pnpm cache clean --force
远程无法访问
解决：服务器安全组放行18789端口，检查防火墙规则
API Key无效
解决：核对密钥权限，确认模型服务商区域支持
七、卸载方法
# 全局卸载
npm uninstall -g openclaw
pnpm remove -g openclaw
# 删除配置文件
rm -rf ~/.openclaw
结语
OpenClaw龙虾的核心门槛仅在Node版本与端口配置，按本文步骤操作基本零失败。部署完成后可接入各类大模型、集成办公工具，打造专属AI工作流。
