乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > Windows 环境部署 OpenClaw 保姆级教程

Windows 环境部署 OpenClaw 保姆级教程

当前时间： 2026-05-06 12:38:49 更新时间： 2026-05-06 分类：软件教程 评论(0)

Windows 环境部署 OpenClaw 保姆级教程

OpenClaw 是一款强大的 AI 自动化工具，Windows 下推荐 WSL2 官方方案（兼容性最佳），也提供原生 PowerShell 一键部署（适合新手快速上手），以下内容可直接复制到微信公众平台编辑，无需额外调整格式。

一、部署前准备（必看！避坑关键）

  1. 系统与硬件要求 配置项 最低要求 推荐配置 操作系统 Windows 10 64位（2004+）/ Windows 11 Windows 11 64位（22H2+） 运行内存 ≥8GB ≥16GB 磁盘空间 ≥5GB 可用空间 ≥10GB 可用空间 网络 稳定联网（下载依赖+调用 AI API） 高速网络 权限 必须以管理员身份操作 管理员权限
  2. 关键注意事项
  • 安装路径禁止中文、空格、特殊符号（如 D:\OpenClaw 合规，D:\开源工具\Open Claw报错）。
  • 杀毒软件/防火墙需添加信任，避免拦截依赖下载与程序运行。
  • 提前准备 AI 模型 API Key（如 OpenAI、Anthropic、智谱 GLM 等）。

二、方案一：WSL2 部署（官方推荐，稳定无坑） 适合追求稳定性、需要长期使用的用户，兼容所有 OpenClaw 功能，避免原生环境兼容问题。 步骤1：安装 WSL2（Windows 子系统）

  1. 按下 Win+X，选择 终端（管理员）（或 PowerShell（管理员））。
  2. 执行命令安装 WSL2（自动下载 Ubuntu 系统）： wsl –install
  3. 等待自动下载完成，重启电脑（必须重启，否则 WSL2 无法生效）。
  4. 重启后打开终端，会自动启动 Ubuntu，按提示设置用户名与密码（密码输入时不显示，正常输入即可，回车确认）。 步骤2：配置 WSL2 环境（Ubuntu 内操作）
  5. 更新系统包（确保依赖最新）： sudo apt update && sudo apt upgrade -y
  6. 安装 Node.js 22+（OpenClaw 强制要求，版本过低会报错）：

安装 Node.js 源

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash –

安装 Node.js

sudo apt install -y nodejs

验证版本（需 ≥v22.0.0）

node -v npm -v

  1. 安装 Git 与依赖工具（克隆仓库、编译依赖需用到）： sudo apt install -y git build-essential 步骤3：安装 OpenClaw 核心程序
  2. 克隆官方仓库（下载 OpenClaw 源码）： git clone https://github.com/OpenClaw/Clawdbot.git cd Clawdbot
  3. 安装项目依赖（国内用户可切换 npm 镜像加速，避免下载超时）：

切换国内镜像（可选，提升下载速度）

npm config set registry https://registry.npmmirror.com

安装依赖

npm install

初始化配置（自动生成配置文件）

npm run init 步骤4：配置 AI 模型 API Key

  1. 编辑环境变量文件（存储 API Key，供 OpenClaw 调用）： nano .env
  2. 在打开的文件中，填入你的 API Key（以 OpenAI 为例，其他模型同理）： OPENAI_API_KEY=你的OpenAI密钥 ANTHROPIC_API_KEY=你的Claude密钥（可选，不使用可忽略）
  3. 按 Ctrl+O 保存（按回车确认），再按 Ctrl+X 退出编辑。 步骤5：启动 OpenClaw 服务
  4. 启动网关服务（默认端口 18789）： npm run start

或指定端口启动（避免端口冲突）

openclaw gateway run –port 18789

  1. 打开 Windows 浏览器，访问：http://localhost:18789，即可进入 OpenClaw 管理面板，部署完成。

三、方案二：原生 PowerShell 一键部署（新手快速版） 适合新手，无需安装 WSL2，一键完成部署，10分钟内可启动使用，适合快速体验。 步骤1：安装 Node.js 22+

  1. 访问 Node.js 官网，下载 Windows 64位 22.x LTS 版本（不要下载其他版本，避免兼容问题）。
  2. 运行安装包，勾选「自动安装必要工具（推荐）」，一路点击「下一步」默认安装，完成后重启电脑。
  3. 以管理员身份打开 PowerShell，验证 Node.js 版本（确保 ≥v22.0.0）： node -v  # 需显示 v22.xxx npm -v 步骤2：配置 PowerShell 执行策略
  4. 管理员 PowerShell 中执行以下命令（允许运行脚本，否则安装脚本无法执行）： Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  5. 提示「是否执行更改」时，输入 Y 并回车确认。 步骤3：一键安装 OpenClaw
  6. 在管理员 PowerShell 中，执行官方一键安装脚本： iwr -useb https://openclaw.bot/install.ps1 | iex
  7. 等待自动下载、安装完成（约5-10分钟，取决于网络速度），安装完成后验证版本： openclaw –version 步骤4：初始化与配置
  8. 执行初始化向导（引导配置 API Key，新手友好）： openclaw onboard –flow quickstart
  9. 按提示粘贴你的 AI API Key，然后选择默认模型（推荐 gpt-3.5-turbo，占用资源少、响应快）。
  10. 启动 OpenClaw 服务： openclaw start
  11. 打开浏览器，访问 http://localhost:18789，进入管理面板，即可开始使用。

四、常见问题与排错（避坑必看）

  1. WSL2 安装失败
  • 报错：wsl –install 无响应 / 提示“未找到命令” → 开启 Windows 功能：控制面板 → 程序 → 启用或关闭 Windows 功能 → 勾选「适用于 Linux 的 Windows 子系统」与「虚拟机平台」，重启电脑后再重试。
  • 网络问题导致下载超时 → 切换手机热点，或使用代理，再执行安装命令。
  1. Node.js 版本过低 报错：ERROR: Node.js version must be ≥22.0.0 → 卸载当前 Node.js，重新从官网下载 22.x 版本安装，重启电脑后验证。
  2. 启动报错「权限不足」
  • 确保始终以 管理员身份 运行 PowerShell/WSL2 终端（右键终端 → 以管理员身份运行）。
  • 找到 OpenClaw 安装目录，右键 → 属性 → 安全 → 编辑 → 给当前用户添加「完全控制」权限。
  1. API Key 配置不生效
  • 检查 .env 文件格式，确保无多余空格、无拼写错误，API Key 正确无误。
  • 重启 OpenClaw 服务：openclaw gateway restart（WSL2 环境）或 openclaw restart（原生环境）。

五、使用与进阶提示

  1. 基础使用：浏览器打开管理面板，可创建对话、配置自动化规则、查看运行日志。
  2. 渠道集成：支持 Telegram、Discord、微信等平台对接，在面板「通道」模块中配置即可。
  3. 本地模型：如需本地运行大模型（无需联网调用 API），可对接 Ollama，在 .env 文件中配置本地模型地址即可。 教程结束，如有其他部署问题，可留言反馈哦~