OpenClaw本地部署需满足系统、Python版本、内存等基础要求，推荐脚本安装或Windows一键包，通过onboard向导初始化，启动Gateway服务并关闭安全软件拦截以确保功能正常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地电脑上运行OpenClaw，但尚未完成基础环境配置或首次启动失败，则可能是由于系统依赖缺失、Python版本不兼容、权限限制或杀毒软件拦截所致。以下是实现零基础入门的全流程操作步骤：
一、确认系统与基础环境要求
OpenClaw对硬件和软件环境有明确适配范围，满足最低要求是成功部署的前提。不满足条件将导致安装中断、命令不可识别或运行时崩溃。
1、检查操作系统：Windows 10/11、macOS（Intel或Apple Silicon）、主流Linux发行版（如Ubuntu 22.04+、Debian 12+）均被官方支持。
2、验证Python版本：必须为3.9、3.10或3.11中的一个。打开终端（Windows使用PowerShell，macOS/Linux使用Terminal），输入：python --version 或 python3 --version。
3、若版本不符，前往python.org下载对应版本安装包，安装时务必勾选“Add Python to PATH”选项。
4、确认内存与存储：至少4GB RAM、10GB可用磁盘空间；推荐8GB RAM以上以保障多技能并发运行稳定。
二、选择并执行安装方式
根据技术熟悉程度可选用两种互不冲突的安装路径，任一方式均可独立完成部署。脚本安装适用于所有平台且自动化程度最高；一键部署包专为Windows用户优化，完全规避命令行操作。
1、脚本安装（跨平台推荐）：
? macOS / ? Linux用户，在终端中逐行执行：
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version 验证是否输出版本号（如v2026.3.31）。
2、? Windows用户（PowerShell管理员模式）：
执行：
iwr -useb https://openclaw.ai/install.ps1 | iex
完成后运行：openclaw --version 确认安装成功。
3、Windows一键部署包（零代码首选）：
访问链接：https://openclaw.ikidi.top/api/download/package/14?promoCode=IVB807603D98
下载Openclaw-Windows-2.4.1.zip（约361MB），解压至无中文路径的文件夹（如C:\openclaw），双击start.bat即可启动。
三、初始化配置向导
安装完成后需完成首次配置，该过程建立本地网关服务、绑定AI模型接口、启用基础技能模块。所有选项均支持跳过，后续可通过Web界面动态调整。
1、在终端中运行：openclaw onboard 启动交互式向导。
2、依次选择：
1、QuickStart
2、Skip for now（跳过初始API配置）
3、All providers（启用全部模型接入通道）
4、Keep current（保留默认设置）
5、Skip for now（暂不关联聊天工具）
6、使用空格键取消全部Skills勾选后回车（避免首次加载过多依赖）。
3、向导结束后，系统将自动在默认浏览器中打开http://localhost:3000，即OpenClaw Gateway管理界面。
四、启动并验证本地网关服务
Gateway是OpenClaw的前端控制中心，负责接收指令、调度Agent、呈现执行日志。未启动Gateway则无法通过网页界面操作任何功能。
1、若浏览器未自动打开或页面显示连接失败，手动运行：openclaw gateway。
2、等待终端输出类似"Gateway server listening on http://localhost:3000"提示。
3、刷新浏览器页面，确认左上角显示Online状态及当前运行的Agent数量（初始为1）。
4、点击界面中央的"Run a test task"按钮，选择"List files in home directory"，观察右侧日志区域是否返回本地用户目录下的文件列表。
五、关闭安全软件并解除权限拦截
OpenClaw需调用系统级API执行文件读写、进程控制、键盘模拟等操作，主流安全软件会将其行为判定为高风险并主动拦截，导致技能无法加载、任务静默失败或程序闪退。
1、临时退出以下全部进程：
360安全卫士/杀毒、腾讯电脑管家、火绒安全、Windows Defender实时防护（含后台扫描服务）。
2、Windows用户还需右键“开始”→“运行”→输入gpedit.msc→进入“计算机配置→管理模板→Windows组件→Windows Defender防病毒程序”→双击“关闭Windows Defender防病毒程序”，设为“已启用”。
3、macOS用户需前往“系统设置→隐私与安全性→完全磁盘访问”，将openclaw或对应终端应用拖入授权列表。
4、Linux用户执行：sudo setcap cap_sys_admin+ep $(which openclaw) 授予必要系统能力。
