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。