Appearance
🤖 Hermes Agent 完整使用指南
基于 Nous Research 官方文档与 GitHub 仓库整理
📅 最后更新：2026 年
🔗 官方资源：GitHub | 文档 | Skills Hub
📌 什么是 Hermes Agent？
Hermes Agent 是由 Nous Research 打造的自主进化型 AI 智能体框架，核心特性：
| 特性 | 说明 |
|---|---|
| 🔁 自主学习闭环 | 自动创建技能 → 使用中自我改进 → 定期固化记忆 → 跨会话检索 |
| 🌐 随处运行 | $5 VPS / GPU 集群 / Serverless（Daytona/Modal）/ Docker / SSH / Termux |
| 💬 多平台接入 | CLI、Telegram、Discord、Slack、WhatsApp、微信（Claw）、Email 等 15+ 平台 |
| 🔧 47+ 内置工具 | 网页搜索、代码执行、文件操作、浏览器控制、MCP 集成、语音交互等 |
| 🧠 持久化记忆 | FTS5 全文检索 + LLM 摘要 + Honcho 用户建模，越用越懂你 |
| ⏰ 定时自动化 | 内置 cron 调度器，支持自然语言配置定时任务 |
| 🧩 开放技能生态 | 兼容 agentskills.io 标准，支持社区技能共享 |
🚀 快速安装
✅ 一键安装脚本（推荐）
bash
# Linux / macOS / WSL2 / Termux
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 启动！
hermes📦 其他安装方式
| 方式 | 适用场景 | 命令/说明 |
|---|---|---|
| uv 开发安装 | 贡献代码 / 自定义开发 | uv pip install -e ".[all,dev]" |
| Docker | 隔离环境 / 生产部署 | docker run -it nousresearch/hermes-agent |
| Nix/NixOS | 声明式配置用户 | 参考仓库 flake.nix |
| Termux (Android) | 手机端运行 | 安装脚本自动适配 .[termux] 依赖 |
⚠️ Windows 用户：原生不支持，请安装 WSL2 后运行上述命令。
⚙️ 首次配置指南
1️⃣ 运行设置向导（新手推荐）
bash
hermes setup向导将引导你：
- ✅ 选择 LLM 提供商（Nous Portal / OpenRouter / OpenAI / 自定义端点）
- ✅ 配置 API Key
- ✅ 启用所需工具（浏览器/代码执行/文件操作等）
- ✅ 设置消息网关（Telegram/Discord 等）
2️⃣ 手动配置关键项
bash
# 选择模型（支持热切换）
hermes model
# 示例：选择 Nous Hermes 3 通过 OpenRouter
# → 输入: openrouter:nousresearch/hermes-3-llama-3.1-8b
# 配置工具
hermes tools
# 启用/禁用特定工具，如 browser, execute_code, web_search
# 设置 API Key（推荐用 .env 文件）
echo "OPENROUTER_API_KEY=your_key_here" >> ~/.hermes/.env
# 启动消息网关（以 Telegram 为例）
hermes gateway setup telegram # 获取 Bot Token 后配置
hermes gateway start # 启动网关进程3️⃣ 配置文件结构
~/.hermes/
├── .env # API Keys & 环境变量
├── config.yaml # 主配置文件
├── profiles/ # 多用户配置
├── skills/ # 自定义技能 (.py)
├── memory/ # 持久化记忆数据库 (SQLite + FTS5)
└── logs/ # 运行日志💬 使用方式
🔹 终端界面（CLI）
bash
hermes # 启动交互式 TUI常用命令速查：
| 命令 | 功能 |
|---|---|
/new 或 /reset | 新建对话，清空上下文 |
/model [provider:model] | 切换底层 LLM |
/personality [name] | 加载预设人格（如 coder, researcher） |
/skills | 浏览/加载/管理技能库 |
/tools | 查看/启用/禁用可用工具 |
/cron | 管理定时自动化任务 |
/memory search [关键词] | 检索历史记忆 |
/stop 或 Ctrl+C | 中断当前任务执行 |
/usage | 查看 Token 消耗与成本统计 |
🔹 消息平台接入（以 Telegram 为例）
- 在 Telegram 搜索
@BotFather创建 Bot，获取 Token - 配置网关：bash
hermes gateway setup telegram # 粘贴 Bot Token，设置允许的用户/群组 hermes gateway start - 在 Telegram 中向你的 Bot 发送消息即可对话
✅ 支持平台：Discord、Slack、WhatsApp、Signal、微信（通过 HermesClaw）、钉钉、飞书、企业微信、Email、SMS 等 15+ 平台
🧰 核心功能详解
🔧 工具系统（47+ 内置工具）
yaml
# 分类示例
- 🌐 网络：web_search, browser, extract_content, image_gen, rss_monitor
- 💻 代码：execute_code, python_repl, git_ops, docker_ctl, ssh_exec
- 📁 文件：read_file, write_file, search_files, diff_patch, backup
- 🔍 记忆：memory_search, memory_summarize, user_profile_update
- 🤖 代理：spawn_subagent, delegate_task, parallel_execute, result_merge
- 🔌 扩展：mcp_connect, tool_registry, skill_import, webhook_trigger启用/禁用工具：
bash
# 交互式配置
hermes tools
# 或编辑配置文件 ~/.hermes/config.yaml
tools:
enabled:
- web_search
- execute_code
- browser
- memory_search
disabled:
- image_gen # 如需节省成本可禁用🧠 记忆与技能系统
- 🗃️ 记忆：
- 自动摘要对话 → FTS5 全文索引 → 支持
memory search [关键词]跨会话检索 - 记忆压缩：长会话自动摘要，节省 Token
- 自动摘要对话 → FTS5 全文索引 → 支持
- ⚡ 技能：
- 复杂任务完成后，Agent 可自动生成可复用技能（Python 脚本）
- 技能存于
~/.hermes/skills/，支持/skills load [name]调用 - 兼容 agentskills.io 标准，可导入社区技能
- 👤 用户建模：
- 通过 Honcho 模块持续学习你的偏好、工作流、沟通风格
- 支持
/profile export备份用户模型
⏰ 定时任务（Cron）
bash
# 创建每日晨间简报任务
hermes cron create \
--schedule "0 8 * * *" \
--command "web_search --query '今日科技新闻' | summarize --format markdown" \
--deliver telegram
# 查看所有任务
hermes cron list
# 暂停/启用任务
hermes cron toggle [task_id]🔌 MCP 集成（Model Context Protocol）
连接外部 MCP 服务器扩展能力：
bash
# 添加 MCP 服务器
hermes mcp add --name github \
--command "npx -y @modelcontextprotocol/server-github" \
--env "GITHUB_TOKEN=xxx"
# 在对话中使用 MCP 工具
/ask 帮我查看 nousresearch/hermes-agent 最近的 issue🛡️ 安全与最佳实践
| 场景 | 建议 |
|---|---|
| 🔐 API Key 管理 | 使用 ~/.hermes/.env 存储，设置文件权限 chmod 600 |
| 🧪 沙箱执行 | 代码执行默认在 Docker/Daytona 隔离环境，生产环境务必启用 --sandbox |
| 👥 多用户隔离 | 使用 --profile [name] 参数或 HERMES_HOME 环境变量隔离配置 |
| 🌍 网络访问 | 浏览器工具建议配置代理或白名单域名，避免滥用 |
| 🔄 自动更新 | 定期运行 hermes update 获取安全补丁与新功能 |
权限控制示例（config.yaml）：
yaml
security:
require_approval_for:
- execute_code
- write_file
- delete_file
- browser_navigate
allowed_users:
telegram: ["@your_username"]
discord: ["123456789012345678"]
rate_limit:
requests_per_minute: 30
tokens_per_hour: 50000🐛 常见问题排查
bash
# 诊断工具（首选）
hermes doctor
# 查看实时日志
tail -f ~/.hermes/logs/agent.log
# 重置配置（保留记忆）
hermes config reset --keep-memory
# 更新到最新版
hermes update
# 回退到指定版本
hermes update --version v0.8.5| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
启动报错 ModuleNotFoundError | 依赖未安装完整 | uv pip install -e ".[all]" |
| Telegram 无法收消息 | Bot Token 错误或未启用 Privacy Mode | 重新 gateway setup，检查 @BotFather 设置 |
| 工具调用失败 | 模型不支持 Function Calling | 切换至 Hermes 3/4 或启用 --force-tool-prompt |
| 内存占用高 | 长会话未压缩 | 使用 /compress 或配置 max_context_tokens: 8192 |
| 跨平台消息不同步 | 未启用统一会话存储 | 确保使用同一 HERMES_HOME 或 profile |
| 代码执行超时 | 沙箱资源限制 | 调整 sandbox.timeout_seconds 或升级容器配置 |
📚 学习资源
- 🌐 官方文档：hermes-agent.nousresearch.com/docs
- 💬 社区支持：Nous Research Discord
- 🧩 技能市场：Skills Hub
- 🐙 GitHub 仓库：NousResearch/hermes-agent
- 📖 迁移指南（OpenClaw 用户）：
hermes claw migrate --help - 🎥 视频教程：官方 YouTube 频道搜索 "Hermes Agent Tutorial"
💡 实用小技巧
bash
# 🎯 快速开始教程
/skills tutorial
# 📦 导出当前会话为报告
/export --format pdf --output ~/report.pdf
# 🔍 批量检索记忆并总结
/memory search "项目部署" | /summarize --key-points
# 🤖 创建子代理并行处理任务
/agent spawn --task "分析竞品" --parallel 3
# 🔄 热切换模型测试效果
/model openai:gpt-4o-mini
/model openrouter:nousresearch/hermes-3-llama-3.1-8b