官方一键安装脚本放在 GitHub 上，国内直连经常超时。两条思路二选一：给 curl 配你自己的代理，或者用 GitHub 加速镜像前缀。脚本本身和官方完全一致，加速只解决“下载到”这一步。
# 国内直连 raw.githubusercontent.com 经常超时。
# 思路一：给 curl / git 配置你自己的 HTTP 代理后再跑官方脚本
export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 思路二：用 GitHub 加速镜像前缀拉取安装脚本（按你常用的加速服务替换域名）
curl -fsSL https://<github加速域名>/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash# 安装器用 uv 管理 Python 依赖。国内拉包慢时，给 uv 指一个国内 PyPI 镜像：
export UV_DEFAULT_INDEX=https://pypi.tuna.tsinghua.edu.cn/simple
# 或写进 ~/.config/uv/uv.toml，长期生效。
# 装完照常验收：
hermes --version
hermes doctor这是国内用户最该知道的一点：Hermes Agent 不绑定 OpenRouter。上游官方就支持一批国内可直连的模型 Provider，日常使用完全不依赖境外网络。用 hermes model 选一个即可。
minimaxi.com
国内可直接申请 API Key，中文长文本和对话稳定，适合做日报、摘要和客服草稿。
bigmodel.cn / z.ai
GLM 系列国内访问顺畅，工具调用和结构化输出表现好，适合工作流和 Skills。
platform.moonshot.cn
超长上下文是强项，研究、长文档整理类任务优先考虑。
xiaomimimo.com
上游官方明确支持的 Provider 之一，国内入口，适合低成本文本任务试跑。
申请到任意一家的 API Key 后，把它配进 Hermes，再用一句短问答确认链路，就可以开始跑工作流了：
# 关键：不想折腾梯子，就别用 OpenRouter，直接选国内 Provider。
hermes model # 交互式选 Provider 和默认模型
hermes model --refresh # 新模型刚上线、列表里找不到时清缓存重拉
hermes config check # 确认 Key 写进了 ~/.hermes/.env、当前 shell 能读到
hermes -z "用一句话确认你能正常回复" # 单次执行验证链路先确认是 GitHub 网络问题：单独 curl 一次脚本地址看是否能下载。给 curl 配代理，或用 GitHub 加速镜像前缀重试；都不行就按官方手动步骤，用 uv 装。
设 UV_DEFAULT_INDEX 指向清华、阿里等国内 PyPI 镜像，再重跑安装。镜像只影响下载源，不影响 Hermes 本身。
这通常不是配置错，是网络到不了。最省心的解法不是配代理，而是 hermes model 换成 MiniMax、GLM、Kimi 这类国内可直连的 Provider。
用官方一键脚本即可，不需要手动 clone 整个仓库。确实要源码时，用国内 Git 镜像站同步后再拉。