1. 概述

本指南将详细介绍如何在 Windows 操作系统上成功部署和配置 OpenClaw（原名 Clawdbot）。经过全面的调研，我们强烈建议通过 **Windows Subsystem for Linux (WSL2)** 的方式进行安装，因为这是官方和社区一致推荐的最佳实践，可以提供最好的兼容性和稳定性 [1][2]。

OpenClaw 是一个开源的、可自托管的个人 AI 助手，它允许您通过日常使用的通讯软件（如 WhatsApp、Telegram 等）来控制您的计算机、执行任务和访问大型语言模型。在 Windows 上直接运行 OpenClaw 存在较多兼容性问题，而 WSL2 提供了一个完整的 Linux 内核，使得 OpenClaw 可以像在原生 Linux 环境中一样流畅运行，同时又能与您的 Windows 系统无缝集成。

本指南将主要介绍两种在 Windows 上部署 OpenClaw 的方法：

*   **方法一：使用 WSL2 + Ubuntu（强烈推荐）**：最稳定、兼容性最好的方法。
*   **方法二：使用 Docker Desktop**：提供更好的隔离性，但配置相对复杂一些。

2. 系统要求与准备工作

在开始安装之前，请确保您的系统满足以下条件：

*   **操作系统**: Windows 10 或 Windows 11。
*   **内存 (RAM)**: 至少 4GB，尤其是在需要进行 npm 构建时，以防止内存不足导致安装失败 [3]。
*   **Node.js**: 版本 22 或更高。不过，您无需手动安装，官方安装脚本会自动检测并为您安装所需的 Node.js 版本 [2]。
*   **Windows 功能**: 确保已启用“虚拟机平台”和“适用于 Linux 的 Windows 子系统”功能。

3. 方法一：通过 WSL2 和 Ubuntu 进行部署（推荐）

这是在 Windows 上运行 OpenClaw 的首选方法，它结合了 Linux 的强大功能和 Windows 的便利性。

步骤 1：安装 WSL2 和 Ubuntu

首先，我们需要在您的 Windows 系统上安装 WSL2 和一个 Linux 发行版（推荐使用 Ubuntu 24.04）。

1.  以 **管理员身份** 打开 PowerShell。
2.  执行以下命令来安装 WSL 和 Ubuntu：

    ```powershell
    wsl --install -d Ubuntu-24.04
    ```

3.  根据提示重新启动您的计算机。重启后，Ubuntu 将会自动完成安装并提示您创建用户和密码。

步骤 2：在 WSL2 (Ubuntu) 中安装 OpenClaw

安装完 WSL2 和 Ubuntu 后，接下来的所有操作都在 Ubuntu 终端中进行。

1.  打开您的 Ubuntu 终端。
2.  使用官方提供的一键安装脚本来安装 OpenClaw。这个脚本会自动处理 Node.js 的安装和环境配置：

    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

3.  安装完成后，可以通过运行 `openclaw --version` 来验证是否安装成功。

步骤 3：运行初次设置向导

安装好 OpenClaw 之后，运行 onboarding向导来完成基本配置，包括设置模型提供商（如 OpenAI, Anthropic 等）、获取 API 密钥以及连接您的通讯工具。

```bash
openclaw onboard --install-daemon
```

`--install-daemon` 参数会将 OpenClaw 设置为一个后台服务（在 Linux 中是 systemd），确保它可以在系统重启后自动运行，实现“永远在线” [3]。

### 步骤 4：验证安装和启动 Gateway

1.  检查 OpenClaw 的服务状态，确保其正常运行：

    ```bash
    openclaw doctor
    openclaw gateway status
    ```

2.  如果一切正常，您可以通过以下命令打开 OpenClaw 的 Web 控制面板：

    ```bash
    openclaw dashboard
    ```

    这将在您的默认浏览器中打开 `http://127.0.0.1:18789`。如果页面成功加载，说明您的 OpenClaw Gateway 已经准备就绪 [4]。

## 4. 方法二：通过 Docker Desktop 进行部署

如果您更喜欢容器化的部署方式，可以使用 Docker Desktop。这种方法提供了更好的环境隔离。

### 步骤 1：安装 Docker Desktop

从 Docker 官网下载并安装适用于 Windows 的 Docker Desktop。请确保在设置中启用了 WSL2 后端，这是目前 Docker Desktop 的默认选项。

### 步骤 2：克隆 OpenClaw 仓库并配置

1.  使用 Git 克隆 OpenClaw 的官方仓库：

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    ```

2.  运行 Docker 设置脚本：

    ```bash
    ./docker-setup.sh
    ```

    或者，您可以参考 `xaixapi.com` 提供的 Docker Compose 模板 [1]。这通常涉及到复制 `.env.example` 文件为 `.env`，并填入您的 API 密钥和自定义的 Gateway 令牌。

步骤 3：启动 OpenClaw 容器

使用 Docker Compose 启动 OpenClaw Gateway 服务：

```bash
docker compose up -d openclaw-gateway
```

您可以使用 `docker compose ps` 查看容器状态，并使用 `docker compose logs -f openclaw-gateway` 来跟踪日志。

5. 安全注意事项

由于 OpenClaw 能够执行系统命令和访问文件，因此必须重视其安全性。

*   **网络暴露**：**绝对不要**将 OpenClaw 的控制面板端口（默认为 18789）直接暴露在公共互联网上。推荐使用 Tailscale 等工具创建一个安全的私有网络进行访问 [3]。
*   **WSL/Docker 隔离**：使用 WSL2 或 Docker 本身就提供了一层重要的安全隔离。建议将 OpenClaw 的工作目录限制在 WSL 或容器内部，避免直接操作 Windows 的系统盘（如 `/mnt/c`），以防意外发生。
*   **权限控制**：在 OpenClaw 的配置文件中，您可以开启 `exec.ask: "on"` 模式，这样在执行任何文件写入或命令执行之前，都会请求您的明确批准 [3]。

6. 结语

在 Windows 上部署 OpenClaw 的最佳且最受推荐的方式是通过 WSL2。它为您提供了一个稳定、兼容的 Linux 环境，同时避免了直接在 Windows 上运行可能遇到的各种问题。通过遵循本指南的步骤，您应该能够顺利地搭建起自己的个人 AI 助手，并开始探索其强大的自动化能力。