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

📅 发布时间:2026/7/5 3:21:54 👁️ 浏览次数:
windows安装openClaw全流程保姆级教程(2026年03月09日最新版)
OpenClaw俗称“龙虾”是一款开源的本地AI智能体网关核心功能是帮用户自动操作电脑、对接大模型实现智能化任务纯粹的实用工具️。本文仅分享官方正规安装流程全程基于OpenClaw官方开源资源适合零基础Windows用户快速上手步骤清晰可复现新手跟着走就能成功安装一、安装前必看避坑关键1.1 系统与配置要求提前确认电脑满足以下条件避免安装失败最低要求即可正常运行推荐配置体验更佳操作系统Windows 10 1903及以上版本、Windows 1164位系统不支持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默认禁止运行远程脚本需先修改执行策略否则安装脚本无法运行在PowerShell窗口中复制以下命令首次安装需执行直接复制不要手动输入避免输错Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser2. 粘贴完成后按「回车」此时会提示「是否要更改执行策略」输入「Y」并按「回车」确认即可执行策略仅修改当前用户不影响系统安全。步骤3执行官方一键安装脚本提供两个脚本优先使用官方原版若下载速度慢切换为国内镜像脚本均为官方正规渠道无侵权方案1官方原版脚本推荐适合网络通畅的用户iwr -useb https://openclaw.ai/install.ps1 | iex方案2国内镜像脚本适合下载慢、卡顿的用户iwr -useb https://clawd.org.cn/install.ps1 | iex操作方式复制上面任意一个脚本粘贴到PowerShell窗口中按「回车」执行脚本会自动开始安装全程无需手动操作安装过程中会自动检测并安装Node.jsOpenClaw运行必需、配置环境变量、下载核心程序及依赖耐心等待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个问题附详细解决方案遇到问题直接对照排查问题1PowerShell执行脚本提示「权限不足」原因未以管理员身份打开PowerShell或执行策略未修改。解决方案关闭当前PowerShell重新以「管理员身份」打开重新执行「步骤2设置执行策略」再运行安装脚本。问题2安装脚本下载缓慢、卡顿或报错「ENOTFOUND」原因网络问题或官方服务器在境外国内访问速度慢。解决方案切换为「国内镜像脚本」重新安装或检查网络连接关闭VPN后重试。问题3启动网关提示「端口18789被占用」原因其他软件占用了OpenClaw默认端口。解决方案在PowerShell中输入以下命令更换端口启动openclaw gateway --port 18790然后浏览器访问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 openclawlatest」即可关闭服务若需关闭OpenClaw网关输入「openclaw stop」查看日志若出现问题输入「openclaw logs --tail 100」查看运行日志方便排查问题安全设置定期检查控制面板中的安全设置关闭不必要的公网访问避免被黑客利用。 最后提醒理性使用OpenClaw远离各类“赚钱骗局”专注于工具本身的实用功能让AI帮你提升工作、学习效率