02-安装指南

概述

已经按照 Getting Started 操作？您已经设置好了——本页面介绍替代安装方法、平台特定说明和维护。

1.npm 全局安装

npm install -g openclaw

2.Git 源码安装（可 hack 版本）**

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

3.Docker 安装

参见 Docker 安装指南

验证一切正常工作：

openclaw doctor          # 检查配置问题
openclaw status          # 网关状态
openclaw dashboard       # 打开浏览器 UI

快速诊断：

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 update

或指定版本：

npm install -g openclaw@latest

npm uninstall -g openclaw

删除状态目录（警告：这将删除所有配置和会话）

rm -rf ~/.openclaw