OpenClaw(国内用户俗称 “小龙虾”)是 2026 年爆火的开源本地 AI 自动化智能体,它可以帮你自动完成电脑上的重复操作:整理文件、批量归类、浏览器自动化、办公任务处理等,全程在本地运行,无需联网、无需云端账号,隐私安全有保障,堪称你的专属 AI 数字员工。

本教程专为 Windows 11 系统打造,覆盖新手一键部署进阶手动安装两种方案,全程 step by step 讲解,帮你规避 99% 的安装坑,新手也能一次成功!

一、安装前必做准备(不做大概率失败!)

90% 的安装失败都源于这一步:OpenClaw 运行时需要模拟键鼠、读写文件、控制浏览器,这些操作会被安全软件误判为 “风险行为”,进而拦截、删除安装文件。请务必在安装前彻底关闭所有安全软件,安装完成后可重新开启!

1. 关闭第三方安全软件

请彻底关闭以下软件的所有进程:

  • 360 系列:360 安全卫士、360 杀毒

  • 腾讯系列:腾讯电脑管家

  • 火绒安全(关闭实时防护功能)

2. 关闭 Windows 11 自带 Defender 实时防护

这是重中之重,必须操作:

  1. 打开 Windows 设置(快捷键 Win+I

  2. 点击「隐私和安全性」→ 选择「Windows 安全中心」

  3. 点击「病毒和威胁防护」→ 找到「管理设置」

  4. 关闭「实时保护」的开关,确认弹窗即可


    二、新手推荐:一键部署方案(零代码・全自动)

    这个方案是专为 Windows 11 优化的一键包,内置所有运行依赖,无需你手动装环境、敲命令,双击就能自动完成所有部署,小白首选!

    步骤 1:下载 Win11 专属一键部署包

    本次教程对应最新稳定版 2.6.2,下载链接:

    官方高速下载:OpenClaw Win11 一键部署包 文件大小:约 361MB,下载后得到 .zip 格式压缩包

    步骤 2:正确解压压缩包(避坑重点!)

    ⚠️ 不要用 Windows 11 自带的解压工具! 它经常出现文件丢失、权限不足的问题,直接导致安装失败。 请使用专业解压工具:WinRAR7-Zip(均为免费软件,网上可直接下载)

    解压步骤:

    1. 找到下载好的压缩包,右键点击它

    2. 选择「解压到当前文件夹」

    3. 解压完成后,会得到 Openclaw-win 文件夹

    4. 校验:打开文件夹,确认里面有 Openclaw Windows一键启动.exe(红色龙虾图标),如果找不到说明解压失败,重新关闭安全软件后再解压。

    步骤 3:放行系统拦截,启动安装程序

    Windows 11 会默认拦截未签名的开源程序,弹出拦截提示,这是正常现象,按以下步骤放行:

    1. 双击 Openclaw Windows一键启动.exe

    2. 系统弹出「Windows 已保护你的电脑」提示窗口

    3. 点击窗口左下角的 【更多信息】点击新出现的 【仍要运行】,即可启动安装程序

    步骤 4:设置安装路径(核心关键!)

    进入安装欢迎界面后,点击红色的「开始使用」按钮,进入路径设置环节:

    ⚠️ 安装路径必须是纯英文路径,禁止包含中文、空格、特殊符号(如 @、#、&),否则 100% 报错!

    推荐路径(优先选)

    • D:\OpenClaw(简单易记,不占 C 盘空间)

    • E:\AI\OpenClaw(适合分类存放软件的用户)

    绝对禁止的路径(必报错)

    • D:\软件\OpenClaw(包含中文)

    • D:\小龙虾(包含中文,和软件昵称无关!)C:\Program Files\OpenClaw(路径包含空格,触发权限问题)

    步骤 5:等待全自动安装

    设置好路径后,点击「开始安装」,接下来你什么都不用做,程序会自动完成:

    • 系统环境检测

    • 运行依赖自动安装

    • 核心服务部署

    • 系统权限配置

    • 桌面快捷方式创建

    整个过程需要 3-5 分钟,期间不要关闭安装窗口,耐心等待即可。

    步骤 6:启动验证,确认安装成功

    安装完成后,程序会自动打开 OpenClaw 主界面,你只需要看右上角的状态:

    • 如果显示 「Gateway 在线」,说明部署成功,可以正常使用了!

    • 如果显示离线,参考文末的常见问题排查即可。


    三、进阶用户:手动命令行安装方案

    如果你是有基础的用户,想要手动部署,可以用这个方案,适合需要自定义配置的场景。

    步骤 1:安装基础依赖

    OpenClaw 依赖 Git 和 Node.js,先安装这两个工具:

    1. 安装 Git: 下载地址:Git-2.52.0-64-bit.exe 安装要点:全程默认下一步,无需修改配置。

    2. 安装 Node.js: 下载地址:Node.js 官网 安装要点:选择LTS 稳定版,且版本必须≥22,默认安装即可,自动配置环境变量。

    3. 验证环境: 以管理员身份打开 CMD,输入以下命令,出现版本号说明环境正常:git --version node -v npm -v

      步骤 2:安装 OpenClaw 核心程序

      1. 以管理员身份打开 CMD(右键开始菜单→Windows 终端 (管理员))

      2. 执行安装命令,国内用户推荐用淘宝镜像加速:npm i -g openclaw --ignore-scripts --registry=https://registry.npmmirror.com

          如果遇到脚本执行权限报错,先执行这个命令:Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

        1. 验证安装:输入 openclaw --version,出现版本号说明安装成功。

        步骤 3:初始化配置与启动

        1. 执行初始化命令:openclaw onboard --install-daemon

          1. 按照向导配置:

            1. 协议确认:选 Yes

            2. 安装模式:选 QuickStart

            3. 模型选择:新手推荐 Qwen(通义千问)或 Moonshot AI(Kimi)

            4. 输入对应平台的 API Key(如果没有可以后续配置)

            5. 其余选项全部选 Skip for now 即可

          2. 配置完成后,选择 Open the Web UI,浏览器会自动打开本地面板:http://127.0.0.1:18789/chat,即可开始使用。


          四、快速上手:3 个指令马上体验

          安装完成后,你可以直接在输入框输入自然语言指令,AI 会自动执行,推荐几个常用指令试试:

          1. 整理D盘下载文件夹内的所有图片,按格式分类存放

          2. 打开浏览器,搜索“2026 AI智能体发展趋势”,把找到的相关表格保存到桌面

          3. 批量归类桌面所有文件,按文档、图片、安装包分类

          4. 检查电脑里的垃圾文件,帮我清理掉(不删除重要文件)


          五、常见问题排查(收藏备用)

          问题

          解决方法

          安装时提示 “权限不足”

          右键点击安装程序,选择「以管理员身份运行」,重新启动安装

          主界面 Gateway 一直显示离线

          1. 确认 Defender 实时防护已关闭;2. 检查安装路径是否为纯英文;3. 重启 OpenClaw 程序

          首次启动特别慢,长时间无响应

          Win11 首次启动需要初始化系统环境,等待 1-3 分钟属于正常现象,后续启动会变快

          AI 无法控制鼠标、无法读写文件

          关闭 OpenClaw,右键桌面快捷方式,选择「以管理员身份运行」,重新启动即可

          安装文件被杀毒软件删除,找不到启动程序

          彻底关闭所有安全软件,重新下载压缩包、重新解压安装,避免再次被拦截

          手动安装时报错 code 128

          重试安装命令,检查网络是否正常,确认 Git 已经正确安装


          六、后续注意事项

          1. 安装完成后,你可以重新开启之前关闭的安全软件和 Defender 实时防护,不会影响正常使用。

          2. 如果需要更新版本,重新下载最新的一键包,覆盖安装即可,配置会自动保留。

          3. 如果需要卸载,直接删除安装文件夹,然后删除桌面快捷方式即可,没有残留文件。

          Logo

          AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

          更多推荐