# Openclaw自动安装

**Repository Path**: new-service/setupopenclaw

## Basic Information

- **Project Name**: Openclaw自动安装
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-16
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw 个人 AI 助手 — 安装与部署

本仓库包含在 **Windows 本机** 上从零部署 **OpenClaw** 到 **新电脑/目标机** 的完整方案，以及通用安装指南。

- **README.md**（本文件）— Windows 本机安装 OpenClaw 的通用说明。  
- **从零开始-完整装机方案.md** — 在无系统新电脑上安装 Ubuntu + OpenClaw 的详细步骤。  
- **无显示器-无人值守装机流程.md** — 无显示器时双 U 盘全自动安装。  
- **飞书接入配置指南.md** — 飞书通道配置与配对。  
- **用户手动录入数据清单.md** — 装机全流程需用户录入的数据汇总。  
- **docs/OpenClawDeploy-产品文档.md** — 一站式装机应用产品需求（规划中）。

---

## Windows 本机安装 OpenClaw

本指南帮助你在全新的 Windows 电脑上从零安装并运行 **OpenClaw** 个人 AI 助手。OpenClaw 是开源、可本地运行的 AI 助手，支持日历/邮件、任务自动化、对话记忆，并与 WhatsApp、Telegram、Discord 等集成，数据保留在本地。

---

## 一、安装前准备

### 1. 系统要求

| 项目 | 最低 | 推荐 |
|------|------|------|
| 内存 | 8GB | 16GB |
| 硬盘 | 10GB | 20GB |
| 系统 | Windows 10（建议用 WSL2）/ 11 | 最新稳定版 |

### 2. 必需软件

- **Node.js 22 或更高版本**（必须）
- **Git**（若从源码安装需要）
- **一个 AI 提供商的 API Key**（三选一或多种）：
  - [Anthropic (Claude)](https://console.anthropic.com/) — 社区最常用，推荐首选
  - [OpenAI (GPT)](https://platform.openai.com/)
  - [Google (Gemini)](https://aistudio.google.com/)

> **Windows 说明**：官方强烈建议在 Windows 上使用 **WSL2** 运行 OpenClaw，可减少兼容性问题。若你希望用 WSL2，请先完成 [WSL2 安装](https://learn.microsoft.com/zh-cn/windows/wsl/install)，然后在 WSL 的 Linux 环境中按「方式 B」操作。

---

## 二、安装方式概览

- **方式 A（推荐）**：在 Windows 本机用 npm 全局安装，一条命令 + 向导即可。
- **方式 B**：在 WSL2 的 Linux 里用 npm 安装（推荐在 Windows 上长期使用）。
- **方式 C**：从 GitHub 克隆源码，用 pnpm 构建（适合开发或需要改代码时）。

下面以 **方式 A（Windows 本机）** 为主说明；若你选 WSL2，在 WSL 终端里执行对应命令即可。

---

## 三、方式 A：npm 全局安装（最简单）

### 步骤 1：安装 Node.js 22+

1. 打开 [https://nodejs.org/](https://nodejs.org/)
2. 下载 **v22 或更高版本**（建议选 LTS）
3. 运行安装程序，按提示完成安装
4. **重新打开** PowerShell 或命令提示符，检查版本：

```powershell
node --version
```

应显示 `v22.x.x` 或更高。若未识别命令，请确认安装时勾选了「Add to PATH」。

### 步骤 2：安装 OpenClaw

在 PowerShell 或命令提示符中执行：

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

安装完成后验证：

```powershell
openclaw --version
```

若提示「找不到 openclaw」，请参考文末「常见问题」中关于 PATH 的说明。

### 步骤 3：运行配置向导

```powershell
openclaw onboard
```

向导会依次询问并配置：

- 助手名称、性格（正式/随意、简洁/详细等）
- 使用的 AI 提供商（Anthropic / OpenAI / Google）
- 对应 API Key
- 你的名字、时区等

按提示填写即可，全部可在之后修改。若希望同时安装为后台服务（开机/登录后自动运行），可使用：

```powershell
openclaw onboard --install-daemon
```

### 步骤 4：启动网关

```powershell
openclaw start
```

看到类似输出即表示成功：

```
🔧 Loading configuration from ~/.openclaw/openclaw.json
🧠 Gateway starting on ws://127.0.0.1:18789
📡 WebChat available at http://localhost:18789
✅ OpenClaw is running
```

若希望后台运行（不占用当前窗口）：

```powershell
openclaw start --daemon
```

### 步骤 5：在浏览器中验证

1. 打开浏览器，访问：**http://localhost:18789**
2. 在 WebChat 里输入例如：「你好，你叫什么名字？」
3. 若助手能按你在向导里配置的名字回复，说明安装成功。

可再试：

- 「现在几点了？」
- 「你了解我哪些信息？」
- 「你用的是哪个模型？」

---

## 四、方式 B：在 WSL2 中安装（推荐用于 Windows）

1. 安装并启用 WSL2（见上方链接）。
2. 在 WSL 终端中安装 Node.js 22（例如用 nvm）：

```bash
# 安装 nvm（若尚未安装）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
# 重启终端后：
nvm install 22
nvm use 22
```

3. 安装并配置 OpenClaw：

```bash
npm install -g openclaw@latest
openclaw onboard
openclaw start
```

4. 在 Windows 浏览器中访问：**http://localhost:18789**（WSL2 一般会自动转发本地端口）。

---

## 五、安装后的目录结构

- **配置目录**：`~/.openclaw/`  
  - `openclaw.json`：主配置（端口、模型、频道等）  
  - `SOUL.md`：助手性格与表达方式  
  - `USER.md`：你的信息（名字、时区、兴趣等）  
  - `IDENTITY.md`：助手名称与头像  
  - `MEMORY.md`：长期记忆  

- **工作目录**：`~/clawd/`  
  - 助手生成的文件、下载等会放在这里。

均为文本文件（Markdown/JSON），可随时编辑。

---

## 六、常用命令

| 命令 | 说明 |
|------|------|
| `openclaw start` | 前台启动 |
| `openclaw start --daemon` | 后台启动 |
| `openclaw stop` | 停止 |
| `openclaw status` | 查看运行状态 |
| `openclaw logs` | 查看日志 |
| `openclaw doctor` | 检查配置与环境 |
| `openclaw onboard --reconfigure` | 重新跑配置向导（如更换 API Key） |

---

## 七、常见问题

### 1. 提示「找不到 openclaw」或「command not found」

- 说明 npm 的全局安装路径不在系统 PATH 中。  
- 可先查看：`npm config get prefix`，然后把该路径下的 `node_modules` 同级的目录（例如 `...\npm` 或 `...\node_modules\..`）以及其中的 `...\npm` 加入系统环境变量 PATH。  
- 或使用「以管理员身份运行」的 PowerShell 安装（不推荐长期用管理员）：  
  `npm install -g openclaw@latest`

### 2. 提示「Node.js version 22 or later required」

- 安装或升级到 Node.js 22+，并确保终端里 `node --version` 显示 22 及以上。

### 3. 浏览器打开 http://localhost:18789 无法连接

- 先执行 `openclaw status` 确认网关已启动。  
- 若未运行，执行 `openclaw start` 或 `openclaw start --daemon`。  
- 若端口被占用，可在 `~/.openclaw/openclaw.json` 中修改 `gateway.port`（如改为 18790）。

### 4. API 报错「invalid API key」或认证失败

- 重新配置：`openclaw onboard --reconfigure`，重新填写正确的 API Key。

### 5. 想开机/登录后自动运行

- Windows 本机：可将 `openclaw start --daemon` 加入计划任务或启动项。  
- 若使用 WSL2 + Linux：在 Linux 中执行 `openclaw service install` 可配置 systemd 用户服务，实现自动启动。

---

## 八、下一步

- 编辑 `~/.openclaw/SOUL.md` 和 `USER.md`，让助手更符合你的风格和需求。  
- 在配置中添加频道（如 Telegram、Discord），实现多端使用。  
- 使用 `openclaw doctor` 和 `openclaw agent --message "你好"` 做健康检查。

祝你使用 OpenClaw 顺利。若需要，可先在本目录运行 `.\check-env.ps1` 做环境检查。