2026年6月8日下面为你整理一份基于最新资料的 Windows 部署指南涵盖环境准备、安装、配置到试运行全流程帮你一次跑通一、安装前的准备工作1. 系统要求操作系统Windows 10 或 1164位内存建议 8GB 以上磁盘空间至少 20GB 可用空间用于存放 Skills 等组件网络能够正常访问 GitHub 和 Node.js 官网2. ⚠️ 重要安全提醒OpenClaw 拥有操作文件系统、执行自动化任务的权限强烈建议使用一台干净的备用电脑或租用云端虚拟机进行安装测试不要在存有重要资产的主力工作电脑上安装给 API Key 设置月度使用限额防止泄露导致超额扣费3. 关闭安全防护软件安装前请暂时关闭以下安全工具否则可能拦截或删除关键文件360 安全卫士 / 360 杀毒腾讯电脑管家火绒安全Windows Defender 实时防护OpenClaw 运行时会执行键鼠模拟、文件读写、浏览器控制等操作易被安全软件判定为风险行为这属于正常机制。二、安装 Node.js 环境OpenClaw 基于 Node.js 运行要求版本 ≥ 22推荐使用 nvm 管理版本。方式一使用 nvm推荐方便切换版本访问 nvm-windows Releases 下载nvm-setup.exe并安装以管理员身份打开 PowerShell右键点击开始菜单 → Windows PowerShell管理员执行以下命令# 安装 Node.js 22 最新版本 nvm install 22 # 使用刚安装的版本 nvm use 22.22.0 # 验证安装 node -v # 应输出 v22.x.x npm -v # 应输出对应 npm 版本 [7](ref) ### 方式二直接安装新手友好 访问 [Node.js 官网](https://nodejs.org/) 下载 **LTS 版本22.x** 的 Windows 安装包.msi一路 Next 即可。 ### 3. 配置国内镜像源可选但推荐大幅提升下载速度 powershell npm config set registry https://registry.npmmirror.com [4](ref) ### 4. 安装 Git部分组件需要 powershell winget install git.git # 或手动从 Git官网 下载安装 git --version # 验证安装三、安装 OpenClaw方法一官方一键脚本推荐新手在管理员 PowerShell中执行iwr -useb https://openclaw.ai/install.ps1 | iex [7](ref) 若遇到执行策略报错先运行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser[7](ref) ### 方法二npm 全局安装更可控 powershell # 先清理缓存如果之前安装失败 npm cache clean --force # 全局安装最新版 npm install -g openclawlatest # 验证安装 openclaw --version # 应输出 3.x.x 版本号 [4](ref) --- ## 四、初始化配置关键步骤 ### 1. 运行初始化向导 powershell openclaw onboard --flow quickstart [7](ref) ### 2. 按提示完成配置 | 配置项 | 推荐选择 | 说明 | |--------|---------|------| | **风险提示** | Yes | 确认了解工具的风险[7](ref) | | **安装模式** | QuickStart | 新手快速模式[7](ref) | | **AI 模型** | 可选 Gemini、Qwen、DeepSeek 等 | 国内建议选 Gemini 或通义千问[7](ref) | | **API Key** | 输入对应平台的 Key | 需提前注册获取[7](ref) | | **通讯渠道** | Skip for now暂不配置 | 后续可补充[7](ref) | | **技能Skills** | Yes | 安装推荐技能包[7](ref) | | **守护进程Daemon** | Yes | 实现后台运行[7](ref) | ### 接入 DeepSeek 模型热门配置 由于 DeepSeek 兼容 OpenAI 接口在配置时选择 **OpenAI** 或 **Custom (OpenAI Compatible)**然后填入 - **API Key**从 DeepSeek 开放平台获取的 sk-xxx - **Base URL**https://api.deepseek.com末尾不要加 /v1 - **Model Name**deepseek-chat 或 deepseek-reasoner ### 接入 Kimi 模型 - **Auth Method**选择 Kimi Code API key (subscription) - **Model**推荐 kimi-coding/k2p5旗舰模型响应最快 --- ## 五、启动服务并验证 ### 1. 启动 Gateway 网关 powershell # 方式一先设置本地模式重要 openclaw config set gateway.mode local # 启动网关 openclaw gateway start [4](ref)[7](ref) ### 2. 打开 Web 控制台 访问 **http://127.0.0.1:18789/**或运行 powershell openclaw dashboard [4](ref) ### 3. 发送消息试运行 在聊天框中输入 **“你好”**如果能收到回复说明安装成功[7](ref) ### 4. 验证守护进程关掉终端仍能运行 powershell openclaw daemon status六、常见问题排查❌ 问题1code 128错误原因网络波动或 SSH 访问失败。解决npm cache clean --force npm install -g openclawlatest # 重试 [4](ref) ### ❌ 问题2openclaw 不是内部或外部命令 **原因**环境变量未刷新或 npm 全局目录未加入 PATH。 **解决**关闭当前 PowerShell重新以管理员身份打开或手动将 C:\Users\用户名\AppData\Roaming\npm 加入系统 PATH。 ### ❌ 问题3网关启动失败Gateway 离线 **可能原因与解决** - 安全软件拦截 → 关闭后重试[9](ref) - 安装路径含中文 → 改为纯英文路径如 D:\OpenClaw[9](ref) - Gateway token 不匹配 → 运行 openclaw doctor --fix 自动修复 ### ❌ 问题4首次启动加载慢 **正常现象**首次需初始化依赖与环境等待 **1-3 分钟** 即可后续启动会加快[9](ref)。 --- ## 七、进阶方向 ### 接入飞书机器人 powershell openclaw plugins install m1heng-clawd/feishu然后在飞书开放平台创建应用配置 App ID、App Secret 及相应权限即可。常用管理指令指令作用openclaw status查看当前所有通道和状态openclaw doctor --fix自动扫描并修复配置问题openclaw daemon restart修改配置后重启服务openclaw onboard重新初始化配置换模型、换 Key八、总结阶段关键操作预计耗时环境准备安装 Node.js 22、Git10分钟安装本体一键脚本或 npm 安装5分钟初始化配置运行 onboard 向导10分钟启动验证访问 Dashboard 发消息5分钟OpenClaw 是一款功能强大的本地 AI 智能体工具数据存储在本地隐私更有保障。安装过程中最需要注意的是管理员权限、纯英文路径、关闭安全软件这三点。祝你的“小龙虾”顺利跑起来✨