OpenClaw(俗称“龙虾”)是一款开源的本地AI智能体网关,核心功能是帮用户自动操作电脑、对接大模型实现智能化任务,纯粹的实用工具。本文仅分享官方正规安装流程,全程基于OpenClaw官方开源资源,适合零基础Windows用户快速上手,步骤清晰可复现,新手跟着走就能成功安装~
一、安装前必看(避坑关键)
1.1 系统与配置要求
提前确认电脑满足以下条件,避免安装失败(最低要求即可正常运行,推荐配置体验更佳):
操作系统:Windows 10 1903及以上版本、Windows 11(64位系统,不支持Windows 7/8/8.1)
内存:最低2GB,推荐4GB及以上
存储空间:至少预留500MB(用于安装核心程序及依赖)
网络:稳定联网(用于下载安装包及依赖,后续调用AI需联网,通过Ollama跑本地模型可离线使用)
其他:无需提前安装Node.js、Git等工具,一键脚本会自动完成环境配置
1.2 安全提醒(重中之重)
1. 仅从OpenClaw官方渠道获取安装脚本,切勿下载第三方修改版、APK安装包,避免捆绑病毒、盗取用户信息;
2. 安装过程中若杀毒软件提示“风险”,属于误报(因脚本需配置系统环境变量),可暂时关闭杀毒软件或添加信任;
3. OpenClaw是本地工具,不存在“养虾分红”“充值赚钱”等功能,凡是让你充值、拉人头的都是骗局,直接举报;
4. 安装完成后建议关闭不必要的公网访问、设置强密码,降低信息泄露风险(工信部提示:默认配置下存在一定安全风险)。
二、一键安装核心步骤(全程复制粘贴,无需手动配置)
本文优先推荐「官方一键脚本安装」,这是最简单、最稳定的方式,无需手动配置环境,适合所有新手,全程3-5分钟即可完成。
步骤1:以管理员身份打开PowerShell
这是关键一步,普通权限会导致安装失败,操作如下:
右键点击电脑左下角「开始菜单」;
在弹出的菜单中,选择「Windows PowerShell (管理员)」(Windows 11可能显示「终端 (管理员)」,点击即可);
弹出「用户账户控制」提示框,点击「是」,进入管理员权限的PowerShell窗口(窗口标题带「管理员」字样即为成功)。
补充:若找不到PowerShell,可按「Win + R」输入「powershell」,然后按住「Ctrl + Shift + Enter」,也能以管理员身份打开。
步骤2:设置PowerShell执行策略(首次安装必做)
Windows 默认禁止运行远程脚本,需先修改执行策略,否则安装脚本无法运行:
1.在PowerShell窗口中,复制以下命令(首次安装需执行,直接复制,不要手动输入,避免输错):
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
2. 粘贴完成后按「回车」,此时会提示「是否要更改执行策略」,输入「Y」并按「回车」确认即可(执行策略仅修改当前用户,不影响系统安全)。
步骤3:执行官方一键安装脚本
提供两个脚本,优先使用官方原版,若下载速度慢,切换 为国内镜像脚本(均为官方正规渠道,无侵权):
方案1:官方原版脚本(推荐,适合网络通畅的用户)
iwr -useb https://openclaw.ai/install.ps1 | iex
方案2:国内镜像 脚本(适合下载慢、卡顿的用户)
iwr -useb https://clawd.org.cn/install.ps1 | iex
操作方式:
复制上面任意一个脚本,粘贴到PowerShell窗口中;
按「回车」执行,脚本会自动开始安装,全程无需手动操作;
安装过程中会自动检测并安装Node.js(OpenClaw运行必需)、配置环境变量、下载核心程序及依赖,耐心等待3-5分钟(具体时间取决于网络速度)。
安装成功提示:当PowerShell窗口出现「Install completed successfully」字样,即为安装完成,无报错则说明环境配置正常。
三、安装后初始化配置(必做,否则无法使用)
OpenClaw需要配置AI大模型 密钥(相当于给AI装“大脑”),才能正常运行,初始化过程全程按提示操作,新手也能轻松完成。
步骤1:启动初始化向导
在PowerShell窗口中,复制以下命令并按「回车」:
openclaw onboard
步骤2:按向导完成配置(全程中文提示)
选择AI供应商:按提示选择你拥有密钥的大模型供应商(如OpenAI、Anthropic、Google,或选择Ollama跑本地模型),按「回车」确认;
添加API Key:从对应大模型供应商后台获取API Key,粘贴到窗口中(粘贴后按「回车」,密钥会存储在本地,不会上传到第三方);
选择配置模式:推荐新手选择「QuickStart(快速启动)」模式,按「回车」,后续步骤直接按提示选「Yes」或回车即可;
连接聊天平台(可选):可选择连接WhatsApp、Telegram等平台,方便通过聊天软件控制OpenClaw,不想连接直接跳过;
完成初始化:当提示「Onboard completed」,即为配置成功。
提示:若没有API Key,可先选择「Ollama」跑本地模型(无需密钥),后续再补充配置其他大模型密钥;API Key获取方式可参考各大模型官方文档,本文不涉及第三方密钥分享,避免侵权。
四、启动OpenClaw并验证安装
步骤1:启动OpenClaw网关服务
在PowerShell窗口中,输入以下命令并按「回车」:
openclaw start
启动成功提示:窗口显示「Gateway started successfully on port 18789」,说明服务已正常启动。
步骤2:访问OpenClaw控制面板
打开电脑任意浏览器(Edge、Chrome、Firefox均可);
在地址栏输入:http://localhost:18789,按「回车」;
若能正常显示OpenClaw控制面板(中文界面),即为安装+启动成功,可以开始使用啦~
步骤3:验证核心功能(可选)
在控制面板中,点击「测试对话」,发送一句指令(如“帮我列出桌面文件”),若能正常响应,说明AI配置及服务均正常。
五、常见问题排查(新手必看,避坑指南)
整理了安装过程中最常见的4个问题,附详细解决方案,遇到问题直接对照排查:
问题1:PowerShell执行脚本提示「权限不足」
原因:未以管理员身份打开PowerShell,或执行策略未修改。
解决方案:关闭当前PowerShell,重新以「管理员身份」打开,重新执行「步骤2:设置执行策略」,再运行安装脚本。
问题2:安装脚本下载缓慢、卡顿或报错「ENOTFOUND」
原因:网络问题,或官方服务器在境外,国内访问速度慢。
解决方案:切换为「国内镜像脚本」重新安装,或检查网络连接,关闭VPN后重试。
问题3:启动网关提示「端口18789被占用」
原因:其他软件占用了OpenClaw默认端口。
openclaw gateway --port 18790
解决方案:在PowerShell中输入以下命令,更换端口启动:
然后浏览器访问:http://localhost:18790 即可。
问题4:初始化时「openclaw onboard」卡住或超时
原因:网络问题,无法下载相关依赖,或API Key配置错误。
解决方案:
检查网络连接,确保能正常访问互联网;
若API Key配置错误,输入「openclaw reset --confirm」重置配置,重新执行「openclaw onboard」;
若仍卡住,输入「(Net.ServicePointManager)::SecurityProtocol = (Net.SecurityProtocolType)::Tls12」,再重新执行初始化命令。
六、补充说明(使用规范)
升级OpenClaw:后续若需更新版本,在PowerShell中输入「npm update -g openclaw@latest」即可;
关闭服务:若需关闭OpenClaw网关,输入「openclaw stop」;
查看日志:若出现问题,输入「openclaw logs --tail 100」查看运行日志,方便排查问题;
安全设置:定期检查控制面板中的安全设置,关闭不必要的公网访问,避免被黑客利用。
最后提醒:理性使用OpenClaw,远离各类“赚钱骗局”,专注于工具本身的实用功能,让AI帮你提升工作、学习效率~

