Hermes‑Agent 使用教程

Hermes‑Agent:运行在命令行的开源 Agent,支持工具调用、文件读写、shell 执行、网络搜索、子 Agent、Skill 沉淀;Windows 原生不支持,必须 WSL2 ,macOS / Linux 原生支持。 配置文件目录:~/.hermes/;密钥存 .env,普通配置 config.yaml。

1 环境前置
安装 Git
WSL2 / Linux:sudo apt install git
macOS:xcode‑select --install
Windows 用户:开启 WSL2,在 Ubuntu 子系统内部执行全部操作,不要用 PowerShell 原生跑 。
2 一键安装
bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
安装脚本自动装好 uv、Python、Node.js、依赖包。
刷新 shell 环境
bash
# bash
source ~/.bashrc
# zsh
source ~/.zshrc
校验安装
bash
hermes --version
hermes doctor
hermes doctor 做全套健康检测,有问题直接输出提示,排障优先用这个命令。
3 初始化配置
bash
# 完整向导,一次性配置模型、工具
hermes setup
或者分步配置:
bash
# 选择模型服务商(OpenRouter / 智谱 / Kimi / OpenAI / Ollama本地)
hermes model

# 开启/关闭内置工具:搜索、文件读写、shell命令等
hermes tools
⚠重要:Agent 模型上下文窗口至少 64k tokens,否则多步工具调用会失败。
设置 API Key 两种方式
bash
# 方式1 命令行设置(推荐)
hermes config set ZHIPUAI_API_KEY sk‑xxx

# 方式2 手动编辑配置文件
nano ~/.hermes/.env
4 基础启动与对话
bash
# 普通CLI模式
hermes

# TUI现代化终端界面(推荐)
hermes --tui
进入交互界面,直接输入指令即可,例如:
plaintext
帮我读取当前目录下readme.md并总结内容
写一个C语言一阶滞后滤波代码
搜索STM32 SPI常见坑
会话内斜杠命令(在 hermes 交互窗口内执行)
表格
命令 作用
/new 开启全新会话,清空上下文
/reset 重置当前会话
/save name 保存会话快照
/load name 加载历史会话
/skills 查看已沉淀技能
/exit 退出
5 核心 CLI 总表(终端 shell,不是交互内部)GitHub
bash
hermes # 启动对话CLI
hermes --tui # TUI界面
hermes setup # 全套初始化向导
hermes model # 切换/配置大模型
hermes tools # 工具开关配置
hermes tools list # 查看可用工具列表
hermes config set KEY 值 # 设置配置项
hermes doctor # 诊断故障
hermes update # 更新hermes‑agent到最新版
hermes gateway setup # 接入消息平台(飞书/Telegram/Discord)
hermes gateway start # 启动网关服务
6 核心功能
6.1 Skill(自动沉淀技能)
Hermes 会把你反复做的任务自动保存为 Skill,后续可以直接复用。
交互内:
plaintext
/skills # 列出全部skill
/skill create xxx # 手动新建skill
6.2 Profile 子 Agent(多个人设)
可以创建多个独立 Agent,各自拥有人设记忆、技能。
bash
hermes profile create dev‑agent
hermes profile list
hermes profile use dev‑agent
每个 profile 会生成:
soul.md:人设、性格、约束
agents.md:能力、工具权限配置
6.3 Gateway 网关:对接 IM 平台
把 Agent 接到飞书、Telegram,手机也可以发消息指挥 Agent 工作:
bash
hermes gateway setup
hermes gateway start
7 国内用户最佳实践
优先使用智谱 AI / KimiAPI,不需要翻墙,中文能力强
模型选择:上下文≥64K,支持 Function‑call
如果本地 Ollama:使用 Hermes‑3 系列模型,自定义 OpenAI 兼容端点填入hermes model
8 高频踩坑
Windows 直接 PowerShell 运行报错:必须 WSL2 Ubuntu 内运行,原生 Windows 不支持。
工具调用异常:运行hermes doctor检查 API 密钥、模型上下文窗口。
网络超时:切换国内大模型 API,不要硬用 OpenRouter。
更新之后配置丢失:配置都在~/.hermes目录,重装不会删除。
模型不执行工具:确认模型支持 function‑call,上下文窗口≥64k。
9 区分两个 Hermes(别搞混)
Hermes‑Agent:本教程,终端 Agent 框架,CLI 工具,可调用各种大模型 API。
Hermes‑Function‑Calling:纯模型函数调用示例库,用于本地 Hermes 系列模型做工具调用,不是 CLI 程序GitHub。

相关推荐
TomEval12 小时前
【测AI】第26篇:线上模型监控与告警体系 — 测试不是终点
人工智能·python·功能测试·ai
prince_zxill13 小时前
PEP 751 pylock.toml 实测:pip 26.3 装 6 个包版本全钉死,但 [web] 选不中任何东西
python·pip·依赖管理·pep 751
Thanks_ks15 小时前
Python 的垃圾回收——引用计数撑起日常,分代回收收拾残局
python·内存管理·垃圾回收·循环引用·引用计数·gc 模块·weakref
CyrusYiVPP15 小时前
实测 uv 0.13.7:同一套包,pip 装 94 秒,它只用 19 秒
人工智能·python
yiangL_15 小时前
Python 学习笔记:递归、turtle绘图、字符串与函数
笔记·python·学习
cpolar技术支持16 小时前
把 agent-autoloop 装在 Mac 上:用本机 Node 实跑一次「接活—提问—拍板—接着干」,再用 cpolar 把它的状态页开给不在工位的自己
node.js·内网穿透·cpolar·ai agent·agent-autoloop
lula88816 小时前
PVC-U、PVC-C、PVC-O 差一个字母,差的是三种增强路线
python
数字工作台18 小时前
给 LangGraph 加一道可审计记忆:替换默认 Checkpointer,实现防篡改 + 崩溃不丢数据
python·agent
DKPT18 小时前
Python 的 Web 框架:选型选错的人,都踩了同一个坑
python
2401_8685347819 小时前
逻辑网络设计
网络·python