qclaw推荐安装在非系统盘以节省c盘空间并提升性能,可通过自定义安装路径、修改注册表/符号链接或命令行参数三种方式实现。
如果您正在为qclaw选择安装位置,但不确定应将其部署在系统盘还是其他磁盘,可能是由于默认路径占用c盘空间过大或影响系统运行效率。以下是针对qclaw安装路径设置的多种可行方法:
一、使用自定义安装路径(推荐)
该方法允许用户在安装过程中主动指定非系统盘目录,避免C盘空间被大量占用,同时提升后续OpenClaw组件(如Docker镜像、模型缓存)的读写性能。
1、双击运行下载的QClaw安装包(如QClaw-Windows-Setup.exe或QClaw-Mac.dmg)。
2、在安装向导界面中,不直接点击“下一步”跳过,而是寻找并点击右下角的「自定义安装」或「高级选项」按钮(Windows版常见于许可证协议页下方;macOS版在拖拽安装前弹出路径选择窗口)。
3、在路径选择框中,手动输入或浏览至D盘、E盘等非系统盘的空闲文件夹,例如:D:\QClaw\ 或 /Volumes/Data/QClaw/。
4、确认路径后继续完成安装流程,QClaw及其依赖环境(Node.js、Docker Desktop配置目录等)将全部部署至该位置。
二、修改默认安装目录注册表/配置文件(进阶)
适用于已误装至C盘且希望迁移而不重装的用户,通过预设安装根路径参数,使后续更新或子模块部署自动沿用新位置。
1、Windows用户:按下Win + R,输入regedit打开注册表编辑器,定位至HKEY_LOCAL_MACHINE\SOFTWARE\QClaw\InstallPath,双击右侧数值,将数据更改为目标路径(如D:\QClaw)。
2、macOS用户:在终端中执行命令创建符号链接,将默认路径重定向至外部卷:sudo ln -sf /Volumes/Data/QClaw /Applications/QClaw.app。
3、重启QClaw安装程序,再次运行时会优先读取该注册表项或符号链接,自动应用新路径。
三、通过命令行指定安装路径(开发者模式)
该方式绕过图形化安装向导,适合批量部署或CI/CD集成场景,可精确控制每个组件落盘位置,确保与现有开发环境隔离。
1、打开终端(macOS/Linux)或PowerShell(Windows),进入QClaw安装包所在目录。
2、Windows执行:QClaw-Windows-Setup.exe --silent --install-dir="D:\QClaw"。
3、macOS执行:installer -pkg QClaw-Mac.pkg -target /Volumes/Data(需提前挂载Data卷并确保有写入权限)。
4、等待命令执行完毕,验证D:\QClaw\bin或/Volumes/Data/QClaw/bin下是否存在可执行文件及config.yaml。










