Hermes Agent：内置学习循环的自改进 AI 助手 | 前端进阶之旅

Hermes Agent：内置学习循环的自改进 AI 助手 | 前端进阶之旅

Full translation

完整中文译文

Hermes Agent | Hermes Desktop

由 Nous Research 构建的自我改进型 AI Agent。它是目前唯一内置学习循环的 Agent——它能从经验中创建技能、在使用中不断优化、推动自身持久化知识、搜索自身的历史对话，并在多次会话中逐步构建对你的深入认知。在 5 美元的 VPS、GPU 集群或近乎零成本的闲置服务器less 基础设施上都能运行。它不依赖你的笔记本——当它在云端 VM 上工作时，你可以通过 Telegram 与它对话。

使用任何你想要的模型—— Nous Portal、OpenRouter、OpenAI、你自己的端点，以及其他众多选择。使用 hermes model 切换，无需改动代码、不存在绑定。

支持 Linux、macOS、WSL2、Termux

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

Windows（原生，PowerShell）

注意：原生 Windows 环境下 Hermes 不依赖 WSL 运行——CLI、gateway、TUI 和工具全部原生工作。如果你更倾向使用 WSL2，上面的 Linux/macOS 一行命令同样适用。发现 bug？请提交 issue。

在 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] extra，因为目前完整的 .[all] extra 会拉取与 Android 不兼容的语音依赖。

Windows：原生 Windows 已完全支持——上面的 PowerShell 一行命令即可完成安装。如果你更倾向使用 WSL2，Linux 命令同样适用。原生 Windows 安装目录在 %LOCALAPPDATA%\hermes；WSL2 安装目录与 Linux 一样在 ~/.hermes。

source ~/.bashrc    # 重新加载 shell（或者：source ~/.zshrc）
hermes              # 开始对话！

如果你的杀毒软件（Bitdefender、Windows Defender 等）将 Hermes bin 目录（%LOCALAPPDATA%\hermes\bin\uv.exe）中的 uv.exe 隔离，这是误报。该文件是 Astral 的 uv——即 Hermes 捆绑的 Rust 版 Python 包管理器，用于管理其 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

如果 attestation 显示"Verification succeeded"且最后一行打印 True，就没问题。

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              # 交互式 CLI — 开始对话
hermes model        # 选择你的 LLM 提供商和模型
hermes tools        # 配置启用哪些工具
hermes config set   # 设置单个配置值
hermes config get   # 打印单个配置值
hermes gateway      # 启动消息 gateway（Telegram、Discord 等）
hermes setup        # 运行完整设置向导（一次性配置所有内容）
hermes claw migrate # 从 OpenClaw 迁移（如果你从 OpenClaw 过来的话）
hermes update       # 更新到最新版本
hermes doctor       # 诊断任何问题

📖 完整文档 →

跳过 API key 的收集—— Nous Portal

Hermes 可以与任何你想要的提供商协作——这一点不会改变。但如果你懒得为模型、网络搜索、图片生成、TTS 和云浏览器分别收集五个独立的 API key，Nous Portal 可以用一个订阅覆盖所有这些：

300+ 模型——用 /model <name> 随意选择

Tool Gateway——网络搜索（Firecrawl）、图片生成（FAL）、文字转语音（OpenAI）、云浏览器（Browser Use），全部通过你的订阅路由，无额外账户。

从全新安装的一条命令：

hermes setup --portal

这会通过 OAuth 登录、将 Nous 设为你的提供商并开启 Tool Gateway。用 hermes portal info 随时查看已接入的服务。详细说明见 Tool Gateway 文档页。

你仍然可以随时为每个工具自带 key——gateway 是按后端配置的，不是全有或全无。

CLI 与消息通道快速参考

Hermes 有两个入口：用 hermes 启动终端 UI，或者运行 gateway 并从 Telegram、Discord、Slack、WhatsApp、Signal 或 Email 与它对话。一旦进入对话，许多斜杠命令在两个界面中是共用的。

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

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

从 OpenClaw 迁移

如果你从 OpenClaw 过来，Hermes 可以自动导入你的设置、记忆、技能和 API key。

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

安装后任何时候：

hermes claw migrate              # 交互式迁移（完整预设）
hermes claw migrate --dry-run    # 预览将要迁移的内容
hermes claw migrate --preset user-data   # 不带密钥的迁移
hermes claw migrate --overwrite  # 覆盖现有冲突

迁移内容：

SOUL.md — 人设文件
Memories — MEMORY.md 和 USER.md 条目
Skills — 用户创建的技能 → ~/.hermes/skills/openclaw-imports/
Command allowlist — 审批模式
Messaging settings — 平台配置、允许的用户、工作目录
API keys — 白名单中的密钥（Telegram、OpenRouter、OpenAI、Anthropic、ElevenLabs）
TTS assets — 工作区音频文件
Workspace instructions — AGENTS.md（带 --workspace-target）

运行 hermes claw migrate --help 查看所有选项，或使用 openclaw-migration skill 获取交互式 Agent 引导的迁移（带 dry-run 预览）。

欢迎贡献！参见贡献指南了解开发设置、代码风格和 PR 流程。

贡献者快速上手——使用标准安装程序，然后在 $HERMES_HOME/hermes-agent（通常为 ~/.hermes/hermes-agent）的完整 git checkout 中工作。这与 hermes update、托管 venv、延迟依赖、gateway 和文档工具使用的布局一致。

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

手动 clone 备选方案（适用于一次性 clone/CI——你故意不需要托管安装布局的情况）：

在克隆的源目录外部创建 venv——如果 venv 位于 Agent 操作目录内，可能被 Agent 对自身 checkout 运行的一条相对路径命令擦除，导致运行时在会话中途被销毁。

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

🔌 computer-use-linux — 面向 Hermes 和其他 MCP 主机的 Linux 桌面控制 MCP 服务器，具备 AT-SPI 无障碍树、Wayland/X11 输入、截图和合成器窗口定位功能。

🔌 HermesClaw — 社区微信桥：在同一个微信账号上运行 Hermes Agent 和 OpenClaw。

由 Nous Research 构建。