Windows 下怎么装 OpenClaw？常见坑位与解决方案

OpenClaw是2025-2026年最火的开源本地AI代理工具之一。它能真正“做事”：操作文件、运行脚本、控制浏览器、收发邮件、日程管理，甚至通过聊天软件远程指挥你的电脑，被很多人称为“最接近数字员工的开源方案”。

但Windows用户安装时经常遇到权限、路径、Node.js环境、gateway启动失败等困难。本文针对Windows 10/11系统，给你一套2026年最新、最稳的原生安装流程，无需虚拟机、无需WSL2。同时列出新手最容易踩的15+个坑和对应解法，全程保姆级，照着做基本能一次成功。

文章导航

一、为什么Windows用户安装OpenClaw容易翻车？

官方主要开发环境是macOS和Linux，Windows虽然支持原生安装，但存在以下结构性差异：

PowerShell执行策略默认受限
路径分隔符（\ vs /）导致依赖解析失败
npm/pnpm全局安装路径问题频发
gateway服务（核心后台进程）在Windows服务管理中注册困难
中文路径、长路径、权限提升问题叠加

因此我们采用官方推荐的一键PowerShell脚本 + 手动修复常见断点的组合拳。

二、安装前环境检查与准备（5分钟）

最低硬件要求（能跑但不丝滑）：

CPU：Intel i5 / Ryzen 5 以上（建议12代酷睿或5000系列起）
内存：16GB起（推荐32GB+，模型推理+多任务吃内存）
存储：SSD ≥ 50GB空闲（模型缓存、日志、技能包会膨胀）

必装软件（按顺序安装，全部官网下载最新稳定版）：

Git for Windows（必须） → https://git-scm.com/download/win
安装时一路默认即可，勾选“Use Git from the Windows Command Prompt”
Node.js v22 LTS 或 v24最新版（强烈建议用nvm-windows管理版本）
官网：https://nodejs.org/
或用nvm-windows一键切换：https://github.com/coreybutler/nvm-windows
安装完成后命令行输入验证：
node -v npm -v
PowerShell 7（比自带5.1好用很多）
Microsoft Store搜索“PowerShell 7”安装，或官网下载。
（可选但强烈推荐）Windows Terminal + Oh My Posh美化终端
提升体验，避免cmd的黑框痛苦。

三、Windows一键安装OpenClaw

以管理员身份打开PowerShell 7（右键开始菜单 → Windows PowerShell 7（管理员））

执行下面这条官方维护的最新安装脚本（2026年2月验证有效）：

iwr -useb https://molt.bot/install.ps1 | iex

脚本会自动完成：

检测Node.js版本
安装pnpm：推荐包管理器，比npm更快
下载OpenClaw最新版
尝试全局注册OpenClaw命令

安装完成后会提示是否立即运行 openclaw onboard 初始化向导，直接回车进入。

四、初始化配置向导（onboard）全流程详解

向导是交互式的，中文支持还算友好，按以下选择最稳组合（国内用户推荐）：

同意条款 → Yes
配置模式 → Quick / Fast mode（快速模式）
模型选择 → MiniMax（国内最稳） / GLM-4（智谱） / 通义千问 / Ollama本地模型
MiniMax推荐理由：API稳定、免费额度够用、中文理解优秀
申请地址：https://platform.minimaxi.com
复制API Key粘贴进去
通讯通道（最重要一步）
首选：Telegram（纸飞机） → 需要提前创建机器人
次选：飞书 / Discord / WhatsApp（视你常用工具）
Telegram创建机器人步骤：
打开Telegram搜索 @BotFather
输入 /newbot → 起名字 → 拿到 token
粘贴到向导中
Skills & Hooks → 可以先跳过（后续网页控制台补）
完成向导后会显示类似输出：
Dashboard ready at http://127.0.0.1:18789

此时打开浏览器访问 http://127.0.0.1:18789 应该能看到OpenClaw控制面板。

五、常见坑位 & 解决方案对照表

坑位序号	错误现象 / 报错关键词	出现概率	解决方案（按优先级排序）
1	install.ps1 执行直接报错“无法加载文件”	★★★★★	Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（允许当前用户执行远程脚本）
2	提示 “moltbot : 命令不存在” 或 command not found	★★★★	1. 重新安装 `npm i -g moltbot@beta` 2. 检查npm全局路径是否在环境变量：$env:PATH += “;$env:APPDATA\npm”
3	onboard卡死 / 网关连接失败 / Error 1006	★★★★★	以管理员身份重新运行PowerShell → moltbot daemon install → moltbot daemon start
4	gateway启动失败，日志显示端口18789被占用	★★★	netstat -ano
5	MiniMax模型无响应 / 429限流	★★★★	确认baseUrl是 https://api.minimaxi.com （国内版）检查API Key是否过期，申请新key
6	安装技能时报 “brew not installed”	★★★	Windows不需要brew，忽略警告即可；若卡死请用WSL2安装该技能
7	中文路径导致依赖下载失败	★★★	把Moltbot安装到纯英文路径（如 D:\AI\Moltbot）
8	Web控制台打不开 / 空白页	★★	1. 确认gateway是否运行：moltbot gateway status 2. 清除浏览器缓存 3. 换Chrome/Edge试试
9	Telegram机器人不回复 / pairing失败	★★★	1. 确认bot token正确 2. 给机器人发任意消息拿到pairing code 3. moltbot pairing approve telegram XXXX
10	运行moltbot onboard后服务立即崩溃	★★	检查杀毒软件（Windows Defender）是否拦截 → 临时关闭实时保护，或把目录加入白名单
11	pnpm install卡死 / 网络超时	★★	pnpm config set registry https://registry.npmmirror.com （切换淘宝镜像）
12	想用本地大模型（Ollama/Qwen）却工具调用很差	★★	目前推荐qwen2.5:32b-instruct工具微调版，本地模型工具调用能力仍弱于云模型
13	开机自启失败	★	任务计划程序 → 创建任务 → 触发器：开机 → 操作：启动PowerShell运行 moltbot daemon start
14	更新后版本混乱（@latest是占位包）	★★★★	永远使用 moltbot@beta 更新：npm i -g moltbot@beta
15	高权限操作被系统UAC拦截	★	暂时关闭UAC（不推荐长期关闭）或只给Moltbot有限权限（技能隔离）

六、生产级优化建议（用得越久越重要）

1. 设置开机自启（最实用）

创建一个start-openclaw.bat文件，内容：
bat @echo off cd /d "D:\AI\OpenClaw" openclaw daemon start
放入开机启动文件夹或任务计划程序。

2. 数据备份

每周备份以下目录：

~/.openclaw / %USERPROFILE%.openclaw（配置文件、技能、日志）

数据库文件（如果用了持久化存储）

3. 安全三件套

不要在主力电脑上直接跑：建议闲置旧电脑或云服务器
不要给root/管理员权限运行
定期查看已安装技能，删除不明来源的skill

国内模型&通道首选组合（2026年2月推荐）

模型	通道	延迟	免费额度	稳定性	推荐指数
MiniMax M2.1	Telegram	低	有	★★★★★	★★★★★
智谱GLM-4	飞书	中	有	★★★★	★★★★
通义千问	Discord	中	有	★★★★	★★★★
Ollama本地	Web面板	高	无限制	★★★	★★★