首次本地部署openclaw需依次完成关闭安全软件、下载解压部署包、以管理员身份运行安装程序、配置纯ascii路径并初始化服务、最后通过localhost:8080/health和/test验证gateway与agent状态正常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您是首次接触OpenClaw，希望在本地电脑上完成安装并进入可操作状态，则需依次完成部署包获取、权限放行、路径配置与服务初始化等关键环节。以下是完整的新手入门操作流程：
一、关闭安全软件拦截
OpenClaw在安装及运行过程中需调用系统级API、模拟键盘鼠标操作、读写本地文件系统，并建立本地HTTP服务端口。主流安全防护软件（如360安全卫士、腾讯电脑管家、火绒）会将其行为识别为高风险动作并主动拦截，导致解压失败、进程闪退、配置文件无法写入或服务端口被封锁。
1、打开任务管理器，结束所有正在运行的360安全卫士、360杀毒、腾讯电脑管家、火绒安全软件进程
2、进入对应软件设置中心，临时关闭“实时防护”“主动防御”“USB设备监控”“开机自启”四项功能
3、确认系统托盘区域无上述软件图标常驻，且其后台服务进程（如QHSafeTray.exe、QQPCTray.exe、Hips.exe）已完全退出
二、下载与解压部署包
OpenClaw官方Windows部署包为单体压缩包，内含全部运行依赖（Node.js 20.18、Python 3.12、Git 2.45、pnpm 9.12），无需用户单独安装运行环境。该包通过云分发CDN加速，但对网络稳定性敏感，使用系统自带解压工具易出现文件校验失败或目录结构错乱。
1、使用Chrome或Edge浏览器访问：https://xiake.yun/api/download/package/12?promoCode=IV3FAC171F46
2、右键下载链接，选择“另存为”，保存至桌面或D盘根目录等明确路径
3、下载完成后，右键点击压缩包，选择“使用WinRAR解压到当前文件夹”或“使用7-Zip解压到当前文件夹”
4、确认解压后生成名为Openclaw-win的文件夹，且其内部包含Openclaw Windows 一键启动.exe、config、runtime、logs等子目录
三、启动一键安装程序
该程序封装了环境检测、路径校验、权限申请与服务注册全流程，运行时需绕过Windows SmartScreen应用信誉验证机制。若跳过此步骤直接双击运行，将触发系统级拦截，导致安装界面无法加载。
1、进入Openclaw-win文件夹，找到Openclaw Windows 一键启动.exe文件
2、右键点击该文件，选择“以管理员身份运行”
发布后文档同步技能，自动将 README/ARCHITECTURE/CONTRIBUTING/CLAUDE.md 与实际变更对齐，清理待办事项，完善变更记录。
3、若弹出SmartScreen警告窗口，点击“更多信息”，再点击“仍要运行”
4、等待黑色命令行窗口短暂闪烁后自动关闭，桌面将生成OpenClaw快捷方式图标
四、执行初始化配置
初始化过程将创建用户专属工作空间、生成加密记忆存储区、绑定默认通讯通道（WhatsApp/Slack）、校验Gateway与Agent组件通信链路。所有路径必须为纯ASCII字符，中文路径或空格会导致Memory模块初始化失败，进而引发后续所有技能调用返回空响应。
1、双击桌面OpenClaw快捷方式，启动主配置界面
2、在“安装路径”输入框中，手动输入D:\OpenClaw（不可使用C:\Program Files\等含空格路径）
3、勾选“我已阅读并接受用户协议与免责声明”复选框
4、点击“开始安装”按钮，界面显示绿色进度条并依次输出：[✓] 检测Git、[✓] 检测Node.js、[✓] 初始化Memory数据库、[✓] 启动Gateway监听端口8080
5、当界面底部出现“初始化完成，正在启动Agent服务…”提示时，保持窗口开启，勿强制关闭
五、验证本地服务可用性
初始化成功后，OpenClaw会在本地启动两个核心服务：Gateway（HTTP API网关，端口8080）与Agent（任务调度中枢，IPC通信）。仅当二者均正常响应，才代表系统进入可交互状态。此时未配置任何外部通讯工具亦可进行基础指令测试。
1、打开浏览器，访问http://localhost:8080/health
2、页面返回JSON内容：{"status":"ok","gateway":"online","agent":"ready"}
3、在浏览器地址栏修改为http://localhost:8080/test
4、输入自然语言指令，例如：“列出当前目录下的所有.txt文件”，点击发送，观察是否返回文件列表结果
