在WSL2中安装Hermes Agent v0.18.0需全程使用国内镜像：执行curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash启动安装；中断后手动用清华源安装依赖uv pip install -e ".[all]" -i https://pypi.tuna.tsinghua.edu.cn/simple；配置DashScope时指定国内Base URL或临时禁用SSL验证；最后通过hermes --version、hermes chat -q "hi"和hermes gateway status三步验证成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Windows WSL2中安装Hermes Agent v0.18.0时遇到网络超时，本质是官方安装脚本默认从raw.githubusercontent.com、GitHub、PyPI等境外源拉取资源，国内直连失败导致卡死或报错curl: (35) Recv failure: Connection reset by peer。必须绕过原始链路，全程使用国内镜像替代。
替换安装入口：用国内加速脚本启动
不要执行任何来自GitHub raw的官方curl命令。打开WSL2终端，直接运行：
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
该地址为官方维护的国内镜像站，已预编译v0.18.0对应依赖包并托管在阿里云OSS，无需DNS解析GitHub，规避首次卡顿。
若已卡在“Installing dependencies”阶段
这是最常见中断点——uv包管理器正尝试从pypi.org下载数十个Python依赖，国内直连基本无法完成。
立即按Ctrl+C中断当前脚本，不要等待或重试。
进入项目目录：cd ~/.hermes/hermes-agent
激活虚拟环境：source venv/bin/activate
手动指定清华源安装全部依赖：uv pip install -e ".[all]" -i https://pypi.tuna.tsinghua.edu.cn/simple
这一步耗时约2–4分钟，完成后重新执行./scripts/install.sh，脚本会检测到依赖已存在，自动跳过该步骤继续。
初始化配置时API连接超时
执行hermes setup后，在「选择模型服务商」环节选Qwen Cloud / DashScope，但填完API Key后卡在「测试连接」或提示timeout，说明HTTP客户端未适配国内弱网环境。
方法一：强制使用国内接口地址
粘贴DASHSCOPE_API_KEY后，不要回车确认默认Base URL；手动输入：https://dashscope.aliyuncs.com/compatible-mode/v1
方法二：临时禁用SSL验证（仅限首次调试）
编辑配置文件：nano ~/.hermes/config.yaml
在model:节点下新增一行：verify_ssl: false
【注意】此设置仅用于绕过自签名证书或内网代理拦截，生产环境务必删掉该行并导入可信CA证书。
验证安装是否真正成功
第一步：检查基础命令是否就绪
运行hermes --version，输出应为v0.18.0，而非报command not found。
第二步：触发一次本地模型调用
执行hermes chat -q "hi"，等待3秒内返回响应文本，不出现httpx.ConnectTimeout或ReadTimeout异常。
第三步：确认gateway模块可加载
运行hermes gateway status，输出应含status: running或status: not started (but config loaded)；若报ModuleNotFoundError: No module named 'hermes_gateway'，说明安装未完成，需退回第二阶段重装依赖。
