MIT License

Hermes Agent 中文文档

自我进化的 AI Agent,由 Nous Research 构建。唯一内置学习循环的 Agent——从经验中创造技能、使用中不断改进、自动沉淀知识。

Python MIT License 87K+ Stars 11K+ Forks
87K+
GitHub Stars
11K+
Forks
MIT
开源协议

核心特性

一个真正理解你、在使用中不断成长的 AI Agent

自我进化学习循环

从经验中创造技能,使用中持续改进,自动沉淀知识,搜索历史对话,构建深度的用户认知模型。

实时终端界面

完整 TUI 界面,多行编辑,斜杠命令自动补全,对话历史中断和重定向,以及流式工具输出。

多平台消息网关

Telegram、Discord、Slack、WhatsApp、Signal、Email——全部从一个网关进程处理。语音备忘录转录,跨平台会话连续性。

定时自动化

内置 cron 调度器,支持任意平台交付。每日报告、深夜备份、每周审计——全部用自然语言运行,无需值守。

并行委托执行

派发隔离的子 Agent 进行并行工作流。编写调用工具的 Python 脚本,通过 RPC 将多步管道压缩成零上下文成本的调用。

任意环境运行

六大终端后端——本地、Docker、SSH、Daytona、Singularity、Modal。Daytona 和 Modal 提供无服务器持久化,让 Agent 环境在空闲时休眠,几乎零成本。

持久化记忆系统

Agent 主导的周期记忆更新。自动创建用户画像和最佳实践。FTS5 会话搜索配合 LLM 摘要实现跨会话recall。

40+ 工具生态

丰富的工具集和工具系统,支持终端后端扩展。内置网页搜索、文件操作、代码执行等核心工具。

安全隔离

命令审批、DMA 保护、容器隔离。细粒度的权限控制确保 Agent 操作的安全性。

MCP 集成

连接任意 MCP 服务器,扩展 Agent 能力。支持自定义工具和服务端点。

研究就绪

批量 trajpeter 生成、Athropic RL 环境、trajpeter 压缩用于训练下一一代工具调用模型。

上下文文件

项目上下文文件为每次对话定型。支持 glob 模式、包含/排除规则,适合大型代码库。

快速开始

在 2 分钟内完成安装并开始你的第一次对话

一键安装(Linux, macOS, WSL2)

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

安装后配置

source ~/.bashrc # 重载 shell (或: source ~/.zshrc) hermes # 启动聊天!

基本命令

命令 说明
hermes 启动交互式 CLI,开始对话
hermes model 选择你的 LLM 提供商和模型
hermes tools 配置哪些工具可用
hermes config set 设置单个配置值
hermes gateway 启动消息网关(Telegram, Discord 等)
hermes setup 运行完整设置向导(一次性配置所有内容)
hermes claw migrate 从 OpenClaw 迁移(如从 OpenClaw 切换过来)
hermes update 更新到最新版本
hermes doctor 诊断任何问题

支持的模型提供商

使用 hermes model 命令切换提供商,无需代码更改,不锁定供应商。

Nous Portal OpenRouter (200+ 模型) Xiaomi MiMo z.ai / GLM Kimi / Moonshot MiniMax Hugging Face OpenAI Anthropic Google 自定义端点

CLI 参考

CLI 与消息网关通用的斜杠命令

基础操作

/new 开始新对话
/reset 重置当前对话
/model [provider:model] 切换模型
/personality [name] 设置人格
/retry 重试上次调用
/undo 撤销上次操作

上下文管理

/compress 压缩上下文
/usage 查看令牌使用量
/insights [--days N] 分析使用洞察
/stop 中断当前工作

技能与工具

/skills 浏览可用技能
/<skill-name> 执行指定技能
/tools 查看启用的工具

平台状态

/status 查看连接状态
/platforms 列出已配置平台
/sethome 设置主平台

系统架构

模块化设计,支持高度定制

核心组件

  • Agent Loop - 决策循环引擎
  • Memory System - 持久化记忆
  • Tool System - 工具执行框架
  • Skill Hub - 技能管理系统
  • Context Engine - 上下文处理

通信层

  • Gateway - 多平台消息网关
  • CLI Interface - 命令行终端
  • Webhook Handler - 回调处理
  • Session Manager - 会话管理

学习系统

  • Experience Recorder - 经验记录
  • Skill Generator - 技能生成
  • User Profiler - 用户画像
  • Insight Analyzer - 洞察分析

集成层

  • MCP Client - MCP 协议客户端
  • Model Adapters - 模型适配器
  • RPC Handler - 远程调用
  • Cron Scheduler - 定时任务

支持的平台

运行在任何你想运行的地方

本地

Docker

SSH

Daytona

Singularity

Modal

从 OpenClaw 迁移

轻松迁移你的现有配置

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

hermes clw migrate # 交互式迁移(完整预设) hermes clw migrate --dry-run # 预览将要迁移的内容 hermes clw migrate --preset user-data # 迁移用户数据(不含密钥) hermes clw migrate --overwrite # 覆盖现有冲突

迁移内容

  • SOUL.md — 人格文件
  • Memories — MEMORY.md 和 USER.md 条目
  • Skills — 用户创建的技能(含 ~/.hermes/skills/openclaw-imports/
  • Command Allowlist — 审批模式配置
  • 消息设置 — 平台配置、允许用户、工作目录
  • API 密钥 — 允许的密钥(Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
  • TTF 资产 — 工作区音频文件
  • 工作区结构 — AGENTS.md(带 --workspace-target

贡献代码

欢迎任何形式的贡献!

开发环境设置

git clone https://github.com/NousResearch/hermes-agent.git cd hermes-agent curl -Ls https://astral.sh/uv/install.sh | sh uv venv venv --python 3.11 source venv/bin/activate uv pip install -e ".[dev]" python -m pytest tests/ -x

RL 训练(可选)

git submodule update --init thinker-atrapos uv pip install -e "./thinker-atrapos"