大数跨境

Windows安装openClaw全流程保姆级教程(2026年03月09日最新版)

Windows安装openClaw全流程保姆级教程(2026年03月09日最新版) Ashley谈ChatGPT
2026-03-10
74
导读:本文仅分享官方正规安装流程,全程基于OpenClaw官方开源资源,适合零基础Windows用户快速上手,步骤清晰可复现,新手跟着走就能成功安装~

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帮你提升工作、学习效率~

【声明】内容源于网络
0
0
Ashley谈ChatGPT
跨境大V Ashley分享ChatGPT的使用心得
内容 1
粉丝 0
Ashley谈ChatGPT 跨境大V Ashley分享ChatGPT的使用心得
总阅读72
粉丝0
内容1