# OpenClaw 安装配置指南

## 文档信息
- **适用系统**: Windows 10/11 (x64)
- **目标软件**: OpenClaw v2026.1.30
- **Node.js 版本**: v22.13.1 (LTS)
- **包管理器**: npm v10.9.4
- **最后更新**: 2026-02-02

---

## 1. 环境准备

### 1.1 安装 Node Version Manager (nvm-windows)
由于 OpenClaw 对 Node.js 版本有严格要求，建议使用 nvm 管理 Node 版本。

**安装步骤:**
1. 下载 nvm-windows 安装程序
   ```powershell（管理员打开）
   curl -o nvm-setup.exe https://github.com/coreybutler/nvm-windows/releases/download/1.1.12/nvm-setup.exe
   ```

2. 运行安装程序
   ```powershell
   Start-Process .\nvm-setup.exe
   ```
   - 按提示完成安装（保持默认路径）
   - **安装完成后必须重启 PowerShell**

3. 验证安装
   ```powershell
   nvm version
   # 预期输出: 1.1.12
   ```
---

## 2. Node.js 安装与配置

### 2.1 安装 Node.js v22.13.1
OpenClaw 要求 Node.js ≥22.12.0，这里安装最新的 LTS 版本。

```powershell（管理员打开）
# 安装指定版本
nvm install 22.13.1

# 激活该版本
nvm use 22.13.1

# 验证版本
node -v
# 预期输出: v22.13.1

npm -v
# 预期输出: 10.9.x
```

**注意**: 如果 npm 版本为 11.x，需要降级到 10.x：
```powershell
npm install -g npm@10
```
---
## 3. OpenClaw 安装

### 3.1 清理旧版本（如有）
如果之前安装失败，先清理残留文件：
```powershell
Remove-Item -Recurse -Force "C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw" -ErrorAction SilentlyContinue
Remove-Item -Force "C:\Users\Administrator\AppData\Roaming\npm\openclaw*" -ErrorAction SilentlyContinue
npm cache clean --force
```

### 3.2 安装 OpenClaw
由于 Windows 下编译 `node-llama-cpp` 可能失败，建议使用 `--ignore-scripts` 跳过本地 LLM 编译（如需本地 LLM 支持，需先安装 Visual Studio Build Tools）：

```powershell
npm install -g openclaw@latest --ignore-scripts
```

### 3.3 验证安装
```powershell（管理员打开）
openclaw --version
# 预期输出: 2026.1.30
```

**可能出现的警告**:
- `punycode` 模块弃用警告：可忽略，不影响功能
- 如果提示命令未找到，使用 `npx openclaw` 运行
---

## 4. 功能说明

### 4.1 当前安装模式
- **API 模式**: ✅ 可用（OpenAI、Anthropic、Ollama 远程等）
- **本地 LLM 模式**: ❌ 未启用（需重新安装以启用 `node-llama-cpp`）

### 4.2 基本使用命令
```powershell（管理员打开）
# 查看帮助
openclaw --help

# 启动初始化向导（推荐）
openclaw onboard --install-daemon

# 启动网关服务
openclaw gateway --port 18789 --verbose

# 检查版本
openclaw --version
```

---

## 6. 配置路径

配置文件通常位于：
```
C:\Users\Administrator\AppData\Roaming\openclaw\settings.yml
```

---

## 7. 附录：完整安装日志（参考）

```powershell
# 步骤 1: 安装 nvm-windows
PS> curl -o nvm-setup.exe https://github.com/coreybutler/nvm-windows/releases/download/1.1.12/nvm-setup.exe
PS> Start-Process .\nvm-setup.exe
# [安装完成后重启 PowerShell]

# 步骤 2: 安装 Node.js 22
PS> nvm install 22.13.1
PS> nvm use 22.13.1
Now using node v22.13.1 (64-bit)

# 步骤 3: 降级 npm（如需要）
PS> npm install -g npm@10
PS> npm -v
10.9.4

# 步骤 4: 清理并安装 OpenClaw
PS> Remove-Item -Recurse -Force "C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw" -ErrorAction SilentlyContinue
PS> npm cache clean --force
PS> npm install -g openclaw@latest --ignore-scripts

# 步骤 5: 验证
PS> openclaw --version

# 步骤 6: 初次启动
PS> openclaw onboard --install-daemon

=========================

# Qwen API 配置指南

Qwen在OpenClaw中采用OAuth认证方式，而不是传统的API密钥。以下是配置步骤：

## 配置步骤

1. **启用Qwen插件**：
   ```bash
   openclaw plugins enable qwen-portal-auth
   ```
   启用后需要重启Gateway服务 （openclaw gateway --port 18789 --verbose）。

2. **登录并配置认证**：
   ```bash
   openclaw models auth login --provider qwen-portal --set-default
   ```
   此命令会启动Qwen设备码OAuth流程，并将提供程序条目写入配置文件中。

3. **切换到Qwen模型**：
   ```bash
   openclaw models set qwen-portal/coder-model
   ```

## 可用模型
- `qwen-portal/coder-model`
- `qwen-portal/vision-model`