Hermes Agent ☤

由 Nous Research 构建的自进化 AI 代理。 它是唯一内置学习闭环的智能代理——从经验中创建技能，在使用中改进技能，主动持久化知识，搜索过往对话，并在跨会话中逐步构建对你的深度理解。可以在 $5 的 VPS 上运行，也可以在 GPU 集群上运行，或者使用几乎零成本的 Serverless 基础设施。它不绑定你的笔记本——你可以在 Telegram 上与它对话，而它在云端 VM 上工作。

支持任意模型——Nous Portal、OpenRouter（200+ 模型）、NVIDIA NIM（Nemotron）、小米 MiMo、z.ai/GLM、Kimi/Moonshot、MiniMax、Hugging Face、OpenAI，或自定义端点。使用 hermes model 即可切换——无需改代码，无锁定。

快速安装

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

支持 Linux、macOS、WSL2 和 Android (Termux)。安装程序会自动处理平台特定的配置。

Android / Termux： 已测试的手动安装路径请参考 Termux 指南。在 Termux 上，Hermes 会安装精选的 .[termux] 扩展，因为完整的 .[all] 扩展会拉取 Android 不兼容的语音依赖。

Windows： 原生 Windows 不受支持。请安装 WSL2 并运行上述命令。

安装后：

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> | /skills 或 /<skill-name> | | 中断当前工作 | Ctrl+C 或发送新消息 | /stop 或发送新消息 | | 平台特定状态 | /platforms | /status、/sethome |

完整命令列表请参阅 CLI 指南 和 消息网关指南。

文档

所有文档位于 hermes-agent.nousresearch.com/docs：

| 章节 | 内容 | |------|------| | 快速开始 | 安装 → 设置 → 2 分钟内开始首次对话 | | CLI 使用 | 命令、快捷键、人格、会话 | | 配置 | 配置文件、提供商、模型、所有选项 | | 消息网关 | Telegram、Discord、Slack、WhatsApp、Signal、Home Assistant | | 安全 | 命令审批、DM 配对、容器隔离 | | 工具与工具集 | 40+ 工具、工具集系统、终端后端 | | 技能系统 | 过程记忆、技能中心、创建技能 | | 记忆 | 持久记忆、用户画像、最佳实践 | | MCP 集成 | 连接任意 MCP 服务器扩展能力 | | 定时调度 | 定时任务与平台投递 | | 上下文文件 | 影响每次对话的项目上下文 | | 架构 | 项目结构、代理循环、关键类 | | 贡献 | 开发设置、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 技能进行交互式代理引导迁移（含干运行预览）。

贡献

欢迎贡献！请参阅 贡献指南 了解开发设置、代码风格和 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]"
python -m pytest tests/ -q

RL 训练（可选）： 如需参与 RL/Tinker-Atropos 集成开发：

git submodule update --init tinker-atropos
uv pip install -e "./tinker-atropos"

社区

• 💬 Discord
• 📚 技能中心
• 🐛 问题反馈
• 💡 讨论区
• 🔌 HermesClaw — 社区微信桥接：在同一微信账号上运行 Hermes Agent 和 OpenClaw。

许可证

MIT — 详见 LICENSE。

由 Nous Research 构建。