Skip to main content

​
安装 OpenClaw

OpenClaw 是一个多渠道 AI 网关,支持可扩展的消息集成。本指南将帮助您选择最适合的安装方式。

​
系统要求

在开始安装之前,请确保您的系统满足以下要求:
  • Node.js 22+ (如果缺失,安装脚本会自动安装)
  • macOS、Linux 或 Windows
  • 仅当从源码构建时需要 pnpm
在 Windows 上,我们强烈推荐在 WSL2 下运行 OpenClaw。
对于 VPS/云主机,尽量避免使用第三方的”单击安装”市场镜像。建议使用干净的基础操作系统镜像(例如 Ubuntu LTS),然后用安装脚本自行安装 OpenClaw。

​
推荐安装方式

​
使用安装脚本 (推荐)

安装脚本是推荐的 OpenClaw 安装方式,它一步完成 Node 的检测、安装和引导流程。 
curl -fsSL https://openclaw.ai/install.sh | bash
就这样!脚本会处理 Node 检测、安装和引导。 若想跳过引导,直接安装二进制文件: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

​
其他安装方式

​
使用 npm 或 pnpm

如果您已经有 Node 22+ 并且想自己管理安装: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
如果您全局安装了 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)或者使用上面提到的环境变量。

​
从源码安装

适用于贡献者或希望从本地代码库运行的用户。
1

克隆并构建

克隆 OpenClaw 仓库 并构建:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
2

链接 CLI

使 openclaw 命令在全局可用:
pnpm link --global
或者,您也可以跳过链接,直接在仓库目录内使用 pnpm openclaw ... 运行命令。
3

运行引导

openclaw onboard --install-daemon

​
容器化安装

Docker

容器化或无头部署

Podman

无根容器:执行一次 setup-podman.sh,然后运行启动脚本

​
其他安装选项

Nix

通过 Nix 的声明式安装

Ansible

自动化集群配置

Bun

仅通过 Bun 运行时使用 CLI

​
安装后验证

验证一切正常: 
openclaw doctor         # 检查配置问题
openclaw status         # 网关状态
openclaw dashboard      # 打开浏览器 UI
如果需要自定义运行时路径,请使用:
  • OPENCLAW_HOME 指定基于家目录的内部路径
  • OPENCLAW_STATE_DIR 指定可变状态存储位置
  • OPENCLAW_CONFIG_PATH 指定配置文件位置

​
故障排查:找不到 openclaw

快速诊断:
node -v
npm -v
npm prefix -g
echo "$PATH"
如果 $(npm prefix -g)/bin(macOS/Linux)或 $(npm prefix -g)(Windows)不在您的 $PATH 中,shell 无法找到全局 npm 二进制(包含 openclaw)。修复方法——添加到 shell 启动文件(~/.zshrc 或 ~/.bashrc):
export PATH="$(npm prefix -g)/bin:$PATH"
Windows 上,将 npm prefix -g 的输出路径添加到 PATH 环境变量。然后打开新终端(或在 zsh 中执行 rehash,bash 中执行 hash -r)。

​
下一步

更新

保持 OpenClaw 最新

配置

配置您的 OpenClaw 实例

环境变量

了解环境变量配置