什么值得买App下载 App ›
连续签到专享现金活动

装OpenClaw前必看:安全软件拦、路径报错、API配置失败,全套避坑指南

下载完zip包,第一件事不是双击打开。先把360、电脑管家、火绒、Windows Defender全关掉,连后台进程都要清干净。这些安全软件会把OpenClaw的文件读写、键鼠模拟行为直接判定为恶意,直接删核心文件。不关干净,安装过程必被拦截。12
解压必须用WinRAR或7-Zip,系统自带解压工具容易丢文件、损权限。解压路径必须是纯英文、无空格、无特殊符号,推荐D:\OpenClaw,千万别塞进C盘。路径带中文或空格,程序直接报错跑不起来。34
Windows可视化一键包:三分钟搞定部署
解压后找到「OpenClaw Windows 一键启动.exe」,双击运行。如果弹出「Windows已保护你的电脑」,点「更多信息」再点「仍要运行」,这是正常的安全提示不是病毒。点击「开始使用」,安装路径选D:\OpenClaw,勾选协议,点击「开始安装」。全程自动,3到5分钟装完,别手贱关窗口。45
装完自动启动,第一次会显示「正在等待Gateway就绪」,等1到3分钟正常。右上角出现「Gateway在线」标识,说明部署成功。如果Gateway一直离线,先检查安全软件有没有漏网之鱼,再尝试重启服务。67
终端党首选:命令行一键安装
管理员身份打开PowerShell,先执行一条解锁命令:Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser,输入Y确认。Windows默认禁止运行远程脚本,不解锁这步安装命令根本跑不动。89
解锁后粘贴执行:iwr -useb https://openclaw.ai/install.ps1 | iex。如果下载慢,换国内镜像:iwr -useb https://open-claw.org.cn/install.ps1 | iex。脚本会自动检测Node.js环境,没装的帮你装22.x版本,全流程2分钟跑完。109
macOS和Linux更简单,终端一条命令搞定:curl -fsSL https://openclaw.ai/install.sh | bash。首次启动运行openclaw onboard,按提示配置模型和渠道,全程交互式操作。1112
接入大模型:阿里云百炼免费额度够用
装完不接大模型就是摆设。进入阿里云百炼控制台,创建API-Key,创建后只显示一次,立刻复制保存。记录Base URL地址,国内用户用阿里云百炼最稳,新用户有免费Token额度。1314
配置文件填入API Key和Base URL,保存后执行openclaw gateway restart让配置生效。或者直接在初始化向导里选「阿里云百炼」,粘贴Key完成配置。地域必须匹配,Key是北京域的别配到上海域去,否则模型调用直接失败。1514
常见问题避坑指南
  • 安全软件拦截:360、电脑管家、火绒、Windows Defender必须全部退出,后台进程也要清。拦截会导致核心文件被删或隔离,安装必失败。1
  • 路径含中文或空格:安装路径必须是纯英文,推荐D:\OpenClaw。路径带中文或空格,程序启动直接报错,Gateway永远离线。3
  • Node.js版本过低:必须22.x以上,低版本语法不兼容,安装完服务起不来。先跑node -v检查版本,不达标先升级。16
  • Gateway持续离线:先关安全软件,再执行openclaw gateway restart。还是离线就跑openclaw doctor做健康检查,逐项排查。17
  • API Key地域不匹配:百炼Key的地域必须和Base URL一致。北京域的Key配到上海域,模型调用直接失败,报错信息是connection timeout。13

评论

评论区空态插画

当前文章无评论,是时候发表评论了