文档核验 2026-08-11 · 待自动实测

Hermes Agent

一句话定位：Nous Research 开源的"会自我进化"的本地 AI Agent 框架——内置 Memory / Skill / Nudge 三件套自我进化循环，能在你本机写代码、抓网页、跑任务，并接入 Telegram / 飞书 / 微信 / Slack 等 15+ 消息平台 7×24 待命。 适用场景：想要一个长期陪跑、越用越懂你的本地全能助手；需要远程通过消息平台下指令；希望数据不出本机。

一、前置依赖

Python 3.11+：安装脚本会用 uv 自动装，不用手动装
Git：macOS / Linux 需预装；Windows 安装器会自带便携 Git
一个大模型 API Key：Nous Portal / OpenRouter / OpenAI / Anthropic / DeepSeek / 智谱 GLM 等任选；或用 hermes setup --portal 一站式开通（一个订阅覆盖 300+ 模型 + Tool Gateway）

安装器会自动处理 Node.js 22、ripgrep、ffmpeg 等其余依赖。用普通用户权限运行即可，不要加 sudo（加了反而出权限问题）。

二、安装步骤

macOS（原生）

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

装完重载 shell 让 hermes 命令生效：

source ~/.zshrc   # macOS 默认 zsh；若用 bash 则 source ~/.bashrc

Windows（原生 PowerShell，无需 WSL）

普通权限打开 PowerShell 运行（管理员不是必须）：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

安装器会装好 uv / Python 3.11 / Node.js 22 / ripgrep / ffmpeg 及便携 Git，并把 hermes 加入用户 PATH。装完请重启终端（或开新 PowerShell 窗口）让 PATH 生效。

⚠️ 平台对等性（来自官方文档）：原生 Windows 现已支持 CLI / gateway / TUI / 工具 / MCP / 浏览器原生运行；仅 Dashboard 的嵌入式终端标签页仅限 WSL2（依赖 POSIX PTY）。原生安装与 WSL2 安装可干净共存（原生数据在 %LOCALAPPDATA%\hermes，WSL 数据在 ~/.hermes）。如果你更习惯 WSL2，可在 WSL2 内用上面 macOS 的同一条 curl ... | bash 命令安装。

三、最小可用配置

安装后启动配置向导：

hermes setup          # 完整向导：选模型、配工具、接消息平台
# 或分项配置：
hermes model          # 选 LLM 提供商和模型
hermes gateway setup  # 配置 Telegram / 飞书 / Slack 等

最快路径（一个订阅覆盖 300+ 模型 + Tool Gateway，无需逐个管 Key）：

hermes setup --portal

开始聊天：

hermes

四、国内环境坑

网络：安装脚本要从 GitHub 拉仓库和依赖，国内网络可能慢 / 超时。可给终端配代理，或先 git clone 再走开发者安装（手动安装路径）。
模型 Key：Nous Portal / OpenRouter 等国外服务在国内访问不一定稳定；国产模型（DeepSeek / 智谱 GLM / 混元 / MiniMax）接入更稳，且官方均支持，优先选这些。
不要 sudo：用 sudo 跑安装脚本反而会出权限问题，普通用户即可。
Windows 32 位：安装器会回退到 MinGit（缺 bash），终端工具与 agent 浏览器功能将被禁用——建议用 64 位系统。

五、常见报错 → 解决

现象	解决
`hermes: command not found`	重载 shell（`source ~/.zshrc` / `~/.bashrc`）或开新终端；检查 PATH
`API key not set`	运行 `hermes model` 配置提供商，或 `hermes config set OPENROUTER_API_KEY <key>`
更新后配置丢失	`hermes config check` → `hermes config migrate`
想看缺什么依赖	`hermes doctor` —— 跑完全绿即环境 OK

六、实测状态

🟡 文档核验（2026-08-11）：安装命令与步骤取自官方安装文档，尚未在本机沙箱实跑验证。后续由站点 CI 定时实跑并更新徽章（见规划文档 §7 实测校验设计）。

七、官方链接

GitHub：https://github.com/NousResearch/hermes-agent
官方文档（安装）：https://hermes-agent.nousresearch.com/docs/zh-Hans/getting-started/installation
官网：https://hermes-agent.nousresearch.com/

踩坑交流 / 1v1 配置，加微信 hhummingg