Hermes‑Agent运行在命令行的开源 Agent支持工具调用、文件读写、shell 执行、网络搜索、子 Agent、Skill 沉淀Windows 原生不支持必须 WSL2macOS / Linux 原生支持。 配置文件目录~/.hermes/密钥存.env普通配置config.yaml。1 环境前置安装 GitWSL2 / Linuxsudo apt install gitmacOSxcode‑select --installWindows 用户开启 WSL2在 Ubuntu 子系统内部执行全部操作不要用 PowerShell 原生跑 。2 一键安装bashcurl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash安装脚本自动装好 uv、Python、Node.js、依赖包。刷新 shell 环境bash# bashsource ~/.bashrc# zshsource ~/.zshrc校验安装bashhermes --versionhermes doctorhermes 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/.env4 基础启动与对话bash# 普通CLI模式hermes# TUI现代化终端界面推荐hermes --tui进入交互界面直接输入指令即可例如plaintext帮我读取当前目录下readme.md并总结内容写一个C语言一阶滞后滤波代码搜索STM32 SPI常见坑会话内斜杠命令在 hermes 交互窗口内执行表格命令 作用/new 开启全新会话清空上下文/reset 重置当前会话/save name 保存会话快照/load name 加载历史会话/skills 查看已沉淀技能/exit 退出5 核心 CLI 总表终端 shell不是交互内部GitHubbashhermes # 启动对话CLIhermes --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/Discordhermes gateway start # 启动网关服务6 核心功能6.1 Skill自动沉淀技能Hermes 会把你反复做的任务自动保存为 Skill后续可以直接复用。交互内plaintext/skills # 列出全部skill/skill create xxx # 手动新建skill6.2 Profile 子 Agent多个人设可以创建多个独立 Agent各自拥有人设记忆、技能。bashhermes profile create dev‑agenthermes profile listhermes profile use dev‑agent每个 profile 会生成soul.md人设、性格、约束agents.md能力、工具权限配置6.3 Gateway 网关对接 IM 平台把 Agent 接到飞书、Telegram手机也可以发消息指挥 Agent 工作bashhermes gateway setuphermes gateway start7 国内用户最佳实践优先使用智谱 AI / KimiAPI不需要翻墙中文能力强模型选择上下文≥64K支持 Function‑call如果本地 Ollama使用 Hermes‑3 系列模型自定义 OpenAI 兼容端点填入hermes model8 高频踩坑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。