OpenClaw Windows 最新安装指南：从零开始搭建你的 AI 智能助手

摘要本文解决 Windows 环境下 OpenClaw 的完整安装与配置问题适合初次接触 AI Agent 框架的开发者和技术爱好者。读完本文你将掌握 OpenClaw 的两种安装方式、完整配置流程、常见报错解决方案以及如何快速上手使用这个强大的 AI 智能体工具。一、OpenClaw 是什么OpenClaw 是一个开源的 AI Agent 框架能让大语言模型如 Claude、GPT、DeepSeek真正动起来——不只是回答问题而是能够自主规划任务、调用工具、操作电脑完成实际工作。主要用途和应用场景自动化办公批量处理文件、生成报表、发送邮件代码开发辅助读取项目代码、执行命令、调试程序信息检索与整理搜索网页、提取数据、生成摘要多平台集成接入飞书、企业微信、钉钉等办公软件Windows 用户的常见痛点需要手动安装 Node.js、Git 等依赖环境配置文件路径和参数容易出错API Key 配置不当导致 401 错误网络问题导致安装失败或超时二、安装前准备在开始安装之前请确保你的设备满足以下要求系统要求操作系统Windows 10 或 Windows 1164位内存至少 4GB RAM推荐 8GB 及以上磁盘空间至少 1GB 可用空间网络稳定的互联网连接核心依赖软件Node.js版本 ≥ v22强烈推荐 v24 LTSGit用于拉取项目依赖可选但推荐安装三、完整安装步骤OpenClaw 提供两种安装方式根据你的技术背景选择合适的方案。方式一Windows 专用脚本安装推荐新手这是最简单的安装方式适合不想折腾环境配置的用户。步骤 1允许脚本执行以管理员身份打开 PowerShell右键点击开始菜单 → Windows PowerShell管理员执行以下命令Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser系统会提示是否更改执行策略输入 Y 并回车确认。步骤 2执行安装脚本在 PowerShell 中粘贴并运行以下命令iwr -useb https://openclaw.ai/install.ps1 | iex脚本会自动下载并安装 OpenClaw整个过程需要 3-5 分钟请耐心等待。注意如果下载速度很慢或超时可能是网络问题。建议使用稳定的网络环境或考虑使用方式二。步骤 3验证安装安装完成后在 PowerShell 中输入openclaw --version如果显示版本号如 openclaw/2026.03.24说明安装成功。方式二NPM 安装需要 Node.js 环境这种方式更灵活适合有一定技术基础的用户。步骤 1安装 Node.js访问Node.js 官方下载页面下载 Windows 64位安装包推荐 v24.14.0 LTS 版本双击安装包按照向导完成安装安装路径可以使用默认的 C:\Program Files\nodejs\勾选自动安装必要工具选项安装完成后打开新的 PowerShell 窗口验证安装node -vnpm -v如果显示版本号如 v24.14.0 和 10.9.0说明 Node.js 安装成功。步骤 2通过 NPM 全局安装 OpenClaw在 PowerShell 中执行npm install -g openclawlatest版本说明截至 2026 年 3 月 24 日最新版本已修复前端界面 bug可以直接安装 latest。如果遇到问题可以回退到稳定版本 npm install -g openclaw2026.03.13 br安装过程需要 5-10 分钟完成后验证brpowershellopenclaw --version四、初始化配置安装完成后需要通过初始化向导生成配置文件。步骤 1启动初始化向导在 PowerShell 中执行openclaw onboard步骤 2按照向导完成配置向导会依次询问以下问题按照提示选择即可① 是否锁定配置Lock config for shared/multi-user use? (yes/no)选择 no个人使用或直接回车② 选择配置模式Choose setup mode选择 QuickStart快速开始稍后可以通过 openclaw configure 详细配置③ 选择模型提供商Model/auth provider推荐选择以下国内模型提供商之一阿里云百炼推荐新手有免费额度DeepSeek性价比高智谱 GLM中文能力强选择后需要填写 API Key。获取阿里云百炼 API Key访问阿里云百炼控制台注册并登录账号新用户有免费 Token 额度在API-KEY 管理页面创建并复制 API Key粘贴到 OpenClaw 配置向导中④ 过滤模型Filter models by provider直接回车默认全选⑤ 选择通信渠道Select channel (QuickStart)选择 Skip跳过因为 Windows 版本自带 WebUI⑥ 搜索提供商Search provider选择 Skip跳过后续可以单独配置⑦ 配置技能包Configure skills now?选择 No暂不配置等熟悉后再按需安装⑧ 启用钩子Enable hooks?按空格键取消选择直接回车跳过步骤 3启动 OpenClaw配置完成后OpenClaw 会自动启动两个窗口Gateway 服务窗口保持打开状态不要关闭WebUI 浏览器窗口访问地址http://127.0.0.1:18789如果浏览器没有自动打开手动访问 http://127.0.0.1:18789 即可。五、常见报错及解决方法报错 1401 无效的令牌现象在 WebUI 中发送消息后返回错误Error: 401 Unauthorized - Invalid API Key原因阿里云百炼的免费版和付费版 API 接口地址不同默认配置使用的是付费版地址。解决方法找到配置文件C:\Users\你的用户名\.openclaw\openclaw.json用记事本或 VS Code 打开找到 modelstudio 或 dashscope 配置段修改以下两处{providers: {modelstudio: {baseUrl: https://dashscope.aliyuncs.com/compatible-mode/v1,apiKey: sk-xxxxxxxxxxxxxxxxxxxxxxxx}}}关键修改将 baseUrl 改为https://dashscope.aliyuncs.com/compatible-mode/v1确保 apiKey 填写正确以 sk- 开头保存文件后重启 OpenClaw Gatewayopenclaw gateway restart报错 2禁止运行脚本现象执行安装脚本时提示无法加载文件因为在此系统上禁止运行脚本解决方法以管理员身份打开 PowerShell执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认后重新运行安装脚本。报错 3Node.js 版本不符合要求现象安装时提示Error: OpenClaw requires Node.js v22 or higher解决方法卸载旧版本 Node.js控制面板 → 程序和功能访问Node.js 官网下载 v24 LTS 版本重新安装后打开新的 PowerShell 窗口验证node -v确保显示 v24.x.x 或更高版本。报错 4安装卡住或超时现象执行安装脚本后长时间无响应或提示网络超时。解决方法方案 1切换 NPM 镜像源npm config set registry https://registry.npmmirror.com然后重新安装npm install -g openclawlatest方案 2使用代理如果有代理工具可以设置 NPM 代理npm config set proxy http://127.0.0.1:7890npm config set https-proxy http://127.0.0.1:7890将 7890 替换为你的代理端口六、实操案例让 OpenClaw 帮你整理文件完成安装和配置后让我们通过一个真实场景来体验 OpenClaw 的能力。**场景**将桌面上的所有图片文件移动到 D:\Pictures\Desktop 文件夹中。步骤 1在 WebUI 中输入指令打开http://127.0.0.1:18789在对话框中输入请帮我把桌面上的所有 .jpg 和 .png 图片文件移动到 D:\Pictures\Desktop 文件夹中如果文件夹不存在就创建它。步骤 2OpenClaw 执行任务OpenClaw 会自动列出桌面上的所有文件筛选出 .jpg 和 .png 文件检查目标文件夹是否存在不存在则创建逐个移动文件返回执行结果预期输出✓ 已创建文件夹D:\Pictures\Desktop✓ 移动文件photo1.jpg → D:\Pictures\Desktop\photo1.jpg✓ 移动文件screenshot.png → D:\Pictures\Desktop\screenshot.png✓ 移动文件wallpaper.jpg → D:\Pictures\Desktop\wallpaper.jpg任务完成共移动 3 个文件。步骤 3验证结果打开 D:\Pictures\Desktop 文件夹确认文件已成功移动。七、EasyClawWindows 用户的更简单选择如果你觉得 OpenClaw 的配置过程还是太复杂可以考虑使用 EasyClaw——这是猎豹移动基于 OpenClaw 深度优化的 Windows 客户端版本。EasyClaw 与 OpenClaw 的关系EasyClaw 是 OpenClaw 的封装版本核心框架完全相同技能包Skills和配置文件可以通用EasyClaw 提供了图形化安装界面和内置的免费 API 额度EasyClaw 在 Windows 环境下的具体差异对比项OpenClawEasyClaw安装方式命令行脚本双击安装包依赖环境需手动安装 Node.js内置所有依赖API Key需自行申请内置免费额度界面纯 Web 界面独立桌面客户端技能商店命令行安装图形化商店下载 EasyClaw访问官网https://easyclaw.cn/?f208https://easyclaw.cn/?f208下载 Windows 安装包双击安装即可使用。八、总结核心要点回顾安装方式Windows 用户推荐使用 PowerShell 脚本一键安装或通过 NPM 全局安装环境要求Node.js v22 是必须的建议使用 v24 LTS 版本API Key 配置阿里云百炼新用户有免费额度注意区分免费版和付费版的 API 地址常见报错401 错误通常是 baseUrl 配置不正确修改配置文件后重启即可进阶选择追求开箱即用体验的用户可以选择 EasyClaw安装更简单功能完全兼容OpenClaw 让 AI 从能聊天变成能干活掌握这个工具你就拥有了一个 24 小时在线的数字助手。