hermes-agent
具备自改进能力的 AI Agent，内置闭环学习循环——从经验中创建和优化技能、自动记忆和跨会话用户建模。亮点是支持 Telegram/Discord/CLI 等多平台接入，可切换 200+ 模型（OpenAI、本地等），且能跑在低配 VPS 或 serverless 环境，空闲时近乎零成本。MIT 协议，适合个人或团队构建持久化、自我进化的 AI 助手。
README
Hermes Agent ☤
由 Nous Research 构建的自我改进 AI 代理。 它是唯一一个内置学习循环的代理——它从经验中创建技能，在使用中改进，主动记忆知识，检索自己的历史对话，并跨会话构建对用户的深度模型。可在 5 美元的 VPS、GPU 集群或无服务器基础设施（空闲时几乎零成本）上运行。它不绑定到你的笔记本——当它在云 VM 上工作时，你可以通过 Telegram 与它交互。
使用你想要的任何模型——Nous Portal、OpenRouter（200+ 模型）、NVIDIA NIM（Nemotron）、Xiaomi MiMo、z.ai/GLM、Kimi/Moonshot、MiniMax、Hugging Face、OpenAI，或你自己的端点。通过 hermes model 切换——无需修改代码，无锁定。
| 真实的终端界面 | 完整的 TUI，支持多行编辑、斜杠命令自动补全、会话历史、中断重定向以及流式工具输出。 |
| 在你所在的地方运行 | Telegram、Discord、Slack、WhatsApp、Signal 和 CLI——全部通过一个网关进程实现。语音消息转录、跨平台对话连续性。 |
| 封闭的学习循环 | 代理策划的记忆，带定期主动记忆。复杂任务后自动创建技能。技能在使用中自我改进。基于 FTS5 的会话搜索，结合 LLM 摘要实现跨会话回忆。Honcho 辩证用户建模。兼容 agentskills.io 开放标准。 |
| 定时自动化 | 内置 cron 调度器，可向任何平台投递。每日报告、夜间备份、每周审计——全部用自然语言表达，无人值守运行。 |
| 委托和并行化 | 生成隔离的子代理用于并行工作流。编写 Python 脚本，通过 RPC 调用工具，将多步管道压缩为零上下文消耗的回合。 |
| 不仅限于笔记本，随处运行 | 七种终端后端——本地、Docker、SSH、Singularity、Modal、Daytona 和 Vercel Sandbox。Daytona 和 Modal 提供无服务器持久化——代理环境空闲时休眠，按需唤醒，会话之间几乎零成本。可在 5 美元的 VPS 或 GPU 集群上运行。 |
| 研究就绪 | 批量轨迹生成、Atropos RL 环境、用于训练下一代工具调用模型的轨迹压缩。 |
快速安装
Linux、macOS、WSL2、Termux
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Windows（原生，PowerShell）——早期测试版
注意： 原生 Windows 支持为 早期测试版。它可安装并运行，但尚未像我们的 Linux/macOS/WSL2 路径那样经过广泛测试。遇到问题时请提交 issue。目前最成熟的 Windows 配置方式是在 WSL2 中运行上方的 Linux/macOS 一行命令。
在 PowerShell 中运行：
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
安装程序会处理所有内容：uv、Python 3.11、Node.js、ripgrep、ffmpeg，以及一个便携版的 Git Bash（MinGit，解压到 %LOCALAPPDATA%\hermes\git——无需管理员权限，完全与系统中的 Git 安装隔离）。Hermes 使用这个捆绑的 Git Bash 运行 shell 命令。
如果你已经安装了 Git，安装程序会检测到并使用它。否则只需下载约 45MB 的 MinGit——它不会影响或干扰任何系统 Git。
Android / Termux： 经过测试的手动路径已记录在 Termux 指南中。在 Termux 上，Hermes 会安装精选的
.[termux]附加组件，因为完整的.[all]附加组件目前会拉取与 Android 不兼容的语音依赖。Windows： 原生 Windows 作为 早期测试版 支持——上方的 PowerShell 一行命令可安装所有内容，但可能会遇到问题，请及时提交 issue。如果你更愿意使用 WSL2（我们最成熟的 Windows 路径），Linux 命令同样适用。原生 Windows 安装位于
%LOCALAPPDATA%\hermes；WSL2 安装位于~/.hermes（与 Linux 相同）。目前唯一需要 WSL2 的 Hermes 功能是基于浏览器的仪表盘聊天面板（它使用 POSIX PTY——经典 CLI 和网关均可原生运行）。
安装完成后：
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 # 诊断问题
📖 完整文档 →
CLI 与消息快速参考
Hermes 有两个入口点：通过 hermes 启动终端 UI，或运行网关并通过 Telegram、Discord、Slack、WhatsApp、Signal 或 Email 与其交互。一旦进入对话，许多斜杠命令在两个界面中共享。
| 操作 | 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 |
文档
所有文档均位于 hermes-agent.nousresearch.com/docs：
| 部分 | 内容涵盖 |
|---|---|
| 快速入门 | 安装 → 设置 → 2 分钟内的首次对话 |
| CLI 用法 | 命令、快捷键、个性、会话 |
| 配置 | 配置文件、提供商、模型、所有选项 |
| 消息网关 | Telegram、Discord、Slack、WhatsApp、Signal、Home Assistant |
| 安全 | 命令批准、DM 配对、容器隔离 |
| 工具与工具集 | 40+ 工具、工具集系统、终端后端 |
| 技能系统 | 程序化记忆、技能中心、创建技能 |
| 记忆 | 持久化记忆、用户画像、最佳实践 |
| MCP 集成 | 连接任何 MCP 服务器以扩展能力 |
| Cron 调度 | 定时任务，支持平台投递 |
| 上下文文件 | 项目上下文，影响每次对话 |
| 架构 | 项目结构、代理循环、关键类 |
| 贡献 | 开发环境搭建、PR 流程、代码风格 |
| CLI 参考 | 所有命令和标志 |
| 环境变量 | 完整的环境变量参考 |
从 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（带
--workspace-target）
参见 hermes claw migrate --help 获取所有选项，或使用 openclaw-migration 技能进行交互式代理引导的迁移，支持 dry-run 预览。
贡献
欢迎贡献！请参见贡献指南了解开发环境搭建、代码风格和 PR 流程。
贡献者快速上手——克隆并用 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
RL 训练（可选）： RL/Atropos 集成（
environments/）——参见CONTRIBUTING.md了解完整设置。
社区
- 💬 Discord
- 📚 技能中心
- 🐛 Issues
- 🔌 HermesClaw — 社区微信桥接：在同一微信账号上运行 Hermes Agent 和 OpenClaw。
许可证
MIT — 参见 LICENSE。
由 Nous Research 构建。