Add installation guides for OpenClaw and uv package manager

2026-04-28 12:56:13 +08:00
parent 2830a10a1b
commit b13cd32d6a
34 changed files with 0 additions and 0 deletions
@@ -0,0 +1,117 @@
+# OpenClaw Windows 安装教程
+
+## 教学链接
+
+[‬‍‍‌‌⁠⁠⁠‌‬‌‌‍‬‬‌‬‍OpenClaw安装教程文字版 - 飞书云文档](https://ncnlkzxypt73.feishu.cn/wiki/Qch4wpBA6iNaSikkYSGcpfn7nRh?renamingWikiNode=false)
+[视频版](https://www.bilibili.com/video/BV1UsP1zqEWc)
+
+## 系统要求
+
+- **Node.js 24**（推荐）或 Node.js 22.16+
+- **Windows 10/11**（原生 Windows 或 WSL2 均支持）
+- 建议使用 WSL2，体验更稳定
+
+## 安装方法
+
+### 方法一：官方安装脚本（推荐）
+
+在 **PowerShell** 中运行：
+
+```powershell
+iwr -useb https://openclaw.ai/install.ps1 | iex
+```
+
+如果不需要运行初始配置：
+
+```powershell
+& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
+```
+
+### 方法二：使用 npm
+
+如果你已经安装了 Node.js：
+
+```bash
+npm install -g openclaw@latest
+openclaw onboard --install-daemon
+```
+
+### 方法三：使用 pnpm
+
+```bash
+pnpm add -g openclaw@latest
+pnpm approve-builds -g
+openclaw onboard --install-daemon
+```
+
+> ⚠️ pnpm 需要对带构建脚本的包进行明确授权，首次安装后记得运行 `pnpm approve-builds -g`
+
+## 安装后验证
+
+安装完成后，在终端中运行以下命令验证：
+
+```bash
+openclaw --version      # 确认 CLI 可用
+openclaw doctor         # 检查配置问题
+openclaw gateway status # 验证 Gateway 是否运行
+```
+
+## 常见问题
+
+### "openclaw" 命令找不到
+
+如果安装成功但终端找不到命令：
+
+1. 检查 Node.js 是否安装：
+
+   ```bash
+   node -v
+   ```
+
+2. 检查全局包安装路径：
+
+   ```bash
+   npm prefix -g
+   ```
+
+3. 检查 PATH 环境变量是否包含全局 bin 目录
+
+4. 如果没有，添加以下到 PowerShell 配置文件：
+
+   ```powershell
+   $env:PATH = "$env:PATH;$(npm prefix -g)\bin"
+   ```
+
+### sharp 构建错误
+
+如果 `sharp` 因全局安装的 libvips 失败：
+
+```bash
+SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
+```
+
+## 启动使用
+
+首次启动会进入配置向导：
+
+```bash
+openclaw onboard
+```
+
+按照屏幕提示完成：
+1. 选择 AI 模型
+2. 配置消息通道（QQ、微信、飞书等）
+3. 设置管理员
+
+## 卸载
+
+如果需要卸载：
+
+```bash
+openclaw uninstall
+```
+或者手动删除：
+
+- `%APPDATA%\openclaw` 目录
+- 全局 npm 包：`npm uninstall -g openclaw`
+