作者码锅 | 个人原创未经授权禁止转载系列定位Hermes Agent 入门实战系列 · 第 2 篇 / 共 8 篇上一篇回顾第 1 篇讲了为什么我要放弃 ChatGPT 自己装 Hermes如果你对 Agent 是什么还不太清楚先去补一下那篇再回来。先说结论一行命令就能装好Hermes 的桌面端安装和装普通软件一样双击走引导。但作为一个开发者我更推荐终端一行命令——配置完全一致而且装完你就能直接进入命令行控制它。这篇文章只讲终端安装和配通桌面端双击安装不展开——双击不会出错不值得写。环境要求项目要求系统macOS 12 / Ubuntu 20.04 / WindowsWSL2Python3.10Node.js18内存4GB 就够前提是你不在本地跑大模型Windows 原生也能装但官方标注为 Early Beta追求稳定走 WSL2 或桌面端。第 1 步一行命令安装打开终端跑curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bashGitHub 直连慢的换中文社区镜像curl-fsSLhttps://res1.hermesagent.org.cn/install.sh|bash脚本会自动完成依赖检测 → 拉取程序 → 初始化数据目录~/.hermes。装完后 Hermes 的数据全在这个目录~/.hermes/ ├── config.yaml ← 配置模型、provider ├── .env ← API 密钥别外传 ├── skills/ ← 技能库会自动长大 ├── sessions/ ← 会话记录 ├── cron/ ← 定时任务 └── memories/ ← 长期记忆重装不影响这个目录里的数据所以~/.hermes丢了等于失忆定期备份。第 2 步确认装好了hermes--version注意是--version不是version。新版改成了标准参数。正常输出Hermes Agent v0.20.x Python: 3.11.x Install method: git再跑一次体检hermes doctor它会逐项检查环境。带 ✓ 的核心功能全绿就 OK带 ⚠ 的都是非必需功能缺 key 不影响聊天✓ uv found ✓ Python 3.11.15 ✓ Node.js v22.23.1 ✓ Skills Hub directory exists ⚠ web: 缺 EXA_API_KEY / TAVILY_API_KEY ⚠ No GITHUB_TOKEN限速 60 req/hr第 3 步跑配置向导第一次跑hermes会自动进入配置向导大概问 5 轮轮次内容怎么选第 1 轮安装模式Quick官方免费模型/ Full自带 key/ Blank几乎全关第 2 轮配 provider API key有 key 选 Full没 key 选 Quick第 3 轮命令执行后端Local / Docker新手选 Local第 4 轮消息网关要不要接微信/Telegram第 5 轮默认模型 核心开关记住开持久记忆和技能生成新手千万别选 Blank Slate——漏配一个开关后面就「莫名失灵」还找不到原因。任何一步按 CtrlC 退出重来已填内容不会丢。三个免费方案零预算也能跑不想花钱也有三条路方案说明OpenRouter 免费模型注册即用模型名带:free后缀商汤日日新 Token Plan4 个模型公测免费Ollama 本地模型完全免费不吃 API 额度商汤日日新那条我专门写过一篇详细教程从注册到调通一步不落——公众号「码锅炖AI」上发过感兴趣的去找。两个核心开关不能关向导最后让你选默认模型和核心开关有两个建议一直保持开启持久记忆跨会话记住你的偏好越用越懂你技能生成任务经验自动沉淀为可复用技能这两个是 Hermes 区别于「一次性聊天工具」的根本关了等于把它降格成 ChatGPT。第 4 步不想跑向导直接改配置文件如果你觉得向导问得太细可以直接编辑~/.hermes/config.yamlmodel:provider:customdefault:sensenova-6.8-flash-litecustom_providers:-name:Token.sensenova.cnbase_url:https://token.sensenova.cn/v1api_key:你的keymodels:-sensenova-6.8-flash-lite-deepseek-v4-flash-glm-5.24 个新手最容易搞混的字段字段作用新手常犯错误provider告诉 Hermes 用哪个 provider填成了模型名base_urlAPI 地址漏掉/v1报 404api_key你的密钥格式不对报 401custom_providers自定义 provider 列表漏配自定义模型不可用完整的 config.yaml 有哪些字段、每个字段怎么配公众号「码锅炖AI」有详细注解版。第 5 步跑一次测试hermes-m你的模型名你好你叫什么名字能收到回复 配置通了。报错了对照这张表错误码原因解决404base_url 填错检查末尾有没有/v1401API key 不对重新复制429被限流换个模型或等一会Timeout网络问题国内换 DeepSeek / OpenRouter三个必踩的坑提前告诉你我装了三次才走通这三个坑大概率你也会遇到。坑 1Homebrew auto-update 卡死装的时候停在 5 分钟不动原因是brew install默认会先跑brew updatemacOS 上经常卡住。加环境变量跳过HOMEBREW_NO_AUTO_UPDATE1HOMEBREW_NO_ENV_HINTS1\curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash坑 2ffmpeg 下载卡住ARM 版 ffmpeg bottle 有 100MB网络慢时下载 6 分钟也没走完。先手动装好依赖HOMEBREW_NO_AUTO_UPDATE1brewinstallripgrep ffmpegffmpeg 不装也能跑 Hermes只是语音消息功能不可用。急着想装通的先跳过。坑 3Windows 上别用curl | bash网上搜到的curl | bash在 Windows 上必挂——原生没有 bash管道没有接收方。Windows 正确姿势PowerShelliex(irmhttps://hermes-agent.nousresearch.com/install.ps1)如果提示「禁止运行脚本」先放开执行策略Set-ExecutionPolicy-ScopeProcessBypass然后关掉重开 PowerShellPATH 才生效——这一步新手最容易漏。验收标准四条全满足 毕业✅hermes --version输出版本号✅ 配置向导走完无报错✅hermes doctor核心项全绿✅ 配了网关的话微信发一条消息Hermes 回你了装好第一天做三件事验收通过只是「能跑」下面三件事帮你建立真正的体感1. 测记忆告诉 Hermes「我喜欢简洁的中文回复」关掉重开再聊看它记不记得。2. 派个真活让它整理一个文件夹、总结一份 PDF、查一个资料。看它调工具、分步骤执行的全流程——这是它和普通聊天 AI 的本质区别。3. 看它长技能干完活去skills/目录看一眼有没有多出它自己总结的技能文件。「自我进化」不是宣传词是真的会发生。常见命令速查命令功能hermes开始聊天首次 进配置向导hermes --continue接着上次会话继续hermes chat -q 问题单次提问不进界面hermes setup重跑配置向导hermes model换模型 / 换 providerhermes tools开关工具集hermes gateway启动消息网关hermes doctor体检hermes update升级最新版hermes migrate从 OpenClaw 一键搬家作者简介码锅一个喜欢研究 AI 技术的程序员。CSDN 上写技术教程和概念科普分享深度实操和避坑指南。版权声明本文为作者原创本文为博主「Hermes Agent 实战系列」第 2 篇。转载需注明出处。系列导航[第 1 篇] 用 ChatGPT 两年了为什么我要自己装一个 AI Agent第 2 篇从零装 Hermes Agent5 步搞定附完整配置代码 ←你在这里[第 3 篇] Hermes 接入任意 API一文讲透 provider 配置待发布[第 4 篇] Hermes v0.20.5 正式版解析待发布