Hermes Agent从零到一的完整安装与使用教程

Hermes Agent从零到一的完整安装与使用教程Hermes Agent是由Nous Research开发的开源自主AI智能体框架主打“自我进化”——它能从任务中自动提炼技能、跨会话持久记忆并支持接入Telegram、Discord等平台实现越用越懂你。本教程将带你完成从环境准备到上手使用的全过程。文章目录Hermes Agent从零到一的完整安装与使用教程一、部署前准备1.1 系统要求1.2 硬件建议1.3 前置依赖二、安装方式详解方式一一键安装推荐方式二手动安装适合高级用户方式三容器化部署Docker三、初始配置3.1 选择大语言模型LLM3.2 配置内置工具3.3 配置消息网关可选3.4 单项配置管理四、快速上手4.1 启动对话4.2 常用命令速查4.3 实用示例五、常见问题排查Q1安装时提示“git: command not found”Q2WSL2中安装后无法启动Q3API调用失败或超时Q4内存不足导致进程被终止Q5如何完全卸载六、进阶资源一、部署前准备1.1 系统要求Hermes Agent支持以下操作系统且安装脚本会自动处理绝大部分依赖Linux主流发行版Ubuntu、Debian、CentOS等完全支持macOSIntel及Apple Silicon芯片完全支持Windows原生不支持需通过WSL2运行官方推荐方案Android支持Termux环境1.2 硬件建议部署方式最低配置推荐配置使用外部APIOpenRouter/OpenAI等1核1GB内存2核4GB内存本地运行模型16GB内存/显存32GB内存/显存提示多数用户选择接入外部大模型API成本更低且对硬件要求不高。1.3 前置依赖唯一需要手动安装的前置依赖是Git。其他所有依赖Python 3.11、Node.js v22、ripgrep、ffmpeg等都将由安装脚本自动处理。安装GitUbuntu/Debian示例sudoaptupdatesudoaptinstallgit-y二、安装方式详解Hermes Agent提供三种主流安装方式推荐新手使用一键安装高级用户可选手动安装或容器化部署。方式一一键安装推荐这是最快捷的安装方式只需一行命令curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash脚本会自动完成以下工作检测并安装缺失的依赖Python 3.11、Node.js v22、ripgrep、ffmpeg等克隆Hermes Agent代码仓库创建Python虚拟环境将hermes命令添加到系统PATH⚠️Windows用户特别注意请先在PowerShell管理员模式中运行wsl --install安装WSL2并重启电脑然后在Ubuntu终端中执行上述命令。安装完成后重新加载Shell并验证source~/.bashrc# 或 source ~/.zshrchermes--version# 应显示版本号如 v0.8.0方式二手动安装适合高级用户如需完全掌控安装过程可按以下步骤操作1. 克隆代码仓库务必包含子模块gitclone --recurse-submodules https://github.com/NousResearch/hermes-agent.gitcdhermes-agent如果已克隆但未拉取子模块执行gitsubmodule update--init--recursive2. 安装uv包管理器并创建虚拟环境# 安装uv如果尚未安装curl-LsSfhttps://astral.sh/uv/install.sh|sh# 创建Python 3.11虚拟环境uv会自动下载Python无需sudouv venv venv--python3.11sourcevenv/bin/activate# Linux/macOS# 或 .\venv\Scripts\activateWindows# 安装Hermes及其所有功能uv pipinstall-e.[all]提示虚拟环境路径已硬编码到入口脚本中因此日常使用时无需手动激活虚拟环境直接运行hermes命令即可。方式三容器化部署DockerHermes Agent提供官方Docker镜像适合生产环境部署# docker-compose.yml 示例version:3.8services:hermes:image:nousresearch/hermes-agent:latestcontainer_name:hermesrestart:unless-stoppedcommand:gateway runvolumes:-/your/data/path:/opt/data# 替换为实际数据存储路径启动容器后进入容器内运行配置向导dockercompose up-ddockercomposeexec-ithermes-agent /bin/bash hermes setup# 在容器内运行配置向导首次拉取镜像约需几分钟镜像约2.4GB压缩包含Playwright和Chromium浏览器自动化工具后续重启将快速启动。三、初始配置安装完成后运行以下命令启动交互式配置向导hermes setup向导会依次引导你完成以下配置3.1 选择大语言模型LLMHermes Agent支持超过200种模型主要通过以下方式接入OpenRouter聚合平台一键切换多种模型对国内用户友好OpenAI直接使用GPT系列模型Anthropic使用Claude系列模型Nous Portal官方推理门户支持400模型Ollama接入本地部署的开源模型自定义OpenAI兼容端点可接入国内模型服务如通义千问、Kimi、智谱GLM等按提示输入对应的API密钥即可。3.2 配置内置工具Hermes Agent内置超过40种工具包括文件系统操作读写、搜索Shell命令执行网络请求与网页抓取浏览器自动化Playwright定时任务调度代码执行与调试运行以下命令可随时管理工具hermes tools# 启用/禁用各类工具3.3 配置消息网关可选如需将Agent接入聊天平台运行hermes gateway setup支持接入的平台包括TelegramDiscordSlackSignal飞书、钉钉等通过社区适配3.4 单项配置管理你也可以单独修改某个配置项hermes model# 选择或切换模型hermes configsetkeyvalue# 修改单个配置值hermes config list# 查看当前全部配置所有配置存储在~/.hermes/目录下的.env和config.yaml文件中。四、快速上手4.1 启动对话配置完成后直接运行以下命令进入交互式命令行界面hermes现在你可以像与人聊天一样向Hermes Agent下达指令了。4.2 常用命令速查在对话中你可以使用以下内置命令命令功能/new开始新对话清空当前会话上下文/model provider:model切换模型如/model openrouter:google/gemini-2.5-pro/personality name切换角色预设如/personality code编程模式/help显示帮助信息与可用命令hermes doctor在终端中运行诊断环境与依赖状态hermes tools在终端中运行管理工具启用/禁用4.3 实用示例# 示例1让Agent分析项目代码并给出优化建议请分析当前目录下的Python代码找出潜在的性能问题并给出改进方案# 示例2定时任务使用自然语言hermes schedule每天早上8点汇总我的未读邮件并发送到Telegram# 示例3自动创建技能帮我写一个脚本每天自动备份指定文件夹到云存储并生成备份日志执行后Agent会自动将成功经验提炼为可复用的“技能”文件存储在~/.hermes/skills/目录中下次遇到类似任务可直接调用。五、常见问题排查Q1安装时提示“git: command not found”# Ubuntu/Debiansudoaptinstallgit-y# macOSxcode-select--install# CentOS/RHELsudoyuminstallgit-yQ2WSL2中安装后无法启动确保WSL2版本正确wsl --version应显示版本2。若为WSL1执行wsl --set-version发行版名2Q3API调用失败或超时检查API密钥是否有效且有余额若在国内网络环境建议使用国内模型服务端点或配置代理尝试运行hermes model重新配置模型Q4内存不足导致进程被终止浏览器自动化Playwright功能需要至少2GB可用内存。建议升级服务器配置至2核4GB以上或在hermes tools中禁用浏览器相关工具Q5如何完全卸载rm-rf~/.hermes# 删除所有配置、记忆和技能数据# 同时删除PATH中的hermes命令通常位于 ~/.local/bin/hermes六、进阶资源官方文档https://hermes-agent.nousresearch.com/docsGitHub仓库https://github.com/NousResearch/hermes-agent环境变量完整参考Environment Variables Reference消息网关配置指南Messaging Gateway GuideNix/NixOS专用配置Nix Setup GuideTermuxAndroid专用指南Termux Guide推荐阅读社区贡献的《Hermes橙皮书》系统地介绍了三层记忆系统、Skill自进化机制等高级特性适合深入学习。