Loading... # Hermes Agent 完全入门指南：Nous Research 打造的自进化 AI 智能体 ## 前言 如果你关注 AI 编程助手领域，一定听说过 Claude Code、OpenAI Codex 等工具。但 **Hermes Agent** 与它们不同——它不是一个"绑定在 IDE 里的代码补全助手"，而是一个**真正的自主 AI 智能体**，拥有自我进化的能力，越用越聪明。 Hermes Agent 由 **Nous Research**（Hermes、Nomos、Psyche 等模型的创造者）开发，完全开源免费，支持 20+ 模型提供商，可在 20+ 通讯平台运行，并拥有独特的**技能系统**和**跨会话记忆**。 本教程将带你从零开始，全面了解 Hermes Agent 并快速上手。 --- ## 一、什么是 Hermes Agent？ Hermes Agent 是一个**开源的 AI 自主智能体框架**，能运行在终端、桌面应用、消息平台和 IDE 中。它属于与 Claude Code、Codex 同类的自主编码与任务执行智能体——通过工具调用来与系统交互。 **核心特点：** - **自我进化的学习闭环**：从经验中自动创建技能，在使用中自我改进，并在会话间保持记忆 - **不止于你的笔记本**：支持 6 种终端后端——本地、Docker、SSH、Daytona、Singularity、Modal，空闲时几乎零成本 - **无处不在**：终端、Telegram、Discord、Slack、WhatsApp、Signal、微信、QQ、钉钉、飞书等 20+ 平台 - **模型无锁定**：支持 OpenRouter、Anthropic、OpenAI、Google、DeepSeek、xAI、本地模型等 20+ 提供商，随时切换 - **定时自动化**：内置 Cron 调度器，支持向任意平台投递结果 - **子智能体并行**：可派生子智能体并行处理多个任务 - **MCP 集成**：连接任意 MCP 服务器扩展能力 - **技能系统**：越用越聪明，自动积累可复用的程序化知识 --- ## 二、安装 ### 最快方式 **Linux / macOS / WSL2：** ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` **Windows（PowerShell）：** ```powershell iex (irm https://hermes-agent.nousresearch.com/install.ps1) ``` 安装完成后，重新加载 shell： ```bash source ~/.bashrc ``` ### 桌面版 除了命令行，Hermes 还提供原生桌面应用（Electron），支持 macOS/Linux/Windows，包含流式聊天、会话管理、拖拽文件、Cmd+K 快捷面板、模型切换等功能。从官网下载：https://hermes-agent.nousresearch.com --- ## 三、选择模型提供商 安装完成后，运行以下命令以交互方式选择模型提供商： ```bash hermes model ``` **最省心的方式：Nous Portal** ```bash hermes setup --portal ``` 一次 OAuth 登录即可获得 300+ 模型（包括 Claude、GPT-5、Gemini 等）以及工具网关（网页搜索、图片生成、TTS、云浏览器）。 **其他主流提供商：** | 提供商 | 说明 | 配置方式 | |--------|------|----------| | OpenAI Codex | ChatGPT OAuth | `hermes model` → OpenAI Codex | | Anthropic | Claude 模型 | `hermes model` → OAuth 或 API Key | | OpenRouter | 多模型路由 | 设置 `OPENROUTER_API_KEY` | | DeepSeek | 直接 API | 设置 `DEEPSEEK_API_KEY` | | xAI Grok | Grok 模型 | 设置 `XAI_API_KEY` 或 OAuth | | Google Gemini | Gemini API | 设置 `GOOGLE_API_KEY` | | 阿里云 Qwen | DashScope | 设置 `DASHSCOPE_API_KEY` | | 自定义端点 | 任意 OpenAI 兼容 API | 配置 base URL + API key | > 要求：模型需要至少 **64K token 上下文**，大多数主流模型均满足。 --- ## 四、第一次对话 ```bash hermes # 经典 CLI 模式 hermes --tui # 现代 TUI（推荐） ``` 你会看到欢迎横幅，显示选择的模型、可用工具和技能。试试这些提示： - "用 5 个要点总结这个仓库，并告诉我主要入口点在哪里" - "检查我的当前目录，找出看起来像主项目文件的那些" - "帮我设置一个干净的 GitHub PR 工作流" **验证会话恢复：** ```bash hermes --continue # 恢复最近会话 hermes -c # 简写 ``` --- ## 五、核心功能详解 ### 1. 技能系统（Skills） 这是 Hermes 最独特的功能。技能是可复用的程序化知识，告诉 Hermes 如何完成特定任务——部署 Kubernetes、开 GitHub PR、微调模型等。 每个技能是一个 `SKILL.md` 文件，包含名称、描述和步骤。Hermes 在需要时才会加载完整内容，不会浪费 token。 **浏览和安装技能：** ```bash hermes skills browse # 浏览所有可用技能 hermes skills search kubernetes # 搜索关键词 hermes skills install openai/skills/k8s # 安装技能 ``` **使用技能：** 安装后，每个技能自动成为斜杠命令： ``` /k8s deploy the staging manifest ``` ### 2. 记忆系统（Memory） Hermes 有两类记忆：**MEMORY**（环境信息、偏好、项目位置、工具使用技巧）和 **USER**（你是谁、你的角色、偏好风格）。记忆在会话间持久化，每次启动时自动加载。当记忆满时，Hermes 会自动合并和精简条目。 ### 3. 消息网关（Gateway） Hermes 支持 20+ 消息平台，配置方式： ```bash hermes gateway setup ``` 支持的平台包括：Telegram、Discord、Slack、WhatsApp、Signal、Matrix、邮件、短信、钉钉、飞书、企业微信、微信、QQ、Teams、Home Assistant 等。 在 Telegram 或 Discord 中使用 `/sethome` 命令设置家庭频道，定时任务结果会自动投递到这里。 ### 4. 定时任务（Cron） 内置调度器，支持多种计划格式： ```bash hermes cron create "30m" # 每30分钟 hermes cron create "every 2h" # 每2小时 hermes cron create "0 9 * * *" # 每天9点 ``` 结果可投递到任何消息平台。 ### 5. 子智能体（Delegation） 需要同时处理多个任务时，可以派生子智能体并行工作。每个子智能体独立运行，只有最终摘要返回，大幅节省主会话 token。 --- ## 六、实用技巧 ### 获得最佳结果 - **具体明确**：与其说"修复代码"，不如说"修复 api/handlers.py 第 47 行的 TypeError，process_request() 从 parse_body() 收到了 None" - **提供上下文**：在请求中前置相关细节：文件路径、错误信息、预期行为 - **使用 AGENTS.md**：在项目根目录创建 AGENTS.md，自动注入每个会话，无需重复说明 ### 常用斜杠命令 | 命令 | 功能 | |------|------| | `/help` | 显示所有命令 | | `/model` | 切换模型 | | `/compress` | 压缩上下文，节省 token | | `/usage` | 查看 token 消耗 | | `/verbose` | 切换工具输出显示模式 | | `/save` | 保存会话到文件 | | `/title` | 命名当前会话 | | `/retry` | 重试上次消息 | ### 快捷键 | 快捷键 | 功能 | |--------|------| | `Alt+Enter` / `Ctrl+J` | 换行（不发送） | | `Ctrl+C` | 中断智能体响应 | | `Ctrl+V` | 粘贴剪贴板图片（视觉分析） | | `/` + Tab | 斜杠命令自动补全 | ### 性能与成本优化 - **不要频繁切换模型**：每次切换会重置提示缓存，导致昂贵的重新计算 - **使用 `/compress`**：长会话中定期压缩，保持响应速度 - **选择合适的模型**：复杂推理用 Claude/GPT，简单任务用快速模型 --- ## 七、安全最佳实践 - **Docker 隔离**：处理不信任的代码时，使用 Docker 作为终端后端：`hermes config set terminal.backend docker` - **命令审批**：默认启用危险命令审批，不要在生产环境关闭 - **消息平台权限**：永远不要设置 `GATEWAY_ALLOW_ALL_USERS=true`，使用平台特定的允许列表 - **凭据分离**：密钥存在 `.env`，配置存在 `config.yaml`，互不混淆 --- ## 八、故障排查 | 症状 | 原因 | 解决方法 | |------|------|----------| | 打开后回复为空或错误 | 提供商认证或模型选择错误 | 重新运行 `hermes model` | | 网关启动但无人能发消息 | 机器人 Token 或允许列表问题 | 重新运行 `hermes gateway setup` | | 会话无法恢复 | 切换了配置文件或未保存 | 检查 `hermes sessions list` | | 模型不可用或回退异常 | 路由/回退设置过于激进 | 先保持基础提供商稳定 | **恢复工具包：** ```bash hermes doctor hermes model hermes setup hermes sessions list hermes gateway status ``` --- ## 九、总结与下一步 Hermes Agent 最强大的地方在于它**越用越聪明**——每次使用都在积累技能和记忆，逐渐成为真正了解你和你工作的专属智能体。 **相关资源：** - **官方文档**：https://hermes-agent.nousresearch.com/docs - **GitHub 仓库**：https://github.com/NousResearch/hermes-agent - **技能中心**：https://agentskills.io - **社区**：Discord（https://discord.gg/NousResearch） 开始使用它，让效率从今天开始提升！ Last modification：August 9, 2026 © Allow specification reprint Like 如果觉得我的文章对你有用，请随意赞赏