开源 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
Community

Making Hermes More Proactive with SOUL.md

A high-engagement community discussion on turning Hermes from a reactive assistant into a more proactive operator, with concrete SOUL.md guidance, examples of high-agency behavior, and practical boundaries for safe autonomous follow-through.
proactive agentsSOUL.mdautomation
ozone6587访问 ↗
EN
Analysis

The Future of Hermes vs Closed Personal Agents

A widely discussed comparison of Hermes with newer closed personal agents such as Muse, Grok Bot, and Dots, covering open-source ownership, model choice, privacy, mobile usability, maintenance, stable releases, and long-term community resilience.
open sourceprivacycomparison
Dense-Map-406访问 ↗
EN
Tutorials

Hermes Agent Complete Setup: VPS, Messaging, Skills, and Cron

A detailed end-to-end video walkthrough covering VPS deployment, Docker and SSL troubleshooting, OpenRouter and ChatGPT connections, Telegram and WhatsApp gateways, the desktop app, memory, MCP integrations, custom skills, and a production-style cron automation.
VPSDockerMCP
Vivek Mishra访问 ↗
EN
Tools

Hermes Desktop as a Self-Hosted Web and Mobile PWA

A community project and discussion about bringing the Hermes desktop experience to browsers and mobile devices through a self-hosted Docker image or Nix flake, with PWA access for phones, tablets, and locked-down devices.
PWAmobileself-hosting
SmoothPercentage1318访问 ↗
EN
Tutorials

Hermes Agent Full Tutorial and Setup Guide for Beginners

A popular beginner-focused video showing how to deploy Hermes on a VPS, connect models and Telegram, attach the desktop app, configure persistent preferences, create skills, schedule cron jobs, troubleshoot logs, and run an always-on assistant safely.
beginnerVPSTelegram
Metics Media访问 ↗
EN
Community

Troubleshooting Hermes, Obsidian, and Cross-Session Memory

A highly active troubleshooting discussion about an Obsidian vault disappearing from the agent's working knowledge between sessions, with practical guidance on model capability, vault paths, skills, memory providers, headless setups, knowledge-base structure, and durable backups.
Obsidianmemorytroubleshooting
should_have_been_her访问 ↗
EN
Community

Hermes Handles Meal Planning and Grocery Shopping

A popular end-to-end household workflow where Hermes creates a meal plan, adds ingredients to a Walmart cart, adapts when products are unavailable, and accepts new requests through Telegram, with follow-up discussion of browser automation and pantry tracking.
meal planningbrowser automationTelegram
Marmotbath访问 ↗
EN
Tools

DonSeTch: Free Web Research MCP and CLI for Hermes

A community-built Rust tool providing keyless search, fetch, and focused crawling through MCP or the command line, with bot-wall escalation, semantic reranking, compact outputs, change detection, PDF extraction, benchmarks, limitations, and extensive field feedback.
web researchMCPCLI
Opening_Library9560访问 ↗
EN
Community

From Factory Mechanic to a Hermes-Powered Business

A personal case study about moving from factory work into a business centered on Hermes Agent, describing practical systems for nutrition, mental health, content production, website and VPS management, infrastructure advice, trend research, and study tracking.
businesscontent creationpersonal workflows
HolmeBengt访问 ↗
EN
Community

Giving Hermes Radio Ears and a Mouth

A popular hardware experiment connecting Hermes to a HackRF and portable radio for spectrum sweeps, signal analysis, monitoring, and alerts, accompanied by an open setup guide and useful community discussion about classification accuracy, radio regulations, and operational safeguards.
HackRFradiohardware
frankentriple访问 ↗
EN
Analysis

Fable 5.1 vs GPT-5.6 Sol in Hermes: Same Task, Different Agents

A high-engagement side-by-side test using the same visual reconstruction task, comparing output quality, work style, failures, token usage, and cost: Fable produced more detailed iterations while Sol finished much faster and at a fraction of the price.
model comparisonFableGPT-5.6 Sol
KrstABot访问 ↗
EN
Community

Running Hermes with MiMo on a VPS

A popular hands-on report about pairing Hermes Agent with MiMo on a spare VPS to track deliveries, build small home applications, and operate through Telegram, followed by community discussion of low-cost model plans, limits, fallbacks, and setup choices.
MiMoVPSTelegram
mgargallo访问 ↗
EN
Analysis

A Vendor Asked My Hermes Agent Out for Coffee

A viral real-world case about deploying a Hermes-powered vendor coordinator with its own company email, personality, and procurement duties, raising difficult questions about disclosure, delegated communication, headcount budgets, workplace trust, and the boundary between effective automation and impersonation.
businessemail automationethics
Vast_Scale734访问 ↗
EN
Community

Hermes Use Cases and a Solo Agency Tech Stack

A widely discussed map of a Hermes-centered solo-agency stack connecting email, phone, web search, coding, repositories, social media, Cloudflare, app integrations, media generation, and payments, with examples of content workflows and automated client operations.
agencyintegrationssocial media
mrblue55访问 ↗
EN
Tutorials

Integrations, Plugins & Skills Ecosystem Megathread

A detailed community reference covering Hermes messaging gateways, productivity apps, knowledge bases, home automation, MCP servers, webhooks, browser tools, secret management, and the skills ecosystem, including common picks, setup patterns, and operational pitfalls.
integrationspluginsskills
Jonathan_Rivera访问 ↗
EN
Community

What Have You Done with Hermes Agent This Week? — September 18

A high-engagement weekly showcase spanning business operations, grocery planning, genealogy research across thousands of archival pages, infrastructure automation, SEO, local multi-agent workflows, expense tracking, translation, and production cron systems.
use casesworkflowsautomation
AutoModerator访问 ↗
EN
Analysis

Refactoring Hermes with 1,393 Agents

A widely discussed case study of using Hermes, Fable, and the goal workflow to coordinate 1,393 subagents during a large codebase refactor, including reported time, code reduction, model cost, testing concerns, and community debate about reliability and guardrails.
multi-agentrefactoringFable
johnb_123访问 ↗
EN
Analysis

I Spend More Time Guiding Hermes Than Getting Work Done

A practical discussion of the setup and supervision cost behind role-based Hermes agents, especially when using custom plugins, with community advice on model routing, specialist profiles, shared memory, orchestration, and the training period needed for reliable results.
pluginsorchestrationmodel routing
edstevo访问 ↗
EN
Community

Use Hermes to Answer Questions About Hermes

A popular reminder to treat Hermes as an active problem-solving system rather than wait for perfect prompts, illustrated by a hardware-driver troubleshooting example and a broad discussion of model quality, verification, autonomy, and knowing when community help is still valuable.
problem solvingpromptingautonomy
The1KrisRoB访问 ↗
EN
Tutorials

What Can I Do with Hermes Agent as a Beginner?

A highly active beginner thread collecting approachable first projects: folder-based knowledge assistants, daily cron jobs, mobile gateways, memory providers, study planning, fitness tracking, email triage, research, accounting, career coaching, and other real-world workflows.
beginnersuse casesmemory
BadKarma6996访问 ↗

不是 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 更新

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