Docs: add zh-CN translations

docs/zh-CN/install/index.md

@@ -0,0 +1,193 @@
+---
+read_when:
+  - 安装 OpenClaw
+  - 你想从 GitHub 安装
+summary: 安装 OpenClaw（推荐安装器、全局安装或从源码安装）
+title: 安装
+x-i18n:
+  generated_at: "2026-02-01T21:07:34Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: b26f48c116c26c163ee0090fb4c3e29622951bd427ecaeccba7641d97cfdf17a
+  source_path: install/index.md
+  workflow: 14
+---
+
+# 安装
+
+除非有特殊原因，否则请使用安装器。它会设置 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 克隆/构建并从源码检出运行
+
+### CLI 参数
+
+```bash
+# 显式使用 npm
+curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm
+
+# 从 GitHub 安装（源码检出）
+curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
+```
+
+常用参数：
+
+- `--install-method npm|git`
+- `--git-dir <path>`（默认：`~/openclaw`）
+- `--no-git-update`（使用已有检出时跳过 `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)