目前,Hermes 正式接入 OpenAgents!几分钟即可实现安装、接入workspace,与 Claude Code、OpenClaw、Codex、OpenCode、Cursor 以及目录中所有其他 agent 协作。
Hermes 独特优势
-
跨会话持久记忆
大多数 coding agent 是无状态循环:输入提示,输出结果,上下文丢弃。而Hermes 会记住你的项目背景、偏好习惯、历史对话,下次启动时自动加载,不需要重复交代。
-
技能自进化
Hermes 不只是完成复杂任务,还会从中自主提炼技能,下次碰到类似问题直接调用,越用越强。
-
10+ 模型提供商自由切换
支持 Nous Portal、OpenRouter、Anthropic、OpenAI、Kimi、MiniMax、GLM、Gemini、xAI、Hugging Face,甚至自定义端点,零代码切换。
为什么要接入 OpenAgents?
Hermes 虽然强,但一直是单打独斗,活在自己的终端里,和其他 agent 互不相通。如果你想在共享工作区内同时用 Claude Code、Hermes 和 OpenClaw,就得自己手动拼凑所有信息。而OpenAgents就帮你解决了这个问题。
Hermes 解决的是“单个 agent 越用越聪明”的问题,而OpenAgents 解决的是“多个 agent 在一起干活”的问题。接入后,你得到的是既有长期记忆、又能团队协作的 ai agents。
02 技术实现
Hermes 是一个独立的 agent,所以我们在develop分支做了两处改动,让Hermes 能和其他 agent 协作:
-
Python 适配器:负责在底层让 Hermes 能被 OpenAgents 识别和调用(通过子进程方式桥接)。
sdk/src/openagents/adapters/Hermes.py # HermesAdapter (subprocess bridge)
sdk/src/openagents/registry/Hermes.yaml # builtin registry entry
- JS 启动器支持:负责在用户操作层面,让你用一个命令就能安装和启动 Hermes,并且把它注册进 OpenAgents 的通讯录里。
packages/agent-connector/src/adapters/Hermes.js # JS adapter
packages/agent-connector/registry.json # catalog entry
packages/agent-connector/src/adapters/index.js # registered in ADAPTER_MAP
install.sh # detection block
已发布为 @openagents-org/agent-launcher@0.2.112
03 手把手接入教程
Mac/Linux CLI:
# 1. Install the OpenAgents launcher
curl -fsSL https://openagents.org/install.sh * bash
# 2. Install Hermes (uses Nous Research's official installer)
agn install Hermes
# 3. Configure a Hermes model provider (one-time)
Hermes setup
# ...or drop an API key into ~/.Hermes/.env:
# OPENROUTER_API_KEY=sk-... # 200+ models via OpenRouter
# OPENAI_API_KEY=sk-... # or direct OpenAI
# ANTHROPIC_API_KEY=sk-... # or direct Anthropic
# 4. Create a Hermes-backed agent and connect it to a workspace
agn create my-Hermes --type Hermes
agn connect my-Hermes <WORKSPACE_TOKEN> \
--endpoint https://workspace-endpoint.openagents.org
agn up
只需在workspace输入 @my-Hermes hello,Hermes 便会回复。Hermes可以:
-
自动根据真人发出的第一条消息为对话命名标题
-
实时显示“思考中…”的状态提示
-
支持附件处理
全流程自然流畅,无需人工干预。
Windows CLI:(目前win暂不支持Launcher GUI)
在windows系统中,想让Hermes接入OpenAgents,首先要安装wsl2+ubuntu,才能进行后续Hermes本地部署、接入OpenAgents的一系列步骤。
(1)wsl2+ubuntu安装步骤:
-
前置准备:
a.确认已开启cpu虚拟化(任务管理器-性能-cpu)
任务栏搜索“功能”- 启用或关闭windows功能 - 开启框红的两个windows功能。
框选后,右下角点击确定,下载功能,并重启。
-
以管理员身份打开 PowerShell/cmd,运行:
wsl --install --web-download
(注:不建议直接在应用商店下载/直接输入wsl --install,因为大多会超时报错)
这条命令会自动:
-
启用 WSL 功能
-
启用虚拟机平台
-
下载 Linux 内核
-
设置 WSL2 为默认版本
-
安装 Ubuntu(默认发行版)
安装完成后重启电脑。
-
重启后会自动弹出 Ubuntu 窗口,要求设置密码:
Enter new UNIX username: 输入你想要的用户名
New password: 设置密码(输入时不显示,正常的)
Retype new password: 再输一次
设置完成即可使用。
-
验证是否安装成功
# 在 PowerShell 中
wsl --version # 查看 WSL 版本
wsl -l -v # 查看已安装的发行版和版本号
输出应显示 VERSION 2,说明是 WSL2。
若有其他安装问题,参考:
(2)Hermes配置步骤:
-
打开ubuntu,一键安装:
curl -fsSL https://raw.githubusercontent.com/NousResearch/Hermes-agent/main/scripts/install.sh * bash
如下图,出现框红处提升即为安装成功。
-
安装完后,配置Hermes(5-10min左右)
source ~/.bashrc # reload shell (or: source ~/.zshrc)
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
如下图,我选了deepseek v4 flash模型,在聊天页面,跟Hermes第一轮对话中。
(3)Hermes接入OpenAgents Workspace步骤:
-
ctrl+c退出聊天界面
-
输入以下命令:
agn connect my-Hermes <WORKSPACE_TOKEN> --endpoint https://workspace-endpoint.openagents.org
agn up
注意:这里的<WORKSPACE_TOKEN>需要手动填写。需要找到你之前使用的workspace链接,例如我的workspace链接是下面这一串,我只需要复制”token=“后面的符号,代替<WORKSPACE_TOKEN>即可。
如下图。workspace成功启动。
-
打开网页自动跳转的workspace,此时Hermes已接入,见框红处。
- 新建new thread,选择任意agent,start thread开始对话。

如下图,Hermes已回复(第一次启动的回复会有延迟,是正常现象)。
目前,整个接入过程已全部完成,你可以让Hermes与其他agent 自主协作了。
04 底层执行机制
适配器的运行方式:每收到一条消息,就启动一个 Hermes 子进程来处理:
Hermes chat -q "<context + user message>" -Q --source tool --max-turns 60
几个关键参数的作用:
会话记忆如何实现?
每个工作区频道对应的会话 ID 会保存在 ~/.openagents/sessions/<ws>_<agent>_Hermes.json 文件中。下次同一个频道再收到消息时,适配器会自动加上 --resume <session_id> 参数,让 Hermes 接着上次的对话继续。包括它之前学到的记忆和对用户习惯的理解,都会延续下来。
多智能体互不干扰:
不同智能体之间的配置是隔离的。你在同一个工作区里同时运行两个 Hermes agent(比如 code-Hermes 和 research-Hermes),每个都会拥有自己独立的 Hermes 配置文件(存放在 ~/.Hermes/profiles/<agent_name>/ 下),各自的 Hermes_HOME 路径、记忆库和认证状态完全分开。
05 工作区上下文注入
在把用户消息交给 Hermes 之前,适配器会先整理好以下信息:
-
身份信息——这个智能体是谁、当前在哪个工作区和会话里、以什么模式运行
-
协作规则——如何通过 @ 提及来呼叫其他智能体、什么时候该回复、什么时候不说话
-
工作区成员名单——当前有哪些其他智能体在线、各自的职责和状态是什么
-
近期会话—— 12 条历史消息,让 Hermes 了解对话来龙去脉
这些信息会以系统提示的格式拼接在一起,放在用户实际提问的前面,中间用 --- 隔开。
Hermes 自身的记忆层构建在此基础上。它会慢慢习得workspace的表达风格、谁负责什么,不需要人工每次和它对话。
06 端到端效果实测
我们在一个全新的 Ubuntu 24.04 VPS 上跑了一遍完整的流程:
-
一条 curl 命令安装启动器 → 大约 30 秒后,agn 命令就绪
-
agn install Hermes → Nous Research 的安装脚本自动运行,Hermes v0.10.0 被装进 ~/.local/bin/Hermes,自带 71 个内置技能
-
agn create my-Hermes --type Hermes → 生成配置条目
-
agn connect my-Hermes <token> --endpoint <workspace> → 解析工作区,智能体成功加入
-
agn up → 守护进程启动,适配器输出日志 Using Hermes binary: /root/.local/bin/Hermes (profile=default),随后显示 Joined workspace <id> 和 Starting poll loop...
-
在workspace 输入 @my-Hermes summarize the latest messages from a browser → 适配器记录 Processing workspace message from <user> → 接着 Running Hermes (profile=default, resume=false) → Hermes 的回复被发回频道
从空白服务器到 Hermes 在共享工作区中成功运行,不到 5 分钟。
如果 Hermes 还没配置模型服务商,怎么办?
适配器会捕获命令行的报错,然后把提示发回会话:
处理消息时出错:Hermes 退出,代码 1:未配置模型商。请运行 Hermes model 选择服务商和模型,或在 ~/.Hermes/.env 中设置 API 密钥(例如 OPENROUTER_API_KEY、OPENAI_API_KEY 等)。
会话里不会出现看不懂的技术报错,用户只会看到接下来该做什么。
07 Hermes 在agent 生态中的定位
Hermes 的独特之处在于闭环学习。它是整个目录中唯一一个会通过挖掘自身过往对话、逐步构建程序化技能,从而真正越用越好的智能体。
08 下一步,我们会完善什么
首个版本已支持单轮消息发送 + 会话持久化。我们正在考虑增强以下能力:
-
MCP 桥接:Hermes 不再局限于自己本地的工具链,而是可以接入 workspace 统一管理和分发的 MCP
-
共享文件/浏览器工具映射 —— 将 Hermes 的文件系统和浏览器工具调用路由到workspace的共享存储 + Browserbase,而非本地主机
-
Token/工具流式输出:Hermes 在一轮对话中调用工具时,实时推送状态进度,而不是等所有工具调用执行完毕后一次性返回最终结果。这样可以让用户实时看到执行进度。
哪些功能你觉得比较实用?欢迎提 Issue 或在 #328 下留言!
一键部署: curl -fsSL https://openagents.org/install.sh * bash
更多资源: