Hermes Agent 入门指南

发布于 2026-05-04 19:26

Hermes Agent 入门指南

什么是 Hermes Agent

Hermes Agent 是由 Nous Research 构建的自改进 AI 代理。它是唯一内置学习循环的代理——能够从经验中创建技能、在使用过程中改进技能、自动持久化知识、搜索过去的对话，并在会话间建立对你的深入了解。

主要特点：

  • 可在 $5 VPS、GPU 集群或几乎无空闲成本的无服务器基础设施上运行
  • 不依赖你的笔记本电脑——可以通过 Telegram 与它对话，而它在云 VM 上工作
  • 支持任何模型：Nous Portal、OpenRouter（200+ 模型）、NVIDIA NIM、Xiaomi MiMo、z.ai/GLM、Kimi/Moonshot、MiniMax、Hugging Face、OpenAI 或自定义端点
  • 使用 hermes model 切换模型——无需更改代码，无锁定

核心特性

真实的终端界面

完整的 TUI，支持多行编辑、斜杠命令自动补全、对话历史、中断重定向和流式工具输出。

多平台支持

通过单个网关进程支持 Telegram、Discord、Slack、WhatsApp、Signal 和 CLI。支持语音备忘录转录、跨平台对话连续性。

闭环学习系统

  • 代理策划的记忆与定期提示
  • 复杂任务后的自主技能创建
  • 技能在使用过程中的自我改进
  • FTS5 会话搜索与 LLM 摘要，实现跨会话回忆
  • 兼容 agentskills.io 开放标准

定时自动化

内置 cron 调度器，可交付到任何平台。每日报告、夜间备份、每周审计——全部用自然语言配置，无人值守运行。

委托与并行化

为并行工作流生成隔离的子代理。编写通过 RPC 调用工具的 Python 脚本，将多步骤管道压缩为零上下文成本的回合。

随处运行

六种终端后端——本地、Docker、SSH、Daytona、Singularity 和 Modal。Daytona 和 Modal 提供无服务器持久化——代理环境在空闲时休眠，按需唤醒，会话间成本几乎为零。

快速安装

在 Linux、macOS、WSL2 或 Android（通过 Termux）上运行：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装后：

source ~/.bashrc    # 重新加载 shell（或：source ~/.zshrc）
hermes              # 开始对话！

注意：

  • Windows 原生系统不支持，请安装 WSL2 后运行上述命令
  • Android/Termux 有专门的安装指南

入门命令

hermes              # 交互式 CLI — 开始对话
hermes model        # 选择 LLM 提供商和模型
hermes tools        # 配置启用的工具
hermes config set   # 设置单个配置值
hermes gateway      # 启动消息网关（Telegram、Discord 等）
hermes setup        # 运行完整设置向导（一次性配置所有内容）
hermes update       # 更新到最新版本
hermes doctor       # 诊断任何问题

CLI 与消息平台快速参考

Hermes 有两个入口点：通过 hermes 启动终端 UI，或运行网关并从 Telegram、Discord、Slack、WhatsApp、Signal 或电子邮件与之对话。

操作 CLI 消息平台
开始对话 hermes 运行 hermes gateway setup + hermes gateway start，然后向机器人发送消息
开始新对话 /new 或 /reset /new 或 /reset
更改模型 /model [provider:model] /model [provider:model]
设置个性 /personality [name] /personality [name]
重试或撤销上一轮 /retry, /undo /retry, /undo
压缩上下文 / 检查使用情况 /compress, /usage, /insights [--days N] /compress, /usage, /insights [days]
浏览技能 /skills 或 /<skill-name> /<skill-name>
中断当前工作 Ctrl+C 或发送新消息 /stop 或发送新消息
平台特定状态 /platforms /status, /sethome

开发者快速开始

克隆并运行 setup-hermes.sh：

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
./setup-hermes.sh     # 安装 uv，创建 venv，安装 .[all]，符号链接 ~/.local/bin/hermes
./hermes              # 自动检测 venv，无需先 `source`

手动安装（等效于上述）：

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11
source venv/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

从 OpenClaw 迁移

如果你来自 OpenClaw，Hermes 可以自动导入你的设置、记忆、技能和 API 密钥。

首次设置期间：设置向导（hermes setup）自动检测 ~/.openclaw 并在配置开始前提供迁移选项。

安装后随时迁移：

hermes claw migrate              # 交互式迁移（完整预设）
hermes claw migrate --dry-run    # 预览将迁移的内容
hermes claw migrate --preset user-data   # 迁移不包含机密信息
hermes claw migrate --overwrite  # 覆盖现有冲突

可导入内容：

  • SOUL.md — 个性文件
  • 记忆 — MEMORY.md 和 USER.md 条目
  • 技能 — 用户创建的技能 → ~/.hermes/skills/openclaw-imports/
  • 命令允许列表 — 审批模式
  • 消息设置 — 平台配置、允许的用户、工作目录
  • API 密钥 — 允许的机密（Telegram、OpenRouter、OpenAI、Anthropic、ElevenLabs）
  • TTS 资源 — 工作区音频文件
  • 工作区指令 — AGENTS.md

文档资源

完整文档位于 hermes-agent.nousresearch.com/docs：

  • 快速开始 — 2 分钟内安装 → 设置 → 首次对话
  • CLI 使用 — 命令、键绑定、个性、会话
  • 配置 — 配置文件、提供商、模型、所有选项
  • 消息网关 — Telegram、Discord、Slack、WhatsApp、Signal、Home Assistant
  • 安全 — 命令审批、DM 配对、容器隔离
  • 工具与工具集 — 40+ 工具、工具集系统、终端后端
  • 技能系统 — 程序性记忆、技能中心、创建技能
  • 记忆 — 持久记忆、用户配置文件、最佳实践
  • MCP 集成 — 连接任何 MCP 服务器以扩展功能
  • Cron 调度 — 带平台交付的计划任务
  • 架构 — 项目结构、代理循环、关键类
  • 贡献 — 开发设置、PR 流程、代码风格

社区

  • Discord：https://discord.gg/NousResearch
  • 技能中心：https://agentskills.io
  • 问题反馈：https://github.com/NousResearch/hermes-agent/issues
  • HermesClaw：https://github.com/AaronWong1999/hermesclaw — 社区微信桥接

许可证

MIT — 详见 LICENSE 文件。

由 Nous Research 构建。

← 返回博客列表
文章信息

标题: Hermes Agent 入门指南

发布时间: 2026-05-04 19:26