Hermes Agent 部署及使用完整教程

作者技术博客标签AI Agent、Hermes、Nous Research、大模型、自动化难度⭐⭐☆☆☆新手友好一、前言最近 AI Agent 圈子里最火的项目非Hermes Agent莫属GitHub 上短短两个月就突破 59K Stars迭代速度极快。它到底是什么简单说Hermes Agent 是由 Nous Research 开源的自主学习 AI 智能体。和那些套壳聊天机器人不一样它最大的特点是持久记忆跨会话记住上下文不会每次都失忆自动学习完成任务后自动沉淀技能用得越久越聪明模型自由支持 OpenRouter、OpenAI、GLM、Kimi、MiniMax、Claude 等 200 模型一行命令切换多平台微信、钉钉、飞书、Telegram、Discord、Slack 全支持数据私有所有数据本地存储MIT 开源协议二、环境要求项目要求操作系统Linux / macOS / WSL2Python自动安装 3.11无需手动权限普通用户即可无需 sudo网络需要访问 GitHub国内见下方加速方案⚠️Windows 用户注意不支持原生 Windows请先安装 WSL2再在 WSL2 终端中操作。三、一键安装3.1 国际网络推荐curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash3.2 国内加速访问 GitHub 慢用这个curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装过程全自动大约60 秒完成包括自动安装 uv 包管理器自动安装 Python 3.11安装所有依赖写入环境变量3.3 安装完成后重载环境变量source ~/.bashrc # 如果用 zsh执行 source ~/.zshrc四、首次配置安装完成后执行hermes启动按提示进行初始化配置。4.1 选择模型提供商启动后会进入交互式设置常见选项提供商特点推荐人群OpenRouter支持 200 模型一个 Key 全搞定首选推荐OpenAIGPT-4o 系列有 OpenAI Key智谱 GLM国内直连性价比高国内用户Kimi长文本处理强国内用户MiniMax国内直连国内用户4.2 配置 API Key# 方式一命令行直接设置 hermes config set OPENROUTER_API_KEY sk-or-v1-你的key # 方式二编辑配置文件 vim ~/.hermes/.env.env文件格式示例# 选择你有的其中一个填入即可 OPENROUTER_API_KEYsk-or-v1-your-key-here OPENAI_API_KEYsk-your-openai-key ZHIPUAI_API_KEYyour-zhipuai-key4.3 切换模型hermes model交互式选择模型无需改代码随时切换。五、基础使用5.1 启动对话hermes进入对话界面后直接用自然语言下指令即可hermes ❯ 帮我整理一下桌面上的文件按类型分类到对应文件夹 hermes ❯ 每天早上9点检查 Hacker News 上的 AI 新闻发到 Telegram hermes ❯ 帮我写一个爬取京东商品价格的 Python 脚本并运行5.2 常用命令速查hermes # 启动对话 hermes model # 切换模型 hermes config # 查看/修改配置 hermes doctor # 诊断配置问题 hermes start # 后台运行用于 IM 网关模式5.3 对话内斜杠命令在对话中输入以下命令/skills # 查看 Agent 积累的所有技能 /insights --days 7 # 查看最近7天的学习周报 /memory # 查看持久记忆内容六、进阶配置6.1 接入 Telegram最常用hermes gateway setup # 选择 Telegram # 输入通过 BotFather 创建的 Bot Token hermes start # 后台启动之后直接在 Telegram 里和你的 Agent 对话支持跨平台上下文连续。6.2 设置定时任务# 用自然语言设置无需 Cron 表达式 hermes schedule 每天早上 8 点汇总昨日邮件并发到 Telegram # 查看任务列表 hermes schedule list # 删除任务 hermes schedule remove task-id6.3 配置工具集# 启用指定工具集 hermes chat --toolsets web,terminal,file # 交互式配置工具 hermes tools常用工具集工具集功能web网页搜索与抓取terminal执行 Shell 命令file文件读写操作browser浏览器自动化memory持久记忆管理cronjob定时任务code_execution代码执行6.4 配置文件详解配置文件路径~/.hermes/config.yaml# 终端执行后端配置 terminal: backend: local # 可选: docker, ssh, singularity, modal cwd: . timeout: 180 # 上下文压缩长对话必备 compression: enabled: true threshold: 0.50 # 达到上下文限制 50% 时自动压缩 # 显示配置 display: busy_input_mode: interrupt # 或 queue tool_preview_length: 0 # 0 不限制 # 自定义快捷命令 quick_commands: status: type: exec command: systemctl status hermes-agent gpu: type: exec command: nvidia-smi --query-gpuutilization.gpu,memory.used --formatcsv,noheader七、常见问题Q安装后找不到hermes命令source ~/.bashrc # 重载环境变量 # 检查路径是否在 PATH 中 echo $PATH | grep localQ国内访问 GitHub 太慢用国内加速地址安装详见第三节 3.2。Q必须用 Hermes 自家的模型吗不必须。通过 OpenRouter 可以接入 Claude、GPT-4o、Gemini 等任意模型完全无锁定。Q数据存在哪里安全吗所有对话记录、记忆和技能文件均存储在本地~/.hermes/目录下不会上传到任何服务器。Q配置有问题怎么排查hermes doctor # 自动诊断并给出修复建议八、总结维度评价安装难度⭐☆☆☆☆ 极简一行命令功能丰富度⭐⭐⭐⭐⭐模型自由度⭐⭐⭐⭐⭐ 200 模型随意切国内适配⭐⭐⭐⭐☆ 支持国产模型和平台数据安全⭐⭐⭐⭐⭐ 完全本地化适合人群想要一个越用越聪明的个人 AI 助手需要多平台统一接入微信、飞书、Telegram 等对数据隐私有要求不想数据上云想要不绑定单一模型厂商的开源方案GitHub 地址https://github.com/NousResearch/hermes-agent中文社区https://hermes-agent.org.cn中文文档菜鸟教程https://www.runoob.com/ai-agent/hermes-agent.html如果本文对你有帮助欢迎点赞收藏有问题在评论区留言。