mirror of
https://github.com/openclaw/openclaw.git
synced 2026-03-17 13:00:48 +00:00
a3ec2d0734
What: - update zh-CN glossary, TM, and translator prompt - regenerate zh-CN docs and apply targeted fixes - add zh-CN AGENTS pipeline guidance Why: - address terminology/spacing feedback from #6995 Tests: - pnpm build && pnpm check && pnpm test
194 lines
4.9 KiB
Markdown
194 lines
4.9 KiB
Markdown
---
|
||
read_when:
|
||
- 安装 OpenClaw
|
||
- 你想从 GitHub 安装
|
||
summary: 安装 OpenClaw（推荐安装器、全局安装或从源代码安装）
|
||
title: 安装
|
||
x-i18n:
|
||
generated_at: "2026-02-03T10:07:43Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: b26f48c116c26c163ee0090fb4c3e29622951bd427ecaeccba7641d97cfdf17a
|
||
source_path: install/index.md
|
||
workflow: 15
|
||
---
|
||
|
||
# 安装
|
||
|
||
除非有特殊原因，否则请使用安装器。它会设置 CLI 并运行新手引导。
|
||
|
||
## 快速安装（推荐）
|
||
|
||
```bash
|
||
curl -fsSL https://openclaw.ai/install.sh | bash
|
||
```
|
||
|
||
Windows（PowerShell）：
|
||
|
||
```powershell
|
||
iwr -useb https://openclaw.ai/install.ps1 | iex
|
||
```
|
||
|
||
下一步（如果你跳过了新手引导）：
|
||
|
||
```bash
|
||
openclaw onboard --install-daemon
|
||
```
|
||
|
||
## 系统要求
|
||
|
||
- **Node >=22**
|
||
- macOS、Linux 或通过 WSL2 的 Windows
|
||
- `pnpm` 仅在从源代码构建时需要
|
||
|
||
## 选择安装路径
|
||
|
||
### 1）安装器脚本（推荐）
|
||
|
||
通过 npm 全局安装 `openclaw` 并运行新手引导。
|
||
|
||
```bash
|
||
curl -fsSL https://openclaw.ai/install.sh | bash
|
||
```
|
||
|
||
安装器标志：
|
||
|
||
```bash
|
||
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --help
|
||
```
|
||
|
||
详情：[安装器内部原理](/install/installer)。
|
||
|
||
非交互式（跳过新手引导）：
|
||
|
||
```bash
|
||
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
|
||
```
|
||
|
||
### 2）全局安装（手动）
|
||
|
||
如果你已经有 Node：
|
||
|
||
```bash
|
||
npm install -g openclaw@latest
|
||
```
|
||
|
||
如果你全局安装了 libvips（macOS 上通过 Homebrew 安装很常见）且 `sharp` 安装失败，请强制使用预构建二进制文件：
|
||
|
||
```bash
|
||
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：
|
||
|
||
```bash
|
||
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 脚本。
|
||
|
||
然后：
|
||
|
||
```bash
|
||
openclaw onboard --install-daemon
|
||
```
|
||
|
||
### 3）从源代码（贡献者/开发）
|
||
|
||
```bash
|
||
git clone https://github.com/openclaw/openclaw.git
|
||
cd openclaw
|
||
pnpm install
|
||
pnpm ui:build # 首次运行时自动安装 UI 依赖
|
||
pnpm build
|
||
openclaw onboard --install-daemon
|
||
```
|
||
|
||
提示：如果你还没有全局安装，请通过 `pnpm openclaw ...` 运行仓库命令。
|
||
|
||
### 4）其他安装选项
|
||
|
||
- Docker：[Docker](/install/docker)
|
||
- Nix：[Nix](/install/nix)
|
||
- Ansible：[Ansible](/install/ansible)
|
||
- Bun（仅 CLI）：[Bun](/install/bun)
|
||
|
||
## 安装后
|
||
|
||
- 运行新手引导：`openclaw onboard --install-daemon`
|
||
- 快速检查：`openclaw doctor`
|
||
- 检查 Gateway 网关健康状态：`openclaw status` + `openclaw health`
|
||
- 打开仪表板：`openclaw dashboard`
|
||
|
||
## 安装方式：npm vs git（安装器）
|
||
|
||
安装器支持两种方式：
|
||
|
||
- `npm`（默认）：`npm install -g openclaw@latest`
|
||
- `git`：从 GitHub 克隆/构建并从源代码 checkout 运行
|
||
|
||
### CLI 标志
|
||
|
||
```bash
|
||
# 显式 npm
|
||
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm
|
||
|
||
# 从 GitHub 安装（源代码 checkout）
|
||
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
|
||
```
|
||
|
||
常用标志：
|
||
|
||
- `--install-method npm|git`
|
||
- `--git-dir <path>`（默认：`~/openclaw`）
|
||
- `--no-git-update`（使用现有 checkout 时跳过 `git pull`）
|
||
- `--no-prompt`（禁用提示；CI/自动化中必需）
|
||
- `--dry-run`（打印将要执行的操作；不做任何更改）
|
||
- `--no-onboard`（跳过新手引导）
|
||
|
||
### 环境变量
|
||
|
||
等效的环境变量（对自动化有用）：
|
||
|
||
- `OPENCLAW_INSTALL_METHOD=git|npm`
|
||
- `OPENCLAW_GIT_DIR=...`
|
||
- `OPENCLAW_GIT_UPDATE=0|1`
|
||
- `OPENCLAW_NO_PROMPT=1`
|
||
- `OPENCLAW_DRY_RUN=1`
|
||
- `OPENCLAW_NO_ONBOARD=1`
|
||
- `SHARP_IGNORE_GLOBAL_LIBVIPS=0|1`（默认：`1`；避免 `sharp` 针对系统 libvips 构建）
|
||
|
||
## 故障排除：找不到 `openclaw`（PATH）
|
||
|
||
快速诊断：
|
||
|
||
```bash
|
||
node -v
|
||
npm -v
|
||
npm prefix -g
|
||
echo "$PATH"
|
||
```
|
||
|
||
如果 `$(npm prefix -g)/bin`（macOS/Linux）或 `$(npm prefix -g)`（Windows）**不**在 `echo "$PATH"` 的输出中，你的 shell 无法找到全局 npm 二进制文件（包括 `openclaw`）。
|
||
|
||
修复：将其添加到你的 shell 启动文件（zsh：`~/.zshrc`，bash：`~/.bashrc`）：
|
||
|
||
```bash
|
||
# macOS / Linux
|
||
export PATH="$(npm prefix -g)/bin:$PATH"
|
||
```
|
||
|
||
在 Windows 上，将 `npm prefix -g` 的输出添加到你的 PATH。
|
||
|
||
然后打开新终端（或在 zsh 中执行 `rehash` / 在 bash 中执行 `hash -r`）。
|
||
|
||
## 更新/卸载
|
||
|
||
- 更新：[更新](/install/updating)
|
||
- 迁移到新机器：[迁移](/install/migrating)
|
||
- 卸载：[卸载](/install/uninstall)
|