OpenClaw（龙虾）安装指南：系统要求、安装方式与验证

本文根据 OpenClaw 官方 Getting Started、Commands 文档和官方 GitHub 仓库整理，适合作为中文安装入口。

官方来源

• 官方主页
• What is OpenClaw?
• System Requirements
• Installation
• Setup & Initialization
• 官方 GitHub 仓库

安装前先确认

• 官方要求 Linux 5.4+、macOS 13+，或 Windows 10+ 并配合 WSL 2。
• Node.js 最低要求为 22.16.0，官方推荐 Node.js 24；npm 建议 10+。
• 最低资源建议为 2 GB RAM、1 GB 磁盘和 1 核 CPU；长期使用建议至少 4 GB RAM 和 5 GB 磁盘。
• 如果你要使用 sandboxed skills，官方建议准备 Docker 24+。
• 如果后续接 Slack、Telegram 等 webhook，官方要求实例具备可访问的公网地址。

安装方式一：Quick Install

Linux / macOS

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

Windows（PowerShell / WSL 2）

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

• 官方文档说明脚本会自动安装 OpenClaw，并继续执行 onboarding 流程。
• Windows 最佳体验仍然是 WSL 2 + Ubuntu；如果直接在 PowerShell 运行，建议先确认执行策略允许脚本运行。
• 如需自定义安装目录，可先设置 `OPENCLAW_HOME`。

安装方式二：npm / pnpm

npm install -g openclaw@latest
# or: pnpm add -g openclaw@latest
openclaw onboard --install-daemon

• 这种方式适合你想手动掌控安装步骤。
• `openclaw onboard --install-daemon` 会继续安装和初始化 Gateway / daemon。

安装方式三：源码安装

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm link --global
openclaw onboard --install-daemon

• 官方仓库 README 和 Installation 文档都给出了源码安装路径。
• 如果你要二次开发、调试或自定义构建，建议走这一条。

安装完成后如何验证

openclaw --version
openclaw doctor
openclaw status
openclaw dashboard

• `openclaw --version` 用来确认 CLI 已正常安装。
• `openclaw doctor` 会检查 Node.js、依赖和环境状态。
• `openclaw status` 可以确认服务状态。
• `openclaw dashboard` 会打开 Web 控制台，是最直观的验证方式。

常见安装问题

• 如果 `node: command not found`，先检查 Node.js 是否装好并且已加入 PATH。
• 如果全局安装权限不足，优先调整 npm prefix，不建议直接长期使用 `sudo npm`。
• 如果构建过程内存不足，可临时增加 `NODE_OPTIONS="--max-old-space-size=4096"`。
• 如果 WSL 中缺少 `curl`，先执行 `sudo apt update && sudo apt install -y curl`。
• 如果 3000 端口被占用，按官方配置文档修改 `server.port` 或环境变量后再启动。

下一步

• 完成安装后继续阅读 Configuration 配置提供商、模型和管理员信息。
• 首次进入后台前，建议立即修改默认管理员密码。
• 如果你要深入接入频道、技能和源码能力，继续查看 官方 GitHub 仓库 和官方命令文档。

备注

• 本文内容已于 2026-04-09 对照官方公开文档核对。
• 如官方安装命令或系统要求更新，应以官方文档为准。