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 的单行命令在那里也适用。发现 Bug 了吗？请 提交问题。

在 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 安装位于 ~/.hermes，与 Linux 相同。

安装后：

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

故障排除

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

如果您的杀毒软件（Bitdefender、Windows Defender 等）将 Hermes bin 文件夹（%LOCALAPPDATA%\hermes\bin\uv.exe）中的 uv.exe 隔离，这是 误报。该文件是 Astral 的 uv——Hermes 为管理其 Python 环境而捆绑的 Rust 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 config get   # Print 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

📖 Full documentation →

跳过 API 密钥收集 — Nous 门户

Hermes 可以与您选择的任何提供商一起使用——这一点不会改变。但如果您不想为模型、网络搜索、图像生成、TTS 和云浏览器分别收集五个 API 密钥，Nous Portal 可以在一个订阅下涵盖所有这些：

• 300 个模型——通过 /model <name> 选择其中任意一个
• 工具网关——网络搜索（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 — 人格文件
• 回忆 — 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 技能进行交互式代理引导迁移，并可预览模拟运行结果。

贡献

我们欢迎贡献！请参阅 Contributing Guide 了解开发设置、代码风格和 PR 流程。

贡献者快速入门——使用标准安装程序，然后从它在 $HERMES_HOME/hermes-agent （通常是 ~/.hermes/hermes-agent）创建的完整 git 检出中工作。这与 hermes update 所使用的布局一致，包括托管 venv、懒加载依赖、网关和文档工具。

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

手动克隆回退（用于一次性克隆/持续集成场景，在这些情况下你故意不想要托管安装布局）：

在克隆的源代码树之外创建虚拟环境 — 如果虚拟环境位于代理操作的目录内，代理运行针对自身检出的相对路径命令时可能会删除该虚拟环境，从而在会话中途破坏正在运行的运行时。

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
• 🐛 Issues
• 🔌 computer-use-linux — 用于 Hermes 和其他 MCP 主机的 Linux 桌面控制 MCP 服务器，具有 AT-SPI 可访问性树、Wayland/X11 输入、屏幕截图和合成器窗口定位功能。
• 🔌 HermesClaw — 社区微信桥：在同一个微信账号上运行 Hermes Agent 和 OpenClaw。

许可证

MIT — 请参阅 许可协议。

由 Nous Research 建立。