开源 AI Agent · Nous Research 出品

Hermes Agent 最完整上手指南

在自己的服务器上部署一次。它学你的项目、自己长出技能、在你每台设备上都能找到 —— 然后每天悄悄变聪明。

GitHub Stars
219K
内置工具
40+
支持平台
22+
稳定版
v0.19.0

聊天框里,活全干了

一个常驻你服务器上的 agent —— 长期记忆、端到端的浏览器控制、定时任务、还有自我进化的 Skills 系统。

定时自动化

说一次,它一直跑

用一句话描述任务和节奏,之后 Hermes 自己接管,服务器重启都不丢。

hermes · Slack
每个工作日早上 9 点把 standup 提示发到 #team
已安排。我会每个工作日 09:00 发提示,并把所有回复存到记忆。
美国节假日跳过,10 点前没人回复就 DM 我
已接入你的美国节假日日历,节日不发。10:00 加了静默检查,回复少于 3 个人会 DM 你。下次发送:周一 3/24。
另外 11 点把回复汇总发一份到 #leadership
完成。11:00 的后续任务会把回复按"进行中 / 阻塞 / 完成"分类,汇总发到 #leadership。要不要明天上线前先 dry-run 一次?
越用越懂

越用越像你的同事

教它一次你的规范,以后每个任务都按你的风格来。

hermes · Telegram
我们用 Conventional Commits 规范,提交信息前要加 feat:、fix:、chore: 这种前缀
收到,已加入项目偏好。以后我写的提交标题都会带上正确的类型前缀。
另外:所有 PR 描述末尾都要有一段「Risk」说明
已加入。以后我起草的 PR 描述末尾都会有「Risk」段,列出可能影响生产的改动 + 回滚方案。
帮我给刚合并的那个 auth bugfix 写提交信息 + PR
Commit: fix(auth): refresh token 过期时静默重新认证 PR 草稿已推到 #98。Risk 段标记了 session 迁移这一步是影响最大的改动 —— 回滚方案 = revert PR #95。
浏览器全控

真的会打开网页

Hermes 操作真实浏览器 —— 你拿到的是页面本身,不是搜索摘要。

hermes · Discord
Anthropic 博客这周有什么新内容?
从 anthropic.com/news 拉了 5 篇(3/17–3/23)。最值得看:《Claude Opus 4.7 发布》(3/18) —— 加了 1M token 上下文,工具调用更快。
打开那篇,把 API 改动提出来
三个 API 改动要注意: • `extended_thinking` 现在默认开启 • 新增 `prompt_caching: "auto"` 选项 • 移除 `legacy_max_tokens`(4.5 起已废弃)
对照 changelog 看下,我们代码里有没有会被打挂的地方?
有 —— 3 个 endpoint 还在用 `legacy_max_tokens`。我开了一个草稿 PR,统一换成新的 `max_tokens`。CI 已绿,等你 review。
长期记忆

记得几个月前你说过什么

不用再解释一遍背景,几个月前的决定和理由 Hermes 都能翻回来。

hermes · Telegram
上个月我们聊过的那个 caching layer,最后定哪个方案了?
查到了 —— 2/14 Slack 讨论。最终选 Redis,复用已有的 BullMQ 实例。记在 #architecture。
我现在要做,但细节忘了,给我个执行清单
基于当时讨论 + 最近 3 个类似 PR: 1. `ioredis` wrapper + 按 key 前缀加 TTL 2. write-through 做 invalidation 3. Redis 故障时降级到数据库 4. 命中率指标接到 Grafana
Alex 当时反对的点是什么来着?
两点:(1) Redis 故障时没 fallback;(2) 跨服务 invalidation 复杂。fallback 没明确 —— 上线前先解决。

5 分钟获取你的 24/7 AI 助手

安装、配置、启动,按顺序走完就能开始用。

1

安装

安装脚本会准备 uv 与 Python 3.11,拉取仓库并补齐初始化配置,整个过程不要求 sudo。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
2

配置

可以接入 Nous Portal、OpenRouter 或你自己的模型端点,交互式向导会把关键设置一步步带完。
# Interactive setup wizardhermes setup# Or choose your modelhermes model
3

开始对话

启动后就是完整的交互式 CLI,工具、记忆和技能系统会一起进入工作状态。
hermes
4

接入多平台(可选)

如果你要把 Hermes 常驻在线,可以继续接入 Telegram、Discord、Slack 或 WhatsApp,并把 gateway 作为 systemd 服务运行。
# Interactive gateway setup wizardhermes gateway setup# Start the messaging gatewayhermes gateway# Install as a system servicehermes gateway install
5

保持更新

需要升级时直接执行更新命令,就能拉取最新代码并重新同步依赖与修复。
hermes update
原生 Windows 目前仍偏实验性。更稳妥的方式是先安装 WSL2,再在其中运行 Hermes Agent。

从 OpenClaw 迁移?
3 步搞定

使用 hermes claw migrate 一键迁移,配置不会丢。备份、导入、诊断一条龙。

查看迁移指南
hermes-sh
~ hermes claw migrate --dry-run
[INFO] Scanning for legacy OpenClaw instances.
[INFO] Found 3 nodes. Starting data mapping.
[PROGRESS]100%
✓ SUCCESS: Migration completed in 1.2s
✓ All configs migrated
✓ All 3 agents imported

全网优质资源聚合

HermesAgent 101 致力于做最好的 Hermes Agent 资源聚合站。

欢迎补充资源、改进内容、分享经验。

EN
Official Docs

Hermes Agent Official Site

The official Hermes Agent website for project overview, features, and latest updates.
docssetupfeatures
Official Docs访问
EN
Official Docs

Hermes Agent Documentation

The official documentation covering installation, quickstart, architecture, gateways, memory, skills, MCP, and more.
quickstartsetupgetting started
Official Docs访问
EN
Official Docs

NousResearch/hermes-agent

The official GitHub repository for Hermes Agent, including source code, issues, releases, and project activity.
reposource coderelease
GitHub访问
EN
Official Docs

Architecture Overview

A developer-facing architecture guide focused on the agent runtime, prompt assembly, and the core execution loop.
architectureruntimeprompt
Official Docs访问
EN
Videos

Hermes Just Released Their Biggest Update Ever (Hermes Bot)

A timely walkthrough of Hermes Bot covering its setup, strengths, limitations, practical use cases, and how it compares with Grok Bot.
Hermes BotGrok Botuse cases
Alex Finn访问
EN
Videos

Learn 95% of Hermes Agent in 31 Minutes

A structured guide to Hermes Desktop, Telegram, models, memory, skills, tools, scheduled jobs, subagents, specialist profiles, safety, and real-world workflows.
guidememorysubagents
Sharbel A.访问
EN
Videos

Hermes Agent Desktop: Full Setup + Real Use Cases

A screen-shared walkthrough of Hermes Desktop featuring sessions, profiles, artifacts, skills, cron jobs, subagents, local models, cost control, and practical business use cases.
desktopuse casessubagents
Greg Isenberg访问
EN
Videos

Hermes Agent Explained in 5 Minutes

A concise introduction explaining what makes Hermes Agent useful, how to install it, how its skill system works, and which users and workflows it suits best.
overviewinstallationskills
CodeHead访问
EN
Community

What Tool Do You Use to Browse Reddit with Hermes?

A community discussion of reliable read-only Reddit access for Hermes using public JSON endpoints, authenticated sessions, SearXNG, browser tools, PRAW, and other fallback options.
Redditbrowser automationSearXNG
ozone6587访问
EN
Analysis

I Spent Hours Comparing Models. Turns Out the Model Was Never the Problem.

A practical troubleshooting lesson showing how weak search, page extraction, browser access, credentials, permissions, and tool configuration can limit every model in the same way.
troubleshootingconfigurationresearch
kenmazaika访问
EN
Videos

Hermes Agent: Zero to Personal AI Assistant (1 Hour Course)

A complete video course covering Hermes Agent setup, VPS deployment, memory, skills, soul, cron jobs, practical use cases, and the self-improvement loop.
coursesetupmemory
Nate Herk | AI Automation访问
EN
Videos

100 Hours of Hermes Agent Lessons in 46 Minutes

A practical collection of lessons from extensive Hermes Agent use, focused on building reliable workflows, improving agent behavior, and getting more value from everyday automation.
lessonsworkflowsbest practices
David Ondrej访问
EN
Videos

Hermes Agent Just Got 10X Better (Agentic OS)

A walkthrough of an Agentic OS-style Hermes setup for coordinating agents, tools, persistent context, and automated work inside a more complete operating system for AI workflows.
agentic OSmulti-agentorchestration
Jack Roberts访问
EN
Videos

Hermes Agent Fundamentals in 29 Minutes

A concise introduction to Hermes Agent fundamentals, setup, core capabilities, and practical automation for people who want a structured starting point.
fundamentalsbeginnersetup
Tina Huang访问
EN
Analysis

Three Months with Hermes Agent: What I Wish I Had Understood Earlier

Hard-won lessons from using Hermes Agent as a daily driver for three months, including memory, profiles, model choices, Raspberry Pi hosting, stability, and realistic expectations.
experiencememoryRaspberry Pi
itsdodobitch访问
EN
Community

Sharing My Totally Nutty Hermes Setup

A detailed showcase of the Joshu stack: Hermes on a dedicated cloud server with multi-gateway communication, Hindsight memory, semantic file search, a shared human-AI desktop, and a sandboxed authenticated browser.
cloud desktopvoicememory
Stephen_Falken_1983访问
ZH
Videos

2026 最新 Hermes Agent 新手完整教程

一套面向新手的 Hermes Agent 中文视频课程,涵盖安装部署、微信和 QQ 及飞书接入、个性化配置、Skills、持久记忆、MCP、Cron 与 Web 仪表板。
installationmessagingMCP
阿良摸到了陆芝的腿-访问
EN
Tutorials

How I Use Obsidian as the Long-Term Memory Backbone for My AI Assistant

A community workshop for combining Hermes Agent with an Obsidian vault through a three-tier memory system, daily notes, scheduled briefings, searchable history, and reusable starter templates.
Obsidianmemoryknowledge base
Jonathan_Rivera访问
EN
Community

My Hermes Setup, Roast Me

A detailed production setup using Hermes Agent on Apple Silicon with Docker, multiple profiles, SearXNG, Hindsight, Bitwarden, automated coding, QA, deployment, and documentation workflows.
Dockerprofilesautomation
riceinmybelly访问
EN
Analysis

One Month with Hermes Agent — What I Wish I Knew Earlier

Practical lessons from a month of daily Hermes Agent use, including starting with one reliable workflow, separating profiles, treating configuration as part of the product, and building reusable skills.
experienceprofilesskills
itsdodobitch访问
EN
Tutorials

Nous Research Hermes Agent: Setup and Tutorial Guide

A hands-on DataCamp guide to installing Hermes Agent, choosing local or hosted models, connecting messaging gateways, using subagents and MCP, and troubleshooting common setup problems.
installationlocal modelsMCP
Derrick Mwiti访问
EN
Analysis

How to Automate Workflows Using Open-Source AI Agents

A TechRadar guide for solo founders comparing Hermes Agent and OpenClaw, with practical advice on workflow automation, platform selection, operating costs, security guardrails, and gradual adoption.
automationbusinessOpenClaw
Ritoban Mukherjee访问
EN
Official Docs

Hermes Agent v0.20.0 — The Herald Release

The official v0.20.0 release notes covering real-time conversational voice, barge-in, wake words, grounded citations, A2A v1.0, signed webhooks, the desktop plugin SDK, and smarter recovery.
release noteschangelogv0.20.0
NousResearch访问
EN
Official Docs

Voice Mode

The official guide to using Hermes Agent with interactive voice, streaming text-to-speech, speech-to-text, wake words, and voice conversations across the CLI and messaging platforms.
voicetext-to-speechspeech-to-text
NousResearch访问

不是 Copilot,也不是 Chatbot。

Hermes Agent 是 Nous Research 开源的自主 AI Agent。它不是绑在 IDE 里的编码副驾,也不是套在单一 API 外面的聊天壳,而是一个可以长期跑在你服务器上、会记住经验并随着运行时间持续变强的 agent runtime。

你在哪,它就在哪

一个 agent 同时在 Telegram、Discord、Slack、WhatsApp、Signal、邮件和终端里工作。在手机上开了个头,回家打开电脑接着聊。

越用越懂你

持久 memory 和自动生成的 skills 一起工作。它记得你的项目习惯,也记得上次那个 bug 是怎么解的。

沙箱执行

五种执行后端随便挑:本地、Docker、SSH、Singularity、Modal。容器加固加命名空间隔离,不想让它碰你主机就别让它碰。

定时自动化任务

你用人话描述"每天早上 8 点给我发新闻简报",它就自己跑起来。结果通过 gateway 送到你选的任何一个入口。

并行子 Agent

按需派发隔离的子 agent 并行推进任务,每个都有独立会话和终端。多步骤流水线能经 RPC 折叠成几乎零上下文开销的一次调用。

完整浏览器与网页控制

搜索、抓取、导航、点击、输入、截屏一条龙。需要时还能叠加视觉理解、图像生成、语音合成和多模型推理。

常见问题

高频被问到的几个问题,先在这里看完。

跟上 Hermes 更新

只保留真正重要的版本、文档和工作流更新。