Hermes Agent Cheatsheet

Hermes Agent

Nous Research 的自改进 agent。先装好、先聊通,再叠 gateway、Bot Mode、skills、cron。当前钉在 v0.23.1(patch;自 v0.23.0 起约 618 个 PR,完整 curated notes 留给 v0.24.0)。v0.23.0「The Hearth Release」仍是带完整说明的小版本,并收编、补全 0.22.1–0.22.7:gateway 自带 Webapp(默认关),本机一个 gateway 拥有全部会话,多机 Desktop,终端内联图片与 /rewind;插件可批量/自动更新(目录 1,050+、Verified),付费 MCP 标价,hermes curator lock。0.23.1 操作者先记住:11 月 9 日起线上 plugin-catalog.json 超过旧 2 MiB 上限,装插件会静默回退到发行自带目录;本版把上限提到 16 MiB。升级前先看「从 0.22 升到 0.23」:旧 browser_* 只剩 browser_exec;Desktop 需 macOS 13+ / 64 位 Windows(Electron 44);hermes mcp serve 改成 hermes mcp-serve。

v0.23.1 tag v0.23.1 更新于 2026-11-10
复制按钮会复制可直接贴进终端或 Hermes 会话的命令

最短记忆

Windows / macOS 优先 Desktop(0.23:macOS 13+、64 位 Windows);命令行装完再 setup。会话存在 ~/.hermes/state.db。0.22 起每台机器只跑一个 gateway 和一个桌面后端;0.23 起 CLI / TUI / Desktop / bot / cron 都挂到这个 gateway 上,同一会话只有一个队列与一份历史。新建 profile 不用重启,它的 bot 立刻上线;凭证、白名单、cron 与会话仍按 profile 隔离。浏览器工作区默认关:webapp.enabled 或 Desktop Web Access。

先装上

0.22 起 Desktop 是签名包,自带 Python 和 Node,自己更新,首次启动不再现场构建:Windows 用 MSIX(x64 / ARM64,需 Windows 11 22H2+,可走 Microsoft Store 或 App Installer),macOS 默认只出 Apple Silicon 版。0.23(Electron 44):Desktop 需要 macOS 13+ 与 64 位 Windows,不再支持 macOS 11/12 或 32 位 Windows。纯命令行:Linux/macOS/WSL 用 install.sh,Windows 原生用 install.ps1;新安装默认跟最新稳定版。安装器会先校验 uv 和 Git 的哈希,再交给包管理器 hermes pm,日志在 logs/install.log。

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

一次配好模型和工具

推荐 Nous Portal。OpenRouter 可用 hermes auth add openrouter --type oauth(PKCE 代发密钥)。会话里也可用 /login 补登。0.22:全新桌面安装会先开一段引导聊天(名字、配色、布局、要连的应用和插件),跑在免费试用模型 nous/welcome 上(每个系统用户一次),不用 key;Skip setup 跳过,Settings → Run onboarding again 重来。CLI / TUI / gateway 没有这个免费模型。

hermes setup --portal

先聊通一轮

经典 CLI 用 hermes,推荐 TUI 用 hermes --tui。模型至少 64K 上下文。每个模型 picker 都可设 reasoning effort(minimal…ultra / Disable / Skip),0.22 也可一步写成 /model X --reasoning high。0.22.3:经典 CLI 换成字形记录、输入框下方的状态行和两行页眉;MCP 工具进度会以实时进度流出来。0.22.5:很长的 Claude DirectSDK 回复不再被停顿计时器截断。0.23:粘贴或截图会在终端内联显示(kitty / Ghostty 等);空提示下 Esc Esc 或 /rewind 可回退改发或 fork;TUI 可在回合进行中 /new(旧回合后台继续)。要旧版式:display.cli_layout: classic。

hermes --tui

坏了先诊断

顺序:hermes doctor →(会话库)hermes sessions recover --inspect-only → hermes model。gateway 在跑时不要 doctor --fix;跨 VM 文件系统上 WAL 会被拒绝。0.22 起托管的依赖环境另用 hermes pm doctor 查、hermes pm repair 修。

hermes doctor

按场景查

先找当前要做的事,再复制对应命令。v0.23.0「The Hearth Release」是带完整说明的小版本,收编并补全 0.22.1–0.22.7;v0.23.1 再滚进约 618 个 PR,完整 curated notes 留给 v0.24.0;v0.22.0「Threshold」仍是上一大版本(收编 0.21.1–0.21.7)。下面把 0.22.7→0.23.1 操作者会摸到的变化折进各张卡片,并保留仍准确的 0.22 / 0.23.0 线卡片;不逐条抄发布说明,也不臆造留给 v0.24.0 的清单。

在 Linux / macOS / WSL 安装

官方一键脚本。装完 source ~/.bashrc 或对应 shell rc。0.22 起 musl Linux(Alpine、Void)也能装,托管安装的运行时是 Python 3.14(由 hermes pm 自动装)。已有安装用 hermes update,默认跟最新稳定版。Docker / Cloud 镜像跟 nousresearch/hermes-agent:stable(tag 形如 v0.23.1);0.22 起基础镜像钉在 Debian 13 并带完整 Chromium,stable / latest 只在正式发布时移动。

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

换模型或加 provider

终端跑 hermes model / hermes auth 才能加 provider。保存模型后会跟一步 reasoning effort。OpenRouter:hermes auth add openrouter --type oauth。会话里 /model 只切已配置模型。0.22:picker 可给常用模型加星,直接显示订阅余量(如「17% left · resets 3:00 PM」)和限流何时解除;provider 抽风(503 / 529 / 超时)时会按 agent.auto_recovery_cycles(默认 5)可见地等待重试。0.22.5:按用量窗口计费的方案会显示计划仪表和限额卡片,撞限后可以切模型恢复。0.22.6:会话里 /model reset 清掉本会话的模型钉,回到 config.yaml 默认,不丢历史。0.22.7 / 0.23:Daybreak(默认关,agent.daybreak)只对账号 Codex 目录批准的 ChatGPT 订阅模型打开 Trusted Access。0.23:未选模型时静默默认改为 GLM-5.3;目录再进 GPT-6.1 Terra、DeepSeek V4.1 Flash 1017、Solstice 上的 Gemini 4 Argon 等;GitHub Copilot 迁到 Labs 插件 github-copilot(用过的 profile 会自动装)。

modelreasoning
hermes model

接到 Telegram / Discord / Slack

先保证 CLI 能聊。WSL / Docker / Termux 用 hermes gateway run,不要用 start。未授权私信可设 unauthorized_dm_behavior: decline(礼貌拒一次),也支持 pair / ignore。0.22:聊天不再按空闲 / 每日计时自动重置(session_reset 的 idle / daily 模式退役,还设着会打警告),只有 /new、/reset 开新会话;Discord / Telegram / Slack / Matrix 上 /branch 开一个兄弟线程(--here 保留旧行为);Email 平台现在必须钉 authserv_id,没设之前收到的邮件会被丢弃。0.22.3:Telegram 私聊的话题转移要手动开。0.22.4:Dashboard 里 WhatsApp 登出后可以安全地重新配对。0.22.7 / 0.23:Team Gateway 上的 Telegram 通过把账号链到共享 bot 来接入;Slack 可选用 thread_followup_silence,压住未 @ 的线程跟帖。0.23:bot 互 ping 有 max_hops(默认 4);Signal / Weixin / BlueBubbles / QQ / Yuanbao / WhatsApp Cloud 等消息适配器改成捆绑平台插件(对用户无感)。

gatewaydecline
hermes gateway setup

不要 key、不出网:一键本地模型

0.22:Hermes 自动安装并维护 llama.cpp,按硬件选 CPU / CUDA / Metal / Vulkan / ROCm 引擎,按你的显存和内存给目录里每个模型打分,只推荐能完整放进 GPU 的版本;下载可暂停续传,服务随 Hermes 启停,引擎更新一键完成。目录含 Qwen3.8 27B、Qwen3.8 Flash Next、Qwen3.6 35B-A3B、DeepSeek V4 Flash,也能拉任意 Hugging Face GGUF。桌面端在 Settings → Providers → Local Models。LM Studio、Ollama 和自己起的 llama.cpp server 也能在 /model 里选。0.22.2:本地长回合在笔记本上不再因睡眠或读长 prompt 而超时中断,状态栏会显示读 prompt 的进度。0.22.3:本地运行时加上 Nemotron 3.5 Bolt,以及单槽 DFlash 草稿。

localllama.cpp
hermes model

Connectors:让它在你的应用里干活

0.22:通过 Nous tool gateway 直接操作 Linear、Notion 等托管应用:开口要一个应用,在浏览器里登录一次,同一回合就能用上它的工具。起步不需要 Nous 账号。0.22.5 起每次登录都是普通的设备登录:免费身份会交接到你的账号,结果会显示是谁登入;Connectors 改为提供登录,不再直接开一个访客。之后仍可用 hermes auth upgrade 或会话里的 /login 升到完整账号,已连的应用保留。桌面新的 Connectors 页把托管应用和你的 MCP server 放在同一列表(取代原 MCP 标签);同一应用可连多个具名账号(如 work / home),用 /connectors 或 hermes connectors 管理。不想要:tools.connectors.enabled: false;关掉免费身份:nous.guest: false。Desktop 想少打扰仍可切 Simple 模式。0.22.4:输入框上方那些主要催你去配 MCP 的建议胶囊去掉了;审批模式小标跟着当前 profile 的模式走。

connectorssimple
hermes connectors

state.db 报错 / 会话列表挂了

先停 gateway,再 doctor;结构损坏用 recover(不改源库)。跨 VM / 共享盘要把 WAL 换成 rollback journal 时用 hermes sessions set-journal-mode delete(先停所有占用进程)。0.22:锁超时会点名持有锁的进程,数据库忙不再直接杀掉回合;profile 串了用 hermes sessions repair-profiles。0.22.0–0.22.2 里 sessions.auto_prune 默认开启,启动时删除 90 天未活跃的已结束会话(置顶和打开的不动)。0.22.3 起改回默认关闭,磁盘空间低时会一次性询问要不要打开。0.22.2 的已知问题在 0.22.3–0.22.7 与 v0.23.0 / v0.23.1 发布说明里没有宣布修复:在 0.22.1 gateway 下跑过的会话删不掉。

state.dbrecover
hermes sessions recover --source ~/.hermes/state.db --inspect-only

它好像忘了我刚说的

~/.hermes/memories/USER.md / MEMORY.md 在会话开始冻结进 system prompt。存盘立刻生效,注入要等 /new。跨会话回忆靠 FTS session_search(支持 after/before 时间窗)。0.22:Honcho、Supermemory、Hindsight、Mem0、OpenViking、Holographic 等外部 memory provider 移到插件目录,升级或首次启动时自动迁移、数据保留;ByteRover、RetainDB 仍内置。手写格式的 MEMORY.md / USER.md 也能写入,被拒时会说明要改什么。

memorysnapshot
/new

Bot Mode / 让 bot 互聊

Desktop 内置 Bot Mode。0.22 起一台机器一个 gateway 服务所有 profile:hermes update 会把旧的每 profile gateway 自动合并(无冲突时),也可手动 hermes gateway migrate --multiplex;只停一个 profile 用 hermes -p X gateway stop;webhook 平台按 /p/<profile>/ 分路径。Bot Screen:Linux gateway 上的 bot 可以有自己的桌面,Desktop 实时串流,碰到登录、2FA 或验证码时你接管、做完再交还(默认关闭,需要主机装包)。临时豁免仍是 gateway.standalone: true。跨机 bot DM 用 hermes peer。0.22.5–0.22.7:群聊显示谁在干活;可改名/解散/@/粘贴;Lead 或自动路由;房间 purpose 与共享笔记;cron 可发进群聊。0.23:CLI / TUI / Desktop / bot / cron 都挂同一 gateway,会话只有一个写者;Desktop 可同时连本机与 SSH / URL gateway,终端标签跟宿主走,群聊可混不同机器上的 bot;Webapp(默认关)用 hermes webapp 或 Web Access 打开同一工作区,Docker / Nix 也带上。

bot-modestandalone
hermes peer list

装 skill / plugin / MCP

已安装 skill 会变成 /skill-name。要用同一批 skill 开每个新会话:在 config.yaml 设 skills.auto_load。插件走 hermes plugins。0.23:目录约 1,050+ 条(自约 600 起涨),新增 Verified 层(厂商自建);hermes plugins update 无名字时一次更新全部,可选自动更新 plugins.auto_apply(默认关;会话里 /plugins update、/plugins auto-update);会破坏环境的更新会扣住不应用。内置 skill 58→44,Word / PowerPoint / Excel 合并为 microsoft-office(旧副本仍在磁盘直到你删);手改过的 skill 用 hermes curator lock <name> 锁住,YOLO 下 agent 也不能改。Camofox、mcp-serve、agent-importers、Singularity 等从核心挪进官方插件(用过的会自动装);让 Hermes 当 MCP server 现拼写为 hermes mcp-serve(旧 hermes mcp serve 只提示新拼写,不会替你改客户端)。新官方插件含 Meshy、ElevenLabs Music / SFX、X Chat、REA、bubblewrap、advanced-delegation 等。付费 MCP 工具可声明单价与每会话消费上限,审批会显示价格与累计,超限先问(含 YOLO)。MCP 同时连接数用 mcp.discovery_concurrency(默认 4);OAuth 过期 hermes mcp login <server>,无头加 --flow device。requires_hermes 在装/更新时强制检查。0.23.1:客户端接受的线上 plugin-catalog.json 上限从 2 MiB 提到 16 MiB;超限时每次安装都会静默回退到发行自带目录(装不到更新后的插件、钉在发行 pin、也漏掉更新的 removed)。停留在 v0.23.0 或更旧的安装会继续回退,直到更新。

auto_loadmcp
hermes config set skills.auto_load '["github-pr-workflow"]'

接着上次聊

-c 恢复最近会话;按标题/ID 用 --resume。重要会话可 hermes sessions pin(开了自动清理时,置顶的不会被删)。脚本续跑:hermes -z --resume …。0.22:之前的推理默认在所有能读它的 provider 上回放,跨恢复、分支和压缩都保留,长任务不丢思路。Desktop 还能导入别的编程 agent 的记录接着做;0.22.4 起 hermes import-agent 也支持 Cursor。0.22.5:同一命令加上 OpenClaw 迁移;聊天的工作目录没了会给出明确提示。0.22.6 / 0.23:hermes migrate(及 setup)还可迁 Grok Bot / OpenBot;也可检测本机其他 agent 后导入。0.23:改过 SOUL.md / skills / 上下文文件后,不必 /new——hermes sessions refresh-prompts 让继续中的会话下一回合重建 system prompt(保留历史,付一次缓存 miss);经典 CLI / TUI 用 /rewind 回退改发或 fork。

sessionpin
hermes --continue

定时任务(会记住上次)

cron 会加载持久记忆;可开 continuity、每任务 notepad、monitor 模式;时区按 IANA,跨 DST 不漂。0.22:没钉模型的任务在触发时跟随你当前的主模型(要锁定就 pinned);没送达模型的触发(如机器刚醒)会在 5 / 15 / 30 分钟后重跑;失败告警每次事故只发一条;--paused 建任务但先不启用;agent 可输出 [CRON_FAILURE] 主动判失败。会话内心跳仍用 /heartbeat。0.22.6:hermes cron cancel;每任务可设漏跑策略;Desktop cron 编辑器有 Stop。0.22.7:定时任务也可以发到 Desktop 群聊。

cronDST
hermes cron

把终端关进沙箱

默认 local。另有 Docker / SSH / Singularity / Modal / Daytona / Vercel Sandbox。Docker 可再配 hermes egress 注入凭据。0.22:用 Docker / SSH / Singularity 后端时,bot 的屏幕、computer use 和浏览器都跑在沙箱里,不碰宿主;新默认镜像 hermes-sandbox:desktop(已有沙箱保留)。前台命令超过 600 秒会自动转成后台任务。state.db 不要放在跨 VM 共享盘上开 WAL。0.22.4:插件目录另有 Linux 上的 bubblewrap(bwrap)终端后端,以及 Singularity/Apptainer。0.22.5 / 0.23:Singularity 后端从核心挪进插件。0.23:旧内置浏览器工具已删,自动化只走 browser_exec(用过 Camofox 的会自动装 camofox 插件);自己的 prompt / skill / toolset 若仍写 browser_navigate 等,改成 browser_exec。

sandboxdocker
hermes config set terminal.backend docker

并行改仓库 / 管子代理

启动 hermes -w 或会话中 /worktree new。0.22:运行中的子代理显示在输入框上方(CLI 按 F6、TUI 按 Ctrl+T、Desktop 直接可见),能看每个子任务、耗时和实时记录,并有 Steer / Stop;/stop 也能停后台子代理并取回已完成的部分。delegate_task 可把截图和设计稿传给支持视觉的子代理;delegation.fallback_providers 给子代理单独的 fallback 链。0.22.3:Desktop 有引导式的子代理模型和 provider 选择器,也可以改写或 steer 一条已经排队的提示。0.22.5 / 0.23:委托可插拔;装官方 advanced-delegation 可按模型映射或 profile 路由。会话里 /delegation 的选择留给下一次会话,加 --now 立刻生效。

worktreesteer
hermes -w

脚本里只要最终答案

hermes -z 只把最终回复打到 stdout。程序要吃进度事件用 hermes chat -q "…" --format stream-json(隐含 quiet;stdout 每行一个 JSON;不可与 --tui 并用)。可加 --usage-file。0.22:hermes -z 失败时返回非零退出码;只查配额用 hermes usage --json(不开会话)。

stream-jsononeshot
hermes chat -q "Summarize this repo" --format stream-json

先看状态摘要

hermes status 摘要优先,0.22 压到一屏。日常用 --short 扫一眼;要全部细节再加 --full。gateway 拒绝启动时,hermes gateway status 会说明是哪条启动保护挡住了。

statusdoctor
hermes status --short

语音:边说边转写 / 全双工 · 插件隔离

0.22 补全了 0.21.6 只点了名的几项(都要手动开):stt.streaming 在 CLI、TUI、Desktop 里边说边出字,长录音在所有云 provider 上都能转写;voice.voice_chat_mode: gpt-live 给 Desktop 全双工语音对话;auxiliary.voice_chat 让语音轮次走更快的模型。第三方插件可用 plugins.isolation: host 跑在每个 profile 自己的进程里,只拿到该 profile 的密钥;每个插件在 Settings ▸ Plugins 有自己的设置页。

sttplugins
hermes config set stt.streaming true

源码安装选更新频道

0.22 起每个稳定版发布前都要过源码 CI、Docker、Nix、签名桌面构建,以及各系统的安装 / 升级测试;官方仓库的源码安装默认从一个 release 走到下一个,不再追 main 上的每个提交。要继续追每个提交:hermes update --set-channel main,或 Desktop Settings ▸ About 里的频道开关(Stable / Every commit)。回到更旧的版本会标成 rollback,必须你确认;重跑安装器会保持你选的频道。已经比最新 release 新的安装停在原地等下一个。fork 仍跟 main。更新检查改成每天一次 GitHub API 调用(原为每 30 分钟 git fetch)。签名包(MSIX / Store / macOS)里 hermes update 会指向对应的系统更新器。

channelstable
hermes update --set-channel main

更新到最新版

--check / --plan 只预览。--backup 拉取前给 HERMES_HOME 快照。Cloud / Docker:拉 nousresearch/hermes-agent:stable(或 :latest);镜像安装会拒绝原地 hermes update;Microsoft Store 版走 Store 更新。0.22:更新会先建一套新的依赖环境,自检通过才切换;旧环境用 hermes pm gc 回收。0.22.3–0.22.7 的安装器桌面(.exe / .dmg)曾无新包;0.23.0 是带完整说明的捆绑发布(Electron 44)。0.23.1 进 CLI、Store、Docker / Cloud;安装器桌面(.exe / .dmg)本版没有新包,等下一次捆绑发布。更新会先问要不要 stash 本地改动;Desktop 更新框显示阶段与真实 release notes,失败带输出与一键诊断上传。拒绝的稳定版会被压住、不再推荐。防火墙后更新检查失败时,先 gh auth login 或设置 GITHUB_TOKEN。

update
hermes update

从 0.21 升到 0.22 先看这几条

托管安装的运行时变成 Python 3.14(包管理器自动装;KittenTTS 在 3.14 上不可用)。Windows 桌面只剩 MSIX、需要 Windows 11 22H2 或更新,旧 NSIS / MSI 安装器取消;macOS 默认只出 Apple Silicon 版。每 profile 一个的 gateway 会被合并成一台机器一个。消息平台不再按空闲 / 每日自动重置会话。0.22.0–0.22.2 里 sessions.auto_prune 默认开(90 天未活跃的已结束会话会被删);0.22.3 起改回默认关闭,磁盘低时才一次性问你要不要开。从 0.22.2 升上来又想继续自动清理的,显式设 true。外部 memory provider 和 Home Assistant、Spotify、Langfuse 改成插件目录里的插件,自动迁移。工具改名 todo → todo_list、cronjob → cronjob_manage、process → process_manage(旧名仍可用)。hermes sync 与内置 tirith 已移除;插件旧的兼容导入层也删了。

upgrade0.22
hermes config set sessions.auto_prune true

从 0.22 升到 0.23 先看这几条

旧内置浏览器工具已移除:自动化只走 browser_exec;agent-browser 与十个 browser_* 工具没了;用过 Camofox 的会自动装插件。自己的 prompt / skill / toolset 列表若还写旧名,改成 browser_exec。Desktop 升到 Electron 44:需要 macOS 13+ 与 64 位 Windows(macOS 11/12、32 位 Windows 不再支持)。让 Hermes 当 MCP server:命令改成 hermes mcp-serve(插件),客户端参数不会自动改写。Word / PowerPoint / Excel skill 合并为 microsoft-office;旧副本留在磁盘直到你删。Webapp 默认关闭,开 webapp.enabled 或 Desktop Web Access 后才对外服务。

upgrade0.23
hermes config set webapp.enabled true

0.23.0「The Hearth Release」操作者摘要

自 v0.22.0 起约 1,950 个 PR 的完整说明,并收编 0.22.1–0.22.7。本机一个 gateway 拥有全部会话;CLI / TUI / Desktop / 编辑器 / bot / cron 都当客户端,避免双写或丢消息。Webapp 把同一桌面工作区开在浏览器(默认关)。Desktop 同时连多台 gateway;终端内联图片;/rewind / Esc Esc 回退改发或 fork。插件:批量更新、可选 plugins.auto_apply、目录 1,050+、Verified 层;付费 MCP 有标价与会话消费上限。内置 skill 44 个,Office 合并,hermes curator lock 锁手改 skill。未选模型默认 GLM-5.3;可装 advanced-delegation 后用 /delegation 选路由。

0.23.0Hearth
/rewind

0.23.1:又一个说明延后的 patch

0.23.1 把 0.23.0 之后约 618 个 PR 滚进稳定版(发布说明计量点 3b42157),完整 curated notes 留给 v0.24.0;本页只收说明里点了名的项。插件目录:11 月 9 日站点部署后,线上 plugin-catalog.json 超过客户端旧 2 MiB 上限,每次安装都静默回退到发行自带目录——装不到更新后的插件、钉在发行 pin、也漏掉更新的 removed;本版把上限提到 16 MiB。停留在 v0.23.0 或更旧的安装会继续回退,直到更新。进 CLI、Microsoft Store、Docker / Hermes Cloud;安装器桌面(.exe / .dmg)本版没有新包。

0.23.10.24.0
hermes update

0.22.3 / 0.22.4:大窗口说明延后,小修复已落地

0.22.3 把 0.22.2 之后约 620 个 PR 滚进稳定版,完整 curated notes 现已收进 v0.23.0。发布说明点了名、操作者会碰到的:sessions.auto_prune 改回手动开启(磁盘低时一次性询问);经典 CLI 换版式;hermes plugins update 与 Desktop 上 git 插件的 Update;MCP 进度实时显示;/loop 倒计时;Telegram 私聊话题转移要手动开;本地运行时的 Nemotron 3.5 Bolt 与单槽 DFlash。0.22.4:桌面建议胶囊去掉;零依赖插件跳过空确认;Dashboard 里 WhatsApp 可重新配对;审批模式小标跟当前 profile。安装器桌面(.exe / .dmg)这两版没有新包。0.22.2「删不掉 0.22.1 会话」没有在后续说明里宣布修复。

0.22.40.23.0
hermes plugins update

0.22.5:又一个说明延后的 patch

0.22.5 把 0.22.4 之后约 81 个 PR 滚进稳定版(发布说明计量点 bf0203a),完整 curated notes 现已收进 v0.23.0;本页仍只收当时说明点了名的项。登录:每次都是普通的设备登录;免费身份会交接到你的账号;结果会显示是谁登入;Connectors 改为提供登录,不再直接开一个访客。用量窗口方案有计划仪表、限额卡片,以及撞限后切模型的恢复。子代理可按模型映射或 profile 路由到可插拔的委托后端,并能按会话切换。插件的 slash 命令可以让你选一项。hermes import-agent 加上 OpenClaw 迁移;hermes mcp serve 和 Singularity 后端从核心挪进插件;setup 发现另一套 agent 时会提供导入器。Desktop:侧栏可拖拽固定,插件可一键安装并带层级徽章;群聊会再显示是哪个 bot 在干活。聊天的工作目录没了会有明确提示。很长的 Claude DirectSDK 回复不再被停顿计时器截断。hermes update:拒绝的稳定版会压住、不再拿出来推荐;Windows 在 Python 重新钉版本后不再卡在旧启动器;.git 损坏后会把暂停的 gateway 拉回来。另有 Electron 44、Pillow 13 和一批依赖安全更新,以及实验性的 webhook 模式 MCP 事件客户端。安装器桌面(.exe / .dmg)本版没有新包。0.22.2「删不掉 0.22.1 会话」这次说明里也没有宣布修复。

0.22.50.23.0
hermes import-agent

0.22.6:又一个说明延后的大窗口 patch

0.22.6 把 0.22.5 之后约 776 个 PR 滚进稳定版(发布说明计量点 f0d9488),完整 curated notes 现已收进 v0.23.0;本页仍只收当时说明点了名的项。浏览器工作区:gateway 自己挂 Webapp,用 hermes webapp 打开;Desktop 有 Web Access 面板,插件也可在浏览器标签页加载。/model reset 清掉本会话的模型钉,不丢历史。Desktop Capabilities 可按 skill 锁住自动写入。可选提前压缩 compression.prepare_ahead。hermes cron cancel,每任务有漏跑策略,Desktop cron 编辑器有 Stop。/delegation 的选择会留给下一次会话。hermes migrate(及 setup)可迁 Grok Bot / OpenBot;vault 密钥可选存系统钥匙串;目录里 requires_hermes 在装/更新插件时强制检查。包管理器下载可续传。另有 Desktop 群聊改名/解散/@/粘贴附件、侧栏按 profile 分段、Telegram 视频笔记、Slack 线程里的 emoji 反应、agent 自选 ElevenLabs 音色,以及可拦推理前回合的 pre_llm_call hook。安装器桌面(.exe / .dmg)本版没有新包。0.22.2「删不掉 0.22.1 会话」这次说明里也没有宣布修复。

0.22.60.23.0
hermes webapp

0.22.7:又一个说明延后的 patch

0.22.7 把 0.22.6 之后约 174 个 PR 滚进稳定版(发布说明计量点 b200f5b),完整 curated notes 现已收进 v0.23.0;本页仍只收当时说明点了名的项。Desktop 群聊:可选 Lead 路由(房间头 Lead 徽章);cron 可发到群聊;房间有 purpose 与共享笔记;群房单列并显示各成员实时状态。置顶的 Kanban 看板可当快速切换标签。$$TeX$$ 图注与 mermaid 经 Pele 渲染。Web Access 标出 Start 当前步骤并跑计时;Desktop 更新失败框会带输出与报告链接。Team Gateway 上 Telegram 靠链到共享 bot 接入;Slack 可选 thread_followup_silence 压未 @ 的线程跟帖。Daybreak 开关让目录里的 ChatGPT 订阅模型出现在 picker;插件目录再进一批新条目。安装器桌面(.exe / .dmg)本版没有新包。0.22.2「删不掉 0.22.1 会话」这次说明里也没有宣布修复。

0.22.70.23.0
hermes update

密钥与受保护写入

0.22:浏览器 agent 能用 1Password、Bitwarden 或 Hermes 自带的加密 vault 登录网站,模型看不到密码;没存的会弹遮罩输入框让你存,一次性验证码直接填、不进对话,结账时填卡和地址要你确认。hermes config get 默认遮住密钥(--raw 才显示),config set 会拒绝拼错的路径。写 AGENTS.md / skills / memory 常需审批;可用 hermes approvals 挖白名单;上传凭据、命令里夹隐形 Unicode 也会走审批。0.22.6 / 0.23:vault 密钥可选存系统钥匙串(vault.key_storage: keychain);Verified 密码管理器插件可经 browser_vault 填登录,且只能碰自己的条目。

secretsapprovals
hermes secrets

让它围着一个目标继续干

Hermes 对 Ralph loop 的实现。辅助模型判断是否完成;真人消息会打断循环。CLI/TUI 的 live dock 显示当前 /goal 与排队提示。0.22:/goal 在 CLI、Desktop 和消息平台上行为一致,judge 会等子代理跑完;/goal pause for now 不再覆盖目标;Desktop 输入框上方有 Goal / Loop / Heartbeat 卡片,可暂停、恢复、停止。0.22.3:CLI 和 TUI 里 /loop 有一行实时倒计时。

goaldock
/goal 把测试修到全绿

常用流程

把几条命令串起来,覆盖真实使用。

Windows 从零到能聊

桌面:装 MSIX(Windows 11 22H2+),首次启动跟着引导聊天走,用免费试用模型,不用 key。纯命令行:先装,再 Portal,再用 TUI 验证一轮真实对话。

install.ps1→hermes setup --portal→hermes --tui

日常接着干

回到最近会话。换目录时加 --in。0.22 起恢复、分支、压缩后都会回放之前的推理。会话中 Ctrl+P / /palette 找命令;Ctrl+C 只清草稿、不杀当前回合;排队的提示用 /queue 编辑。0.22.3 起经典 CLI 换成字形记录和输入框下的状态行;排队提示在 Desktop 里也能改。0.22.5:聊天的工作目录没了会给出明确提示。0.23:空提示 Esc Esc 或 /rewind 回退;TUI 回合中也可 /new。

hermes --tui --continue

做成常驻 bot

CLI 通了再接 messenger。WSL 用 foreground run。

hermes→hermes gateway setup→hermes gateway run

远程 Desktop 总被刷掉登录

刷新 token 合并(0.21.3)已消掉醒来连刷的误踢;0.21.6 加固了 dashboard 登录。0.22 起 Desktop 挂到本机唯一的后端,服务所有 profile;dashboard 支持反向代理子路径和密码登录。0.22.1 里 Microsoft Store 版可能卡在「Connecting」,0.22.2 已修。Cloud 镜像跟 stable tag。

hermes update→重启 Desktop / dashboard→再连远程看板

源码安装要继续追 main

官方仓库的 hermes update 默认只到最新的测试过的稳定版。已经比最新 tag 新的安装会停在原地;切回 stable 后再往旧版本走会标成 rollback 并要你确认。0.22.5:如果它拒绝某个稳定版,会把那个版本压住、不再拿出来推荐。桌面源码安装也可在 Settings ▸ About 切换。防火墙后更新失败时,先 gh auth login 或设置 GITHUB_TOKEN。

hermes update --set-channel main→hermes update

本地模型从零跑起来

0.22:不要账号、不要 key。Hermes 会装好 llama.cpp,按你的硬件推荐能完整放进 GPU 的模型,下载完自动起服务。

hermes model→Local models→选推荐模型→/model 切过去

第一次让它操作 Linear / Notion

0.22:直接在会话里说要用哪个应用,按设置卡片在浏览器里登录一次,同一回合就能用。要多个账号就再连一个并起名。

/connectors→浏览器登录→同一回合开干

脚本消费结构化进度

0.21.4+:不要刮终端。stdout 是 JSONL(system/text/tool_use/tool_result/result);诊断与 session_id 在 stderr。

hermes chat -q "…"→--format stream-json→读 result.exit_code

会话库坏了 / 要换 journal

先停 gateway,再 doctor 区分结构损坏 vs FTS。recover 只写到新库。共享盘要关 WAL:停占用进程后 sessions set-journal-mode delete,并同步 database.journal_mode。

hermes gateway stop→hermes doctor→sessions recover --inspect-only→recover --output …

感觉它变笨了

先确认不是模型切错、上下文爆了、或记忆快照过期。

hermes doctor→/status→/context→hermes model

跨机让两个 bot 交接

对端开 API server,本机注册 peer,再 DM 到对方 Bot Chat。

hermes peer add …→hermes peer dm name "…"

把这次流程沉淀成 skill

不必等自动回顾。会话里立刻跑 refine;0.22 起学到的经验和纠正会写进这项任务对应的 skill,会话中新加的 skill 下一条消息就生效。要每次新会话都带上,写入 skills.auto_load。MCP 过期先 hermes mcp login。

/refine …→skills.auto_load→/new

这些文件各管什么

搞混 SOUL / USER / MEMORY / AGENTS / state.db,是“它忘了”和“会话丢了”的最常见原因。

文件 装什么 谁写
SOUL.md agent 是谁:人格、语气、风格禁忌。全局 ~/.hermes/SOUL.md。 你写。会话开始注入;改后需新会话。
memories/USER.md 你是谁:名字、角色、偏好。路径 ~/.hermes/memories/USER.md。 agent 用 memory 工具写。会话开始冻结快照。
memories/MEMORY.md 它学到的环境事实、项目约定、工具坑。 agent 写。同样会话开始冻结;跨会话细节靠 session_search。0.22 起手写格式也能被接受,写给外部 provider 前会先清掉密钥。
.hermes.md / AGENTS.md 这个项目要什么。优先级:.hermes.md → AGENTS.md → CLAUDE.md → .cursorrules,只加载一种。 你写。v0.21 起对 instruction/skills/memory 写操作常需审批。0.22:/context 会逐个显示每个指令文件是已加载、被截断还是被遮蔽。
state.db 会话元数据 + 全文消息 + FTS5。默认 ~/.hermes/state.db(WAL)。每 profile 隔离。写者共享句柄;跨 VM 盘用 sessions set-journal-mode 切 DELETE,勿直接 cp 拆开 -wal/-shm。0.22.0–0.22.2 默认自动清理 90 天未活跃的已结束会话;0.22.3 起 sessions.auto_prune 改回手动开启,磁盘低时一次性询问。只有可回收空间达 25% 才 VACUUM。 runtime 写。损坏时用 doctor / sessions recover|repair。
shared-state.db 托管房间等跨 profile 共享状态。v0.21.2 起不再每 5 秒写进根 state.db,避免第二写者撕锁。 gateway / Bot Mode 写。
mcp-tokens/*.json MCP OAuth 令牌缓存(0o600)。refresh 绑定签发 issuer;issuer 变了会丢 refresh 并要求重授权。 hermes mcp login / Desktop Authorize。
config.yaml / .env 非密钥配置 vs 密钥。含 agent.reasoning_effort、skills.auto_load、mcp.discovery_concurrency、gateway.standalone、unauthorized_dm_behavior,0.22 新增 sessions.auto_prune(0.22.3 起默认关闭)、tools.connectors.enabled、agent.auto_recovery_cycles、agent.turn_liveness.timeout_s。0.23 常用:webapp.enabled(默认关)、plugins.auto_apply、agent.daybreak、vault.key_storage、compression.prepare_ahead。用 hermes config set 自动分流;config.yaml 坏了会回退到上一份好的。 你,或 setup / model / auth 向导。

CLI 索引

在系统终端运行,不在 Hermes 会话里。权威来源是 官方 CLI Commands。

命令 什么时候用 备注
hermes / hermes --tui 开始聊天。TUI 是推荐界面。 --cli 强制经典 REPL;Ctrl+P 命令面板。0.22.3:经典 CLI 为字形记录、输入框下状态行、两行页眉。0.23:内联图片;/rewind / Esc Esc;挂到本机 gateway;旧版式 display.cli_layout: classic。
hermes setup --portal 最快路径:Nous 登录 + Tool Gateway。 也有 Full Setup 和 Blank Slate。
hermes model · hermes auth 加 provider、OAuth、改默认模型;管凭据池。模型保存后跟 reasoning effort 步。 OpenRouter:auth add openrouter --type oauth。0.22:hermes model 里有 Local models;hermes auth upgrade 把免费身份升级成完整 Nous 账号。0.22.5:登录一律是设备登录,免费身份交接到账号,结果会显示登入的是谁。不要和会话里的 /model、/login 搞混。0.22.6:会话里 /model reset 只清会话钉。
hermes -c / --resume 恢复最近或指定会话。 --in dir 先切目录再查会话。0.22 起推理默认跨恢复、分支和压缩回放。0.22.5:工作目录没了会给出明确提示。
hermes chat -q "…" · hermes -z 提问。TTY 上 -q 默认种交互会话;纯一次性用 -z / --oneshot;机器可读进度加 --format stream-json。 stream-json 隐含 quiet,不可与 --tui 并用。0.22:-z 失败返回非零退出码。
hermes gateway setup|run|status 配置并运行 messaging gateway;0.22 起一台机器一个 gateway 服务所有 profile,单 profile 用 hermes -p X gateway stop|start。 WSL 用 run。status 会说明启动保护为什么拒绝;手动合并用 gateway migrate --multiplex;临时独立网关 gateway.standalone: true(将移除)。0.22.2 修了重启后误判 PID 不启动。
hermes sessions … list / export / prune / pin / optimize / repair / recover / set-journal-mode,0.22 加 repair-profiles、repair-prompts;0.23 加 refresh-prompts。 recover 离线重建到新文件;改 journal 前先停占用进程。健康拓扑不应误报多写者。
hermes peer add|dm|run|status 注册对端 gateway,向对方 Bot Chat 发 DM / 长任务。 跨机 bot-to-bot 传输层。
hermes plugins 装/启停插件、memory provider、model provider、context engine。0.23:目录约 1,050+,含 Verified 层;无名字的 hermes plugins update 一次更新全部;可选 plugins.auto_apply。0.23.1:线上目录上限 2→16 MiB,否则静默回退到发行自带目录。 无子命令进入交互屏;search / pack install。装/更新强制 requires_hermes;会破坏环境的更新会扣住。会话里 /plugins update、/plugins auto-update。
hermes tools 按平台开关 toolset。 单次会话也可用 --toolsets。
hermes skills browse|install 浏览 Skills Hub、安装 skill;会话常驻用 skills.auto_load。 0.23:内置 skill 44 个;Office 合并为 microsoft-office。安装前会跑安全扫描;缺/禁用的 auto_load 名会跳过并打警告。
hermes curator … 后台整理 agent 自建 skill;0.23:lock <name> 禁止 agent 改你手改过的 skill(含 YOLO)。 另有 status / run / pin / archive / restore 等;捆绑与 Hub skill 不会被 curator 动。
hermes cron 持久定时任务;含 memory / continuity / monitor / notepad。 会话内心跳用 /heartbeat;时区按 IANA;cron doctor 查舰队健康。0.22.6:cron cancel;每任务可设漏跑策略。0.22.7:也可发到 Desktop 群聊。
hermes doctor [--fix] 配置、依赖、会话库健康。 gateway 在跑时勿 --fix;会区分结构损坏 vs FTS。
hermes config set … 改配置或密钥。 自动写入 yaml 或 .env。
hermes update 按更新频道拉代码并重装依赖。 官方源码安装默认跟最新稳定版;追每个提交用 --set-channel main。--check / --plan 预览,--backup 先快照;镜像安装拒绝原地更新。0.22 起新环境自检通过才切换。0.23.0:Electron 44 捆绑桌面;更新前提问 stash;Desktop 失败框带输出与诊断上传。0.23.1:进 CLI / Store / Docker,安装器桌面无新包。拒绝的稳定版会被压住、不再推荐。
hermes backup / import 整机搬家;默认保留最近 3 个 zip。 单 profile 用 profile export/import;*.db 按页导入,勿改 inode。
hermes secrets 外部密钥源(如 Bitwarden Secrets Manager)。 配合密码盲填 / egress。0.22.6:vault 密钥可选存系统钥匙串。
hermes approvals 从审批历史挖 allowlist 提案。 危险命令 / 受保护文件写入相关。
hermes security audit 对 venv、插件依赖、钉扎 MCP 做 OSV 扫描。 不扫全局包。
hermes dashboard 用网页管配置、密钥、会话、cron、skills、MCP/Connectors。 优先只读打开会话库;刷新 token 合并仍在;Desktop 侧 MCP 标签已换成 Connectors。0.22.4:WhatsApp 登出后可重新配对。
hermes mcp · mcp login 管理 MCP server;过期 OAuth 重授权。让 Hermes 自己当 server:装 mcp-serve 后用 hermes mcp-serve。 refresh 绑定 issuer。无头用 mcp login <server> --flow device。hermes mcp serve 只提示改用 hermes mcp-serve。0.23:付费工具可标价并设每会话消费上限,超限先问(含 YOLO)。
hermes profile · -p name 多套隔离实例:不同模型、记忆、bot、state.db。 主机网关单例;可对单 profile 停/启/重启。勿新建依赖 gateway.standalone 的拓扑。
hermes kanban 多 profile 协作看板;会话里同义 /kanban。 promote 会拒未完成父任务。0.22:kanban edit --title/--body/--priority、create --body-file。0.22.7:Desktop 置顶看板可当快速切换标签。
hermes send --to telegram "…" 脚本/cron 往 messenger 发一条,不跑 agent。 0.22:WhatsApp 原生 @ 用 --mention。
hermes connectors 0.22:管理托管应用连接(Linear、Notion 等)和多个具名账号。 会话里同义命令 /connectors;关闭用 tools.connectors.enabled: false。
hermes pm doctor|status|repair|gc 0.22:统一包管理器,管钉扎且校验哈希的 Python 3.14、uv、Node、ripgrep、FFmpeg、Chromium 等。 依赖环境按代切换;gc 回收旧环境。贡献者用 source ./activate。
hermes usage --json 0.22:脚本里查配额,不开会话。 0.22.5:按用量窗口的方案会显示计划仪表和限额卡片,撞限后可以切模型恢复。
hermes --native 0.22:让你自己的终端接管 TUI 的回滚和搜索(也可 display.tui_native)。 同期可选:display.vim_mode、display.bell_on_prompt、状态栏 git 分支,默认都关。
hermes acp · desktop · serve · webapp · migrate 接到 ACP 编辑器;启动 Desktop;无头后端服务。hermes import-agent / hermes migrate 在 agent-importers 插件里(用过会自动装)。0.23:hermes webapp 打开 gateway 上的桌面工作区(需 webapp.enabled)。 长驻 serve/dashboard 共享 state.db 写柄注册表,避免重复 writer。Webapp 默认关;Docker / Nix 镜像已带 Webapp 包。

常用 slash

在 CLI / TUI / 多数 messenger 里输入 /。已安装 skill 也会出现在这个菜单里。权威:Slash Commands。

命令 什么时候用 典型提示
/help · /palette 看可用命令;模糊命令面板(也可用 Ctrl+P)。选中只插入,不自动执行。 /palette
/login 会话内登 Nous。离回合:链接与码进会话,浏览器确认后生效。群聊会拒绝;Slack 用 /hermes login。0.22:免费身份用户在 DM 里 /login 升级成完整账号。0.22.5:登录一律是设备登录,免费身份交接到你的账号,结果会显示是谁登入。 /login
/model 在已配置模型之间切换。无参数打开模糊搜索 picker;可一步带 reasoning effort。0.22:大会话里换模型会破坏提示缓存时先确认。0.22.6:/model reset 清掉本会话的模型钉,不丢历史。0.22.7:Daybreak 打开后,目录里的 ChatGPT 订阅模型会出现在 picker。 /model reset
/new [name] 开新会话。别名 /reset。加 now/-y 跳过确认。记忆快照在此刻重读。0.22 起消息平台不再自动按空闲/每日重置。0.23:TUI 可在回合进行中开新会话,旧回合后台继续。 /new my-experiment
/resume · /sessions 恢复或浏览会话。TUI 里 /sessions 是实时切换器。 /resume
/status 模型、profile、目录、token、reasoning、待审批、上下文占用 + 本地 Session recap。不打 LLM。 /status
/context [all] 上下文占用可视化。/context all 会列出 skill 和 toolset 成本;0.22 起逐个显示指令文件已加载 / 截断 / 遮蔽。 /context all
/compress 手动压缩。/compress here 2 保留最近两轮原文。默认 lean-tail。 /compress here 2
/rewind 0.23:经典 CLI / TUI 回退到更早的用户提示(空提示也可 Esc Esc)。可改发,或 fork 出只含该点之前历史的新会话(原会话不动)。 /rewind
/rollback 列出或恢复文件系统 checkpoint。 /rollback 1
/diff [session] 看工作区或本会话累计 diff。 /diff session --stat
/steer 不打断当前 tool loop;下一次 tool 结果后注入提醒。也可用于纠偏子代理航向。0.22 简写 /s。 /steer 先只改 auth 模块
/queue · /q 下一轮再问,不打断当前回复。0.22 起可列出、编辑、移动或删除排队的提示。0.22.3:Desktop 也能改写或 steer 一条已排队的提示。 /q 接着写测试
/stop 停掉当前回合;0.22 起也能停后台子代理,并把它们已完成的部分交回来。 /stop
/delegation 0.22.6 / 0.23:查看或改子代理委托设置;选择留给下一次会话,加 --now 立刻生效。高级路由需官方 advanced-delegation 插件。 /delegation
/connectors 0.22:查看和管理已连的托管应用与账号;新应用直接在对话里要即可。 /connectors
/branch 0.22:在 Discord / Telegram / Slack / Matrix 上开一个兄弟线程继续;--here 保留原地分支的旧行为。 /branch 试另一个方案
/background · /btw 另开后台会话跑这件事,当前会话继续。 /btw 调研这个 API
/goal · /subgoal 跨 turn 追求一个目标,直到 judge 认为完成。 /goal 把 CI 修绿
/loop 0.22.3:CLI 和 TUI 里有一行实时倒计时,显示循环还要多久。和 /goal 一起看 live dock。 /loop
/heartbeat 会话空闲时按间隔重新注入 prompt。最短 60s。 /heartbeat every 10m 检查部署
/refine 立刻跑记忆/skill 自改进,不必等回合结束。 /refine 把部署流程存成 skill
/yolo · /approvals 跳过或设置危险命令审批。 /approvals smart
/personality 会话级人格覆盖,不改 SOUL.md。 /personality none
/focus · /verbose · /statusbar 只显示最终回复;工具输出详细程度;状态栏(缓存命中/延迟等)。 /focus on
/plugins · /reload-mcp 会话里管插件;重载 MCP(CLI 侧)。0.23:/plugins update 更新全部;/plugins auto-update 查看或开关无人值守更新。OAuth 过期后需先 mcp login 再 reload。 /plugins update
/worktree new CLI only。会话中切到隔离 git worktree。 /worktree new fix-auth
/handoff <platform> CLI only。把当前会话交到 messenger,要求 gateway 已运行。 /handoff telegram
/plan 内置:只写计划到 .hermes/plans/,不执行(原为捆绑 skill)。 /plan
/kanban 会话里驱动协作看板,参数面与 hermes kanban 相同。0.22.7:Desktop 置顶看板可当快速切换标签。 /kanban list
使用习惯

先让一次普通聊天跑通,再叠加 gateway、Bot Mode、cron、MCP/Connectors。改 SOUL.md / AGENTS.md 或刚写入的记忆,默认要新开会话才进入 system prompt;0.23 也可用 hermes sessions refresh-prompts 让继续中的会话下一回合重建。skills.auto_load 在下一会话生效。hermes model / hermes auth 加 provider;/model 只切已配模型。多 profile 的 state.db 隔离。gateway 在跑时不要 doctor --fix 或拆开复制 WAL。脚本集成优先 --format stream-json。浏览器工作区默认关。0.22.3 起老会话不再默认自动清理;想继续清理设 sessions.auto_prune: true。升 0.23 前先改掉旧 browser_* 工具名,并把 MCP server 启动参数改成 hermes mcp-serve。

已复制