Windows环境下OpenClaw本地部署完整指南

一、AI智能体框架OpenClaw部署（openclaw.ai）

OpenClaw是一款完全开源、本地优先的AI智能体执行网关，它不仅能对话，还能直接操控电脑执行任务（管理文件、编写代码、浏览网页、发送邮件等），所有数据完全存储在本地设备上。

系统要求

• 操作系统：Windows 10 21H2+ 或 Windows 11
• 内存：最低2GB，推荐4GB以上
• 存储：约500MB可用空间
• 网络：互联网连接（用于AI API调用，本地模型可离线运行）
• 依赖：Node.js 22.0.0+（LTS版本推荐）

方案一：一键脚本部署（新手首选，5分钟完成）

这是官方推荐的最简单方法，自动检测并安装所有依赖。

1. 以管理员身份打开PowerShell

   • 开始菜单搜索"PowerShell"
   • 右键点击"Windows PowerShell"
   • 选择"以管理员身份运行"

2. 允许脚本执行
   Windows默认禁止运行远程脚本，需要先授权：

   Set-ExecutionPolicyRemoteSigned-Scope CurrentUser

   当系统提示确认时，输入Y并按回车。

3. 执行官方安装脚本

   # 官方脚本（推荐）iwr-useb https://openclaw.ai/install.ps1|iex# 国内网络超时可使用中国社区镜像# iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

   等待2-5分钟，出现"OpenClaw installed successfully"即为安装完成。

4. 验证安装
   关闭所有PowerShell窗口，重新打开一个新的PowerShell窗口：

   openclaw--version

   如果显示版本号，说明安装成功。

方案二：WSL2部署（官方推荐，稳定性最佳）

官方明确表示原生Windows安装虽然可用，但稳定性较差，强烈推荐使用WSL2环境部署OpenClaw。

1. 安装WSL2和Ubuntu
   以管理员身份打开PowerShell：

   wsl--install

   安装完成后重启电脑，系统会自动创建Ubuntu用户账户。

2. 在WSL2中启用systemd
   打开Ubuntu终端，编辑wsl.conf文件：

   sudonano/etc/wsl.conf

   添加以下内容：

   [boot] systemd=true

   保存退出（Ctrl+O，回车，Ctrl+X），然后关闭WSL：

   wsl--shutdown

   重新打开Ubuntu终端。

3. 在WSL2中安装OpenClaw

   curl-fsSLhttps://openclaw.ai/install.sh|bash

   安装完成后，重新加载环境变量：

   source~/.bashrc

4. 验证安装

   openclaw--version

方案三：Docker容器化部署（生产/隔离环境首选）

Docker部署提供了最佳的隔离性和可移植性，适合需要长期稳定运行的场景。

1. 安装Docker Desktop
   从Docker官网下载并安装Windows版Docker Desktop。安装时确保勾选"Use the WSL 2 based engine"选项。

2. 启动Docker Desktop
   等待Docker状态显示为"Running"。

3. 运行OpenClaw容器
   打开PowerShell：

   docker run-d--name openclaw-p 18789:18789--restart unless-stopped openclaw/openclaw:latest

   --restart unless-stopped参数确保容器在系统重启或崩溃后自动启动。

4. 验证容器运行状态

   dockerps

   你应该看到openclaw容器状态为"Up"。

初始化配置与启动

无论使用哪种部署方式，都需要完成以下初始化步骤：

1. 运行新手引导

   openclaw onboard--flow quickstart

   按照向导提示完成：

   • 选择AI模型提供商（支持Claude、OpenAI、DeepSeek、Kimi等）
   • 输入对应的API密钥
   • 配置聊天通道（推荐Telegram，配置最简单）

2. 启动OpenClaw服务

   openclawstart

3. 安装为系统服务（可选）
   让OpenClaw在系统启动时自动运行：

   openclaw gateway install

4. 访问Web管理界面
   打开浏览器访问：http://localhost:18789
   在这里你可以查看日志、管理技能、配置更多通道。

常见问题排查