常见问题

把最常遇到的安装、平台和启动问题提前讲清楚。

如果你在下载、系统识别、模型配置或首次打开时卡住，通常先看这页就能省掉一轮来回沟通。

下载与安装

下载码和平台识别

OpenClaw 和 Hermes 应该怎么选？

OpenClaw 更适合现成双系统交付和 U 盘发货；Hermes 更适合官方 Hermes 路线、中文图形化安装和本地工作台体验。

下载页显示下载码无效怎么办？

先确认没有多输空格，字母和数字完整无误。如果仍然失败，联系发码方确认下载码状态和有效期。

Mac 怎么区分 Apple Silicon 和 Intel？

在“关于本机”里看芯片名称。显示 M1、M2、M3、M4 就是 Apple Silicon；显示 Intel 则下载 Intel 包。

更新后需要重新拿下载码吗？

下载码只负责拿安装包，不等同于长期授权。是否需要重新拿包，取决于你的交付策略和下载码设置。

Windows 版最低支持什么系统？

当前正式支持 Windows 10 2004 / Build 19041 及以上，以及 Windows 11。更老的系统不建议继续安装这条 Windows 路线。

模型与启动

已经装好了 Hermes，为什么还要配置模型？

安装完成只代表运行环境已经就绪。真正开始用之前，还需要 provider、API Key、base URL 和 model 全部配好。

为什么第一次启动会先打开 hermes model？

因为 Hermes 核心已经装好，不代表模型已经接上。只有先完成模型登录或 API Key 配置，后面的本地工作台才能真正开始对话。

Hermes Web 打开了但还是不能聊天怎么办？

先看页面顶部 API 状态是否在线；如果还没有连上本地 Hermes API，就回启动器检查模型和 gateway 是否真正启动。

系统与权限

首次启动被系统拦截怎么办？

Windows 按提示放行；macOS 在“系统设置 - 隐私与安全性”里允许本次打开，然后按原路径重新启动。

为什么 M 芯片 Mac 里的 Parallels Windows 不能正常跑？

因为 Apple Silicon Mac 里的 Parallels Windows 会额外叠加共享目录、虚拟化和系统权限这些变量，排错会更绕。当前更适合直接测试 macOS 版，或者换实体 Windows 机验证 Windows 包。

哪里能看更深的官方资料？

直接去“官方资料”页，里面整理了 GitHub、Quickstart、CLI 参考和常用模型文档入口。