OpenClaw 安装及配置教程Windows版 | 超详细避坑指南前言OpenClaw 是一款轻量且高效的AI辅助工具与Cherry Studio 配合使用更方便。本文针对 Windows 系统从环境准备、软件安装、配置到卸载全程超详细拆解即使是新手也能一步步跟着完成避免踩坑一、环境准备Node.js Git Win 版本要求Node V22通过 WSL2 的 Windowsgit从 GitHub 克隆/构建并从源代码 checkout 运行为npm设置node_global文件夹二、Cherry Studio 安装Cherry Studio 是 OpenClaw 的配套开发环境需提前安装下载地址前往 Cherry Studio 官方渠道或开发者提供的地址下载 Windows 版安装包。安装步骤双击安装包选择安装路径建议非C盘如D:\Cherry Studio。勾选「创建桌面快捷方式」等待安装完成。启动 Cherry Studio首次打开会自动初始化环境耐心等待即可。三、npm 源配置官方版 国内镜像版npm 默认使用官方源国外下载速度慢建议按需切换国内镜像如淘宝源。切换国内镜像版淘宝源永久切换推荐npm config set registry https://registry.npmmirror.com/ # 验证切换结果 npm config get registry # 输出https://registry.npmmirror.com/如需切回官方源npm config set registry https://registry.npmjs.org/四、OpenClaw 安装npm 方式环境准备完成后通过 npm 安装 OpenClaw步骤如下以管理员身份打开命令行右键cmd选择「以管理员身份运行」避免权限不足。执行安装命令官方版安装npm install -g openclawlatest iwr -useb https://openclaw.ai/install.ps1 | iex国内中文版安装推荐npm install -g openclaw-cnlatest iwr -useb https://clawd.org.cn/install.ps1 | iex等待安装完成安装过程中会下载依赖包若出现警告WARN可忽略无 ERROR 即代表安装成功。#新手引导并安装服务openclaw onboard --install-daemon#启动网关openclaw gateway--port18789#打开浏览器UI页面openclaw dashboard五、OpenClaw 安装成功验证安装完成后通过以下 2 种方式验证5.1 命令行验证命令行执行openclaw -v # 输出OpenClaw版本号如v1.5.0 # 或执行帮助命令 openclaw --help # 输出OpenClaw的命令说明5.2 目录验证全局安装的 OpenClaw 会存放在 Node.js 安装目录的 node_modules 下找到 Node.js 安装路径如C:\Program Files\nodejs。进入node_global文件夹查看是否有openclaw文件夹且内部文件完整。六、在 Cherry Studio 中使用并配置 OpenClaw6.1 关联 OpenClaw启动 Cherry Studio配置你自己的大模型参数。在 Cherry Studio 中打开OpenClaw专属页面初始状态如下3.Node,GitOpenClaw服务建议使用npm单独安装都安装好以后如下6.2 核心配置启动OpenClaw后可以自行配置核心配置文件~/.openclaw/workspace/AGENTS.md # 代理调度规则与标准作业程序BOOTSTRAP.md # 初始化序列与核心系统提示词HEARTBEAT.md # 定时执行逻辑与主动任务状态自检IDENTITY.md # 代理身份定义与系统边界约束MEMORY.md # 长期上下文数据与既定规则的持久化存储SOUL.md # 响应语气、行为特征及输出格式配置TOOLS.md # 工具授权注册表及调用参数规范USER.md # 用户画像数据包含特定偏好与交互限制配置memory/ # 日常运行日志与短期上下文存储skills/ # 已安装的第三方技能扩展目录6.3 测试使用启动后正常就会打开控制页面七、OpenClaw 完全卸载步骤若需彻底卸载 OpenClaw按以下步骤操作避免残留文件影响后续重装步骤 1停止正在运行的服务以管理员身份打开 PowerShell 或命令提示符先让程序停下来。# 停止网关服务openclaw gateway stop# 如果是中文版命令是openclaw-cn gateway stop# 执行官方卸载命令--all 和 --yes 参数会删除所有数据且无需确认openclaw uninstall--all--yes# 如果上面命令报错说明服务可能没在运行直接进行下一步步骤 2使用 npm 卸载主程序在同一个管理员窗口中执行卸载命令。如果你不确定之前装的是哪个版本可以两条都试试。# 卸载原版npm uninstall-g openclaw# 卸载中文版npm uninstall-g openclaw-cn执行后看到类似removed XXX packages的提示就说明卸载成功了 。步骤 3检查并清理残留这是很多人会遗漏的步骤但非常关键。检查全局包运行下面命令看看是否还有残留。npm list-g--depth0如果列表里还有openclaw或openclaw-cn相关的项目说明没卸载干净需要重复步骤2或者针对残留的插件如openclaw/feishu进行单独卸载 。删除系统服务计划任务OpenClaw 会在后台创建一个名为OpenClaw Gateway的计划任务来实现开机自启。需要手动删除它schtasks/Delete/F/TNOpenClaw Gateway手动删除配置和数据文件夹这是存放你所有API Key、对话记录的地方。注意删除后数据无法恢复请谨慎操作。# 删除主配置目录Remove-Item-Recurse-Force$env:USERPROFILE\.openclaw-ErrorAction SilentlyContinue# 删除可能存在的旧版目录Remove-Item-Recurse-Force$env:USERPROFILE\.clawdbot-ErrorAction SilentlyContinueRemove-Item-Recurse-Force$env:USERPROFILE\.moltbot-ErrorAction SilentlyContinue# 删除 AppData 下的残留Remove-Item-Recurse-Force$env:APPDATA\OpenClaw-ErrorAction SilentlyContinue做完以上步骤你的电脑就和 OpenClaw 的旧版本彻底说再见啦。八、常见问题避坑安装时报「权限不足」必须以管理员身份运行 cmd或关闭电脑管家/杀毒软件后重试。Cherry Studio 无法关联 OpenClaw确认 Node.js 全局安装路径正确且 OpenClaw 版本与 Cherry Studio 兼容。npm 安装卡住切换国内源或执行npm cache clean --force清理缓存后重新安装。