Hermes Agent 是 Nous Research 开源（MIT）的 AI 智能体，当前稳定版 v0.22.2，2026-10-15 发布。最短安装：Linux / macOS / WSL2 跑 curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash；Windows 原生在 PowerShell 跑 iex (irm https://hermes-agent.nousresearch.com/install.ps1)。它跟一般 Agent 的区别是自带学习闭环。
它到底是什么：一句话定位
Nous Research 做的开源 AI 智能体，MIT 协议，主语言 Python。写这篇时从 GitHub API 读到的数：254,872 星、55,429 fork，创建于 2025-07-22，最后 push 在 2026-10-18。它解决三个麻烦：换模型要动代码、会话一关就失忆、同样的活得从头教。
谁值得装？看的不是"有没有 AI 需求"，是试错代价。我们有个做实拍内容的客户，一条素材综合成本过万，让 Agent 先出草稿、人再改，省的是真钱；随手一搜就有答案的事，开常驻进程不划算。这条在 快手指数与抖音指数差异 里也提过。
功能清单：哪几条真能用上
- 学习闭环：复杂任务后自动创建 skill 并在使用中自我改进；会话走 FTS5 检索加摘要做跨会话回忆；用户建模接 Honcho，兼容 agentskills.io 标准。
- 多平台网关：Telegram、Discord、Slack、WhatsApp、Signal、邮件，一个进程全包。
- 40+ 工具、7 种终端后端：本地、Docker、SSH、Singularity、Modal、Daytona、Vercel Sandbox。
- 定时与并行：内置 cron，结果投递到任意平台；也能派生子智能体跑并行流。
下载与安装：官方入口、版本、系统要求
下载只认两处：官网 hermes-agent.nousresearch.com 与 GitHub Releases。
先说个坑：搜"Hermes Agent 安装教程"，前排好几个域名并非官方（hermes-ai.net、hermes-agents.net 之类），有写 Python 3.10+ 的，有写 pip install hermes-agent 的，还有给"国内镜像"域名的。官方安装页原文：当前第一方安装跑在 Python 3.14，pyproject.toml 里的 >=3.11,<3.15 只是让老环境先跑起更新器，不承诺 3.11–3.13 运行时支持。以官方为准。
版本 v0.22.2（2026-10-15）。官方 Release Notes 明说 v0.22.1 是从错误 commit 打出来的，Store 版会卡在 Connecting。10-08 到 10-15 连发五版。
授权 MIT，商用无限制。系统要求：macOS 安装包仅 Apple Silicon，Intel Mac 不支持；Windows 原生完全支持，不必走 WSL2。体积：源码仓约 1.29 GB（GitHub API size 字段），桌面包与镜像体积官方没标，以官方最新说明为准。依赖由内置 PM 给固定版 Python、Node.js、npm 等，默认还装 agent-browser，不想要加 --skip-browser。装在 ~/.hermes/，Windows 是 %LOCALAPPDATA%\hermes\。
上手：从装完到跑通第一个任务
source ~/.bashrc（zsh 换~/.zshrc），让hermes进 PATH。hermes setup走向导；想省事就hermes setup --portal，OAuth 登录 Nous Portal，一个订阅覆盖 300+ 模型与 Tool Gateway，不用自己攒 key。- 分开配也行：
hermes model选模型，hermes tools决定开哪些工具。 hermes进会话，/help看命令（/new、/model、/compress、/usage、/skills），hermes --continue恢复上次。
从 OpenClaw 迁过来用 hermes claw migrate。另外别指望它一口吞大文件：2GB 日志丢过去，往往不是慢，是压根跑不完——先按 大文件拆分 那套切成块再喂。
关键参数，以及怎么验证它真在干活
配置在 ~/.hermes/config.yaml，高频几项：
| 参数 | 作用 | 建议 |
|---|---|---|
terminal.backend | 命令在哪执行 | 隔离设 docker，远程设 ssh |
web.search_backend | 搜索后端 | 自托管可指向 SearXNG |
HERMES_HOME | 数据目录 | 多实例各给一个 |
怎么判断它真在干活？我们做内容监测用过一个笨办法，套这里也成立：纯自然状态跑 7 天，只盯两个能核实的数字，比如定时任务实际投递条数、某类任务的返工轮次。7 天后两个数都没动，问题多半不在模型，而在参数不够具体、或者它引用的数值没有出处。这个判据在 用 GEO 抢回流量 那篇写过。
更新与排错：hermes update 默认跟最新 tag，追 main 用 --set-channel main；hermes doctor 会直说缺什么。Windows 杀软把 bin\uv.exe 报成恶意软件属误报。
更新节奏、已知限制与合规提醒
节奏：10-08 到 10-15 连发五版，生产请 pin 到具体 tag，别用 latest。已知限制：v0.22.1 网关下建过的会话，升到 v0.22.2 后删不掉；官方没有 Helm chart；官方镜像用 s6-overlay 做 init，/init 必须先以 root 启动来 chown 数据卷再降到 hermes 用户（UID 10000 不是 1000），runAsNonRoot: true 会把它挡在门外；它是有状态单写者，多副本共享一份 HERMES_HOME 会打架。
合规。让它上网查东西、跑采集，就得遵守目标平台规则与法律法规。容器后端里它会跳过危险命令审批，理由是"容器本身是安全边界"，边界得自己画：默认拒绝出网、拦掉云元数据地址 169.254.169.254、别把静态云凭据明文塞进 Secret、审计 env_passthrough（列进去的变量会绕过凭据过滤）。
本篇不是官方文档的中文翻译，是按官方 README、安装文档与两篇近期实测文章加自己的安装记录整理的，版本号与系统要求请以官方页为准。下载入口：官方安装页、GitHub Releases；站内同类见 Anthropic 智能体技能仓库、微软开源 SkillOpt。
常见问题
装完提示 hermes: command not found？
先 source ~/.bashrc；还不行把 ~/.local/bin（Windows 是 %LOCALAPPDATA%\hermes\bin）加进 PATH，再跑 hermes doctor，它会报出安装来源与缺失项。
Windows 不装 WSL2 能用吗？
能。官方写明 Native Windows 完全支持，CLI、gateway、TUI、工具都原生可用，PowerShell 一行装完，落在 %LOCALAPPDATA%\hermes\。
能在 Kubernetes 上跑生产吗？
能，但有硬约束：镜像 tag 要 pin、单副本加 Recreate、fsGroup 设 10000、给足 startupProbe、默认拒绝出网。官方无 Helm chart，社区 chart 无背书。
