China

Hermes Agent 国内安装与使用

国内网络装 Hermes Agent 的两个真痛点是 GitHub 慢和 OpenRouter 要梯子。这一页把安装加速、国内可直连模型和常见网络问题集中讲清楚，目标是不用梯子也能稳定跑通。

01 / 安装加速

先让安装脚本能下载下来

安装脚本本身很小，但它运行时还要 clone GitHub 上的代码，再下载 uv、Python、Node.js 和浏览器，这几段在国内都可能卡住。最稳的做法是给整个终端配代理；只给脚本地址加速，后面 clone 代码时照样会卡。

安装脚本加速

# 安装脚本不只是下载一个文件：运行时还会去 github.com clone 代码，
# 并从 astral.sh、nodejs.org 等境外地址下载 uv、Python、Node.js 和浏览器。
# 最稳的做法是给整个终端配上你自己的代理，再跑官方脚本：
export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# 用不到浏览器自动化，可以跳过 Playwright 浏览器下载，少一段境外下载：
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser

# GitHub 加速镜像前缀只能帮你把脚本本身下载下来，
# 脚本后面 clone 代码时仍然要能访问 github.com：
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
# 只能用环境变量：安装脚本设置了 UV_NO_CONFIG=1，写进 ~/.config/uv/uv.toml 不生效。
# 镜像能否完整拉到新版依赖要自己试；装不上就回到上面的代理方案。
# 装完照常验收：
hermes --version
hermes doctor

02 / 国内可直连模型

不想折腾梯子，就直接用国内 Provider

这是国内用户最该知道的一点：Hermes Agent 不绑定 OpenRouter。上游官方就支持一批国内可直连的模型 Provider，日常使用完全不依赖境外网络。用 hermes model 选一个即可。

MiniMax（国内站）

minimaxi.com

hermes model 里选：MiniMax (China)

MINIMAX_CN_API_KEY

在 minimaxi.com 申请的 Key 要配国内站选项；只写 MiniMax 的那项是海外站 minimax.io 的端点，国内账号连不上。

MiniMax（国内站）配置教程

智谱 GLM

bigmodel.cn / z.ai

hermes model 里选：Z.AI / GLM

GLM_API_KEY

只有一个选项，Hermes 会自动探测国际站、国内站和 Coding Plan 端点。

智谱 GLM 配置教程

Kimi / Moonshot（国内站）

platform.moonshot.cn

hermes model 里选：Kimi / Moonshot (China)

KIMI_CN_API_KEY

platform.moonshot.cn 的 Key 配这一项；不带 China 的选项连的是海外端点。

Kimi / Moonshot（国内站）配置教程

小米 MiMo

xiaomimimo.com

hermes model 里选：Xiaomi MiMo

XIAOMI_API_KEY

上游官方支持的 Provider 之一，适合先拿低成本文本任务试跑。

小米 MiMo 配置教程

通义千问 / 阿里百炼

阿里云百炼

hermes model 里选：Qwen Cloud

DASHSCOPE_API_KEY

国内账号对应 alibaba-cn 端点；阿里云的 Coding Plan、Token Plan 也各有国内站选项，需要较新的 Hermes 版本。

DeepSeek

DeepSeek 开放平台

hermes model 里选：DeepSeek

DEEPSEEK_API_KEY

国内直接申请 Key。新版会把旧模型名 deepseek-chat、deepseek-reasoner 自动改写成 deepseek-flash。

腾讯 TokenHub

腾讯云

hermes model 里选：Tencent TokenHub

TOKENHUB_API_KEY

腾讯云的模型服务入口；另有 Tencent TokenPlan 选项（TOKENPLAN_API_KEY）。

阶跃星辰 StepFun

阶跃星辰开放平台

hermes model 里选：StepFun Step Plan

STEPFUN_API_KEY

上游官方支持的国内 Provider 之一。

申请到任意一家的 API Key 后，把它配进 Hermes，再用一句短问答确认链路，就可以开始跑工作流了：

# 关键：不想折腾梯子，就别用 OpenRouter，直接选国内 Provider。
hermes model            # 交互式选 Provider 和默认模型，注意选带 China 的国内站选项
hermes model --refresh  # 新模型刚上线、列表里找不到时清缓存重拉
hermes doctor           # 检查 Key 是否写进了 ~/.hermes/.env、能不能连通
hermes -z "用一句话确认你能正常回复"   # 单次执行验证链路

03 / 网络问题排查

国内最常见的几个卡点

install.sh 卡住或下载超时

先确认卡在哪一段：单独 curl 一次脚本地址，能下载说明脚本没问题，卡的是后面 clone GitHub 或下载依赖。给整个终端配代理最省事；用不到浏览器自动化就加 --skip-browser。

uv / pip 拉依赖很慢

设环境变量 UV_DEFAULT_INDEX 指向清华、阿里等国内 PyPI 镜像，再重跑安装（写进 uv.toml 不生效）。镜像只影响下载源，不影响 Hermes 本身；装不上就改用代理。

OpenRouter 连不上 / 一直 timeout

这通常不是配置错，是网络到不了。最省心的解法不是配代理，而是 hermes model 换成 MiniMax、GLM、Kimi 这类国内 Provider，并选对国内站选项。

git clone 仓库很慢

安装脚本本身就要从 github.com clone 仓库，这一步绕不开。给终端配代理；或者先用国内 Git 镜像站同步出一份代码，再按官方文档的手动安装步骤装。

04 / 下一步

跑通之后往哪走

装好、选好国内模型、确认短问答能回复，就完成了国内环境最难的一步。接下来按主线深入安装验收、模型路由和工作流模板。

安装部署主线模型接入指南

安装脚本能在国内网络下完整下载并跑通。

默认模型用的是国内可直连 Provider，hermes -z 短问答能正常回复。

API Key 写在 ~/.hermes/.env，没有暴露在前端或公开仓库。

免费资源包已通过网盘下载，README 能打开。

国内使用常见问题

在国内用 Hermes Agent 一定要梯子吗？+

不一定。安装阶段要能访问 GitHub 和几个境外下载源，配好代理装一次即可；运行阶段选 MiniMax、智谱 GLM、Kimi、通义千问、DeepSeek 这些国内 Provider，日常使用就不依赖梯子。注意新版设置向导默认推荐的 Nous Portal 是境外服务，国内能否稳定登录请自测；用国内 Key 时在向导里选 Full setup。

国内 Provider 和 OpenRouter 比，差在哪？+

OpenRouter 的优势是一个 Key 接大量模型、方便比价切换，但国内访问不稳。国内 Provider 胜在直连，中文场景也更成熟。建议国内用户默认用国内 Provider，需要某个特定海外模型时再单独配 OpenRouter。

切换 Provider 需要改代码或重装吗？+

不需要。用 hermes model 重选一次 Provider 和默认模型即可，不改代码、不重装。CLI 下次开会话就用新配置；网关要开一个新会话，或者运行 hermes gateway restart。先用 hermes -z 跑一句短问答确认新 Provider 能用，再恢复日常工作流。

资源包要不要翻墙下载？+

不用。本站的免费 Starter 资源包提供夸克网盘和百度网盘下载，国内直接打开即可，无需登录境外服务。