2026年2026最新｜OpenCloud龙虾（OpenClaw）保姆级安装教程（全平台+避坑）

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

前言

OpenClaw（业内俗称龙虾）是开源AI代理框架，支持多模型接入、飞书/Telegram集成、本地/云端部署，零门槛搭建私人AI助理。本文覆盖Windows/macOS/Linux/Docker四种安装方式，从环境准备到启动验证全流程，新手也能一次成功。

一、部署前核心准备

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（国内配置镜像加速）

二、全平台基础依赖安装

🔹 Windows（管理员PowerShell执行）

安装NVM（Node版本管理，避免版本冲突）

iwr -useb https://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 registry https://registry.npmmirror.com/

解决执行策略报错（必做）

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

🔹 macOS（终端执行）

安装Homebrew（已安装跳过）

/bin/bash -c “$(curl -fsSL https://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 registry https://registry.npmmirror.com/

🔹 Linux（Ubuntu/Debian）

安装Node.js22源

curl -fsSL https://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 registry https://registry.npmmirror.com/

🔹 依赖验证

执行以下命令，输出版本号即成功

node -v # ≥22.0

npm -v

git -v

pnpm -v

三、四种安装方式（按需选择）

方式1：一键脚本安装（新手首选，5分钟搞定）

国内加速脚本（解决GitHub访问失败）

# macOS/Linux

curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/118/OpenClawChineseTranslation@main/install.sh && bash install.sh

# Windows（PowerShell）

iwr -useb https://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 clone https://github.com/openclaw/openclaw.git

cd openclaw

# 复制环境配置

cp .env.example .env

# 编辑.env填入大模型API Key

# 构建并启动

docker-compose up -d

验证容器运行

docker ps # 查看openclaw容器状态

方式4：源码编译安装（开发者自定义）

克隆源码

git clone https://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. 访问验证

本地访问：http://localhost:18789

远程访问：服务器IP:18789

五、进阶配置（可选）

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工作流。

本文基于2026年3月最新版OpenClaw编写，脚本与镜像均为国内加速版，适配国内网络环境。

2026年2026最新｜OpenCloud龙虾（OpenClaw）保姆级安装教程（全平台+避坑）

相关推荐