OpenClaw(龙虾)本地部署

OpenClaw2026安装指南摘要：本文提供OpenClaw2026的源码安装流程。首先需安装Node.js≥22.x和pnpm包管理器，推荐使用nvm进行版本管理。接着克隆稳定版源码并安装依赖，完成前端与服务构建。通过交互式向导配置模型对接（推荐阿里云百炼）和消息通道。系统支持macOS/Linux/WSL2环境，提供快速安装脚本（curl|bash）和手动安装两种方式，安装后需运行配置向导完

xuwei1210

670人浏览 · 2026-03-11 18:28:08

xuwei1210 · 2026-03-11 18:28:08 发布

源码安装：

（一）前置依赖安装

OpenClaw 2026依赖Node.js ≥22.x与pnpm包管理器，执行以下命令一键配置：

# 安装nvm（Node版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc  # Linux
source ~/.zshrc   # macOS

# 安装Node.js 22
nvm install 22
nvm use 22
nvm alias default 22

# 安装pnpm
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com/

# 验证版本
node -v
pnpm -v
git --version

（二）拉取源码与安装依赖

# 克隆2026稳定版源码
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn
git checkout v2026.2.2-cn

# 安装依赖
pnpm install

# 构建前端与核心服务
pnpm ui:build
pnpm build

（三）初始化配置与模型对接

# 启动交互式配置向导
pnpm openclaw onboard --install-daemon

按提示选择：

同意安全条款
快速配置（QuickStart）
模型厂商选择阿里云百炼（国内稳定）
输入百炼 API Key
消息通道暂时跳过（后续配iMessage）
完成后自动打开控制台：http://127.0.0.1:18789

下次启动命令

重启：pnpm openclaw gateway restart

开启：pnpm openclaw gateway start

停止：pnpm openclaw gateway start

官方推荐安装

除非有特殊原因，否则请使用安装器。它会设置 CLI 并运行新手引导。

快速安装（推荐）

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

下一步（如果你跳过了新手引导）：

openclaw onboard --install-daemon

系统要求

Node >=22
macOS、Linux 或通过 WSL2 的 Windows
pnpm 仅在从源代码构建时需要

选择安装路径

1）安装器脚本（推荐）通过 npm 全局安装 openclaw 并运行新手引导。

curl -fsSL https://openclaw.ai/install.sh | bash

安装器标志：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --help

详情：安装器内部原理。非交互式（跳过新手引导）：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

2）全局安装（手动）如果你已经有 Node：

npm install -g openclaw@latest

如果你全局安装了 libvips（macOS 上通过 Homebrew 安装很常见）且 sharp 安装失败，请强制使用预构建二进制文件：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

如果你看到 sharp: Please add node-gyp to your dependencies，要么安装构建工具（macOS：Xcode CLT + npm install -g node-gyp），要么使用上面的 SHARP_IGNORE_GLOBAL_LIBVIPS=1 变通方法来跳过原生构建。或使用 pnpm：

pnpm add -g openclaw@latest
pnpm approve-builds -g                # 批准 openclaw、node-llama-cpp、sharp 等
pnpm add -g openclaw@latest           # 重新运行以执行 postinstall 脚本

pnpm 需要显式批准带有构建脚本的包。在首次安装显示”Ignored build scripts”警告后，运行 pnpm approve-builds -g 并选择列出的包，然后重新运行安装以执行 postinstall 脚本。然后：