Hermes Agent ☤

Hermes Agent | Hermes Desktop

**这是一款由Nous Research打造的自我进化型AI智能体。**它是唯一拥有内置学习循环的智能体——它能够从经验中生成技能，在使用过程中不断优化这些技能，主动保持知识记忆，检索过往对话记录，并在多次会话中逐步构建对你特征的深度认知模型。你可以在价格仅为5美元的VPS、GPU集群，或是闲置时成本几乎为零的无服务器架构上运行它。它无需绑定在你的笔记本电脑上——即便智能体运行在云端虚拟机中，你也可以通过Telegram与其交互。

你可以使用任何想要的模型——Nous Portal、OpenRouter、OpenAI、自建的接口，以及更多选项。只需通过hermes model命令即可切换模型，无需修改代码，也不会受到限制。

快速安装指南

Linux、macOS、WSL2、Termux系统

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows（原生版，PowerShell）

重要提示： Windows原生环境可在无需WSL的情况下运行Hermes——其CLI、网关、TUI及各类工具均以原生方式运行。如果您更倾向于使用WSL2，上述适用于Linux/macOS的命令同样可以在该环境中使用。发现漏洞？请提交问题报告。

在PowerShell中执行以下命令：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装程序会自动处理所有相关配置：包括 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 一键命令即可完成所有安装。如果您更愿意使用 WSL2，Linux 版本的命令同样适用。原生 Windows 安装文件存放在 %LOCALAPPDATA%\hermes 目录下；而 WSL2 环境下的安装文件则与 Linux 一样，存放在 ~/.hermes 目录中。

安装完成后：

source ~/.bashrc    # reload shell (or: source ~/.zshrc)
hermes              # start chatting!

故障排除

Windows Defender 或其他杀毒软件将 uv.exe 标记为恶意程序

如果您的杀毒软件（如 Bitdefender、Windows Defender 等）将 Hermes bin 文件夹中的 uv.exe（位于 %LOCALAPPDATA%\hermes\bin\uv.exe）隔离起来，这属于误报。该文件实际上是 Astral 开发的 uv —— 一种 Rust 语言的 Python 包管理工具，Hermes 会将其集成在内以管理 Python 环境。基于机器学习的杀毒引擎通常会将用于下载和安装包的未签名 Rust 可执行文件标记为恶意程序。

如需确认您所使用的文件是正版，请按以下步骤操作：

# Install GitHub CLI if needed
winget install --id GitHub.cli

# Login to GitHub
gh auth login

# Run verification
$uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
$ver = (& $uv --version).Split(' ')[1]
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zip = "$env:TEMP\uv.zip"
Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing
gh attestation verify $zip --repo astral-sh/uv
Expand-Archive $zip "$env:TEMP\uv_x" -Force
(Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash

如果验证结果显示“验证成功”，且最后一行输出 True，则表示一切正常。

将 Hermes 加入白名单：

• Windows Defender： 以管理员身份运行 PowerShell → 输入 Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"
• Bitdefender： 在 Bitdefender 控制台添加例外规则（路径为 Protection > Antivirus > Settings > Manage Exceptions）
• 应对文件夹进行白名单处理，而非文件哈希值——因为 Hermes 会更新 uv，且每个版本都会导致哈希值变化。

如需更多背景信息，请查看上游项目 Astral 的相关报告：astral-sh/uv#13553、astral-sh/uv#15011、astral-sh/uv#10079。

入门指南

hermes              # Interactive CLI — start a conversation
hermes model        # Choose your LLM provider and model
hermes tools        # Configure which tools are enabled
hermes config set   # Set individual config values
hermes gateway      # Start the messaging gateway (Telegram, Discord, etc.)
hermes setup        # Run the full setup wizard (configures everything at once)
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
hermes update       # Update to the latest version
hermes doctor       # Diagnose any issues

📖 完整文档 →

无需收集 API 密钥——Nous Portal

Hermes 可以与您选择的任何服务提供商配合使用，这一点不会改变。但如果您不想分别为模型、网络搜索、图像生成、文本转语音以及云浏览器收集五组不同的 API 密钥，Nous Portal 即可通过一个订阅套餐整合所有功能：

• 300 多种模型——通过 /model <名称> 即可选用任意模型；
• 工具网关——网络搜索（Firecrawl）、图像生成（FAL）、文本转语音（OpenAI）、云浏览器（Browser Use），所有功能均通过您的订阅套餐统一处理，无需额外账户。

首次安装后仅需一条命令即可使用：

hermes setup --portal

该操作会通过 OAuth 进行登录，将 Nous 设定为您的服务提供方，并启用工具网关。您随时可以使用 hermes portal info 查看当前已连接的配置。更多详细信息请参阅工具网关文档页面。

您仍然可以随时为不同的工具自行配置密钥——该网关是按后端独立运行的，并非全有或全无的模式。

CLI 与消息平台快速参考

Hermes 提供两种使用方式：通过 hermes 启动终端界面，或运行网关后从 Telegram、Discord、Slack、WhatsApp、Signal 或邮件与其交互。一旦进入对话模式，许多斜杠命令在两种界面中都是通用的。

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

文档资源

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

从 OpenClaw 迁移

如果您原本使用的是 OpenClaw，Hermes 可以自动导入您的设置、记忆内容、技能及 API 密钥。

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

安装后的任何时间：

hermes claw migrate              # Interactive migration (full preset)
hermes claw migrate --dry-run    # Preview what would be migrated
hermes claw migrate --preset user-data   # Migrate without secrets
hermes claw migrate --overwrite  # Overwrite existing conflicts

会被导入的内容：

• SOUL.md — 人物设定文件
• Memories — MEMORY.md 与 USER.md 中的记录
• Skills — 用户自定义的技能 → ~/.hermes/skills/openclaw-imports/
• 命令允许列表 — 审批规则配置
• 消息设置 — 平台配置、允许的消息发送对象以及工作目录
• API 密钥 — 已列入允许列表的密钥（适用于 Telegram、OpenRouter、OpenAI、Anthropic、ElevenLabs）
• TTS 资源 — 工作区的音频文件
• 工作区说明 — AGENTS.md 文件（需使用 --workspace-target 参数）

如需查看所有选项，请参阅 hermes claw migrate --help；若希望通过交互式引导完成迁移并预览效果，可使用 openclaw-migration 技能。

贡献指南

我们欢迎大家贡献代码！有关开发环境配置、代码风格规范以及 Pull Request 提交流程的详细说明，请参阅 贡献指南。

对于希望快速开始贡献的开发者：请先使用标准安装程序，随后在安装程序生成的完整 git 代码库中进行开发，该代码库通常存储在 $HERMES_HOME/hermes-agent 目录下（即 ~/.hermes/hermes-agent）。这样的目录结构与 hermes update、托管虚拟环境、延迟加载依赖项、网关以及文档工具所使用的结构保持一致。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
cd "${HERMES_HOME:-$HOME/.hermes}/hermes-agent"
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

手动克隆回退方案（适用于临时克隆或 CI 环境，即那些您明确不希望采用托管安装结构的场景）：

请在已克隆的源代码目录之外创建虚拟环境——因为代理程序在其运行的目录内创建的虚拟环境，可能会被该代理针对自身下载的代码所执行的相对路径命令清除，从而导致会话进行到一半时运行时的环境被破坏。

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

社区资源

• 💬 Discord
• 📚 Skills Hub
• 🐛 问题反馈
• 🔌 computer-use-linux — 专为 Hermes 及其他 MCP 主机设计的 Linux 桌面控制 MCP 服务器，支持 AT-SPI 辅助功能树、Wayland/X11 输入操作、截图以及合成器窗口控制。
• 🔌 HermesClaw — 社区微信桥接工具：允许在同一个微信账号上同时运行 Hermes Agent 和 OpenClaw。

许可协议

采用 MIT 许可协议 — 详情请参阅 LICENSE 文件。

本项目由 Nous Research 开发。