来源Hermes Agent 官方文档 实际使用验证适用版本Hermes Agent v0.11范围本文档覆盖 Hermes 的内部子命令、后台系统、底层配置、slash commands、agent 派生区别于hermes-commands-cheatsheet.md常用命令本文档聚焦进阶/底层功能目录MCP 服务器认证与凭据池插件管理内存系统ACP / IDE 集成其他内部命令In-Session Slash Commands派生 Agent 实例Durable Background SystemsVoice Transcription安全与隐私开关配置章节详解1. MCP 服务器# 启动 Hermes 作为 MCP server让 Claude Desktop / 其他 MCP client 连接hermes mcp serve# 加 MCP serverhermes mcpaddmyserver--urlhttp://localhost:8080 hermes mcpaddmyserver--commandnode /path/to/server.js# 删除hermes mcp remove myserver# 列出hermes mcp list# 测试连接hermes mcptestmyserver# 切换 tool 选择hermes mcp configure myserver解释MCP (Model Context Protocol) 是 Anthropic 开放的标准让外部工具/数据源接入 LLM。mcp serve把 Hermes 本身变成 MCP server暴露它的工具mcp add让 Hermes 连接其他 MCP server。2. 认证与凭据池# 交互式添加凭据hermes auth hermes authaddopenai-codex# OAuth flowhermes authaddanthropic# API key# 列出hermes auth list hermes auth list openai# 按 provider 过滤# 删除hermes auth remove openai-codex0# provider index# 重置 exhaustion 状态key 被标记为耗尽后hermes auth reset openai解释Hermes 支持凭据池 — 同一个 provider 可以配多个 API key自动轮换避免限流。auth list provider看每个 key 的状态。exhaustion表示 key 被标记为暂时用完rate limit 等reset恢复。3. 插件管理# 列出已装插件hermes plugins list# 安装hermes pluginsinstallhoncho hermes pluginsinstallgithub-url# 卸载hermes plugins remove honcho常用插件honcho— 跨 session 内存推荐kanban— 多 agent 协作web-search— 内置不需要装4. 内存系统# Honcho 集成hermes honcho setup# 配置hermes honcho status# 状态# Memory providerhermes memory setup# 初始化hermes memory status# 看配置hermes memory off# 禁用# 内存后端built-in, Honcho, Mem0看 plugins配置示例memory:memory_enabled:trueuser_profile_enabled:trueprovider:honcho# 或 built-in / mem0解释Memory 跨 session 持久化。Honcho 是 Nous Research 出的分布式 memory 服务能在多 device 同步。“User profile” 让 Hermes 自动学习 Jack 的偏好已经看到了 Jack 收藏的文章。5. ACP / IDE 集成hermes acp# 启动 ACP serverACP Agent Client Protocol。让 IDEVS Code、JetBrains作为 client 连接 Hermes。配置例子VS Codesettings.json{acp.agent.command:hermes,acp.agent.args:[acp]}解释通过 ACPIDE 内的文件/项目直接喂给 Hermes agentagent 改文件、跑命令像在 CLI 一样。6. 其他内部命令# 平台 DM 授权首次有人 DM Telegram bot 需 admin 批准hermes pairing list hermes pairing approvecodehermes pairing revokecode# 更新到最新版本hermes update# 卸载 Hermeshermes uninstall# 从 OpenClaw 迁移老项目hermes claw migrate# Shell 自动补全hermes completionbash~/.bash_completion hermes completionzsh${fpath[1]}/_hermes# 用量分析hermes insights--days30# Debug 报告上传到 nous 服务器生成可分享链接hermes debug解释pairing用于 DM-first 平台Telegram、Discord、Signal防止陌生人触发 agent。update拉最新 release。debug打包 system info logs config输出一个 URL 给开发者定位问题。7. In-Session Slash Commands这些是 chat session 内的命令输入/触发。Session 控制/new (/reset) 全新 session /clear 清屏 新 sessionCLI /retry 重发上一条 /undo 删最后一个 exchange /title [name] 命名当前 session /compress 手动压缩 context /stop kill 后台进程 /rollback [N] 恢复 filesystem checkpoint /snapshot [sub] 创建/恢复 Hermes 状态快照CLI /background prompt 后台跑 prompt /queue prompt 排队到下一 turn /steer prompt 在下一个 tool call 后注入不打断当前 /agents (/tasks) 列出活跃 subagent 和 running task /resume [name] 恢复命名 session /goal [text|sub] 设定持续目标agent 跨 turn 工作直到完成 sub: status, pause, resume, clear /redraw 强制刷新 UICLI配置/config 显示配置CLI /model [name] 显示或切换模型 /personality [name] 设定 personality /reasoning [level] none|minimal|low|medium|high|xhigh|show|hide /verbose off → new → all → verbose /voice [on|off|tts] voice 模式 /yolo 切换 approval bypass /busy [sub] 控制 Enter 行为queue, steer, interrupt, status /indicator [style] 选 busy-indicatorkaomoji, emoji, unicode, ascii /footer [on|off] gateway 元数据 footer /skin [name] 改主题CLI /statusbar 切换状态栏Tools Skills/tools 管理工具CLI /toolsets 列出 toolsetCLI /skills 搜索/安装 skillsCLI /skill name 加载 skill 到 session /reload-skills 重新扫描 ~/.hermes/skills/ /reload 重载 .envCLI /reload-mcp 重载 MCP servers /cron 管理 cron jobsCLI /curator [sub] 后台 skill 维护status, run, pin, archive, ... /kanban [sub] 多 profile 协作看板tasks, links, comments /plugins 列出插件CLIGateway/approve 批准待执行的命令 /deny 拒绝 /restart 重启 gateway /sethome 当前 chat 设为 home channel /update 更新 gateway /topic [sub] Telegram DM topic session /platforms (/gateway) 看平台连接状态Utility/branch (/fork) 分叉当前 session /fast 切换 priority/fast /browser 开 CDP 浏览器 /history 历史CLI /save 保存对话到文件CLI /copy [N] 复制最后一条到剪贴板 /paste 附剪贴板图片 /image 附本地图片Info/help 命令列表 /commands [page] 浏览命令 /usage token 用量 /insights [days] 分析 /gquota Gemini 配额 /status session 信息 /profile 当前 profile /debug 上传 debug 报告Exit/quit (/exit, /q) 退出 CLI解释slash commands 是 in-session 的快捷操作。/goal是 Hermes 独有 — 设定目标后 agent 跨多个 turn 工作直到完成适合长任务。8. 派生 Agent 实例8.1 vsdelegate_task的选择delegate_taskSpawnhermesprocess隔离独立对话共享 process完全独立 process时长分钟级小时/天工具父 agent 工具的子集完整工具交互否是PTY场景快速并行子任务长自主任务8.2 One-shot 模式# 前台跑terminal(commandhermes chat -q Research GRPO papers and write to ~/research/grpo.md,timeout300)# 后台跑不阻塞当前 turnterminal(commandhermes chat -q Set up CI/CD for ~/myapp,backgroundtrue)8.3 Interactive PTY 模式用 tmux# 启动派生 agentterminal(commandtmux new-session -d -s agent1 -x 120 -y 40 hermes,timeout10)# 等启动完后发消息terminal(commandsleep 8 tmux send-keys -t agent1 Build a FastAPI auth service Enter,timeout15)# 读输出terminal(commandsleep 20 tmux capture-pane -t agent1 -p,timeout5)# 后续指令terminal(commandtmux send-keys -t agent1 Add rate limiting middleware Enter,timeout5)# 退出terminal(commandtmux send-keys -t agent1 /exit Enter sleep 2 tmux kill-session -t agent1,timeout10)8.4 多 Agent 协调# Agent Aterminal(commandtmux new-session -d -s backend -x 120 -y 40 hermes -w,timeout10)terminal(commandsleep 8 tmux send-keys -t backend Build REST API for user management Enter,timeout15)# Agent B同时跑terminal(commandtmux new-session -d -s frontend -x 120 -y 40 hermes -w,timeout10)terminal(commandsleep 8 tmux send-keys -t frontend Build React dashboard Enter,timeout15)# 互相传递上下文terminal(commandtmux capture-pane -t backend -p | tail -30,timeout5)terminal(commandtmux send-keys -t frontend Here is the API schema from backend: ... Enter,timeout5)8.5 Session Resume# 恢复最近 sessionterminal(commandtmux new-session -d -s resumed hermes --continue,timeout10)# 恢复指定 sessionterminal(commandtmux new-session -d -s resumed hermes --resume 20260225_143052_a1b2c3,timeout10)8.6 派生参数# -w (worktree) — 隔离 git 改动hermes-wchat-qAdd OAuth# -p (profile) — 用指定 profilehermes-pmyproject chat-q...# 预加载 skillshermes-skimi-model-setup,planchat-qBuild a CLI tool# 传 session ID 给后续 system prompthermes --pass-session-id chat-q...解释-w防止多 agent 在同一 git 仓库改文件冲突。-p切换 profile独立 config/skills/memory。-s预加载 skills跳过自动触发。9. Durable Background Systems四个持久化系统subagent 派生、cron、curator、kanban。9.1 Delegation (delegate_task)# 通过 LLM 工具调用不是 CLI# 实际是 in-session 调delegate_task(goal...,context{...},toolsets[...])delegate_task(tasks[{goal:...},{goal:...}],...)# 并行配置delegation:model:kimi-k2.6provider:kimi-coding-cnmax_iterations:50reasoning_effort:mediummax_concurrent_children:3# 并行上限max_spawn_depth:1# 不允许嵌套不持久父 agent 中断时子任务被取消。需要持久化用cronjob或terminal(backgroundtrue, notify_on_completetrue)。9.2 Cron持久化调度hermescroncreate0 9 * * *\--promptDaily report\--skillsreport-aggregator\--delivertelegram\--deliver-extrachat_id-1001234567890支持的 schedule 格式30m,2h— 持续时间every monday 9am— 自然语言0 9 * * *— 5-field cron2026-07-01T09:00:00— ISO 时间戳不变量每次 run 3 分钟硬中断.tick.lock防多 process 重复 tickcron session 默认skip_memoryTrue投递用 header/footer 框架不污染目标 session9.3 Curatorskill 生命周期hermes curator status hermes curator run# 立即跑维护hermes curator pause hermes curator resume hermes curator pinskill# 钉住 不会被自动归档hermes curator unpinskillhermes curator archiveskill# 归档不删除hermes curator restoreskillhermes curator prune hermes curator backup hermes curator rollback作用后台维护 agent 创建的 skill。追踪使用率、标记 idle skill 为 stale、归档 stale。created_by: agent的 skill 才会被 curator 处理in-repo hub-installed 不动。不删除最大动作是 archive。遥测~/.hermes/skills/.usage.json记录use_count/view_count/last_activity_at/state/pinned。配置curator:enabled:trueinterval_hours:24min_idle_hours:72stale_after_days:30archive_after_days:90backup:enabled:truekeep:59.4 Kanban多 Agent 协作hermes kanban init hermes kanban createImplement X--assignbackend hermes kanban list# 别名 lshermes kanban showidhermes kanban assignidfrontend hermes kanbanlinkidother-id# 任务间链接hermes kanban commentid...hermes kanban completeidhermes kanban blockid等待 Yhermes kanban unblockidhermes kanban archiveidhermes kanbantailid# 跟 loghermes kanbanwatch# 实时hermes kanban stats hermes kanban runs hermes kanban logrun-idhermes kanban dispatch# 启动 dispatcherhermes kanban daemon# 后台跑 dispatcherhermes kanban gc# 清理特性持久化 SQLite boardDispatcher 自动 reclaim stale claims、原子认领任务、spawn 派给 profilefailure_limit次连续失败后自动 block taskWorker 通过kanban_*toolset 交互被HERMES_KANBAN_TASKenv gateBoard 是隔离边界tenant 是 workspace-path memory-key 隔离10. Voice Transcription10.1 STT语音 → 文本# 自动转录无需命令— gateway 收到 voice message 自动转# 配置 providerhermes configsetstt.enabledtruehermes configsetstt.provider groq# local / groq / openai / mistralhermes configsetGROQ_API_KEY ***# free tier优先级自动检测Local faster-whisper— 免费pip install faster-whisperGroq Whisper— 免费 tierOpenAI Whisper— 付费Mistral Voxtral— 付费stt:enabled:trueprovider:locallocal:model:base# tiny/base/small/medium/large-v310.2 TTS文本 → 语音ProviderEnv VarFree?Edge TTS(none)✓ 默认ElevenLabsELEVENLABS_API_KEYFree tierOpenAIVOICE_TOOLS_OPENAI_KEY付费MiniMaxMINIMAX_API_KEY付费Mistral VoxtralMISTRAL_API_KEY付费NeuTTS (local)无pip install neutts[all]✓ Free用法/voice on— voice-to-voice 模式/voice tts— 总是用 voice/voice off— 关闭11. 安全与隐私开关11.1 Secret Redactionhermes configsetsecurity.redact_secretstrue# 默认开hermes configsetsecurity.redact_secretsfalse# 调试用重要redact_secrets在启动时 snapshotsession 中改不生效。要重启 Hermes。效果tool output (terminal/read_file/web/subagent) 自动 scan 看起来像 API key/token 的字符串再进 context。11.2 PII RedactionGatewayhermes configsetprivacy.redact_piitrue# 开启hermes configsetprivacy.redact_piifalse# 默认关效果Gateway 哈希 user ID剥电话号码后再喂给 model。11.3 Command Approvalshermes configsetapprovals.mode manual# 默认每次危险命令都问hermes configsetapprovals.mode smart# 推荐LLM 判风险hermes configsetapprovals.mode off# 全跳过hermes--yolo# 单次 bypassexportHERMES_YOLO_MODE1# 临时开不变量YOLO 不关 secret redaction独立机制。11.4 Shell Hooks Allowlist# 首次跑会交互式询问# 手动管理~/.hermes/shell-hooks-allowlist.json解释Shell hook 是触发器pre/post command需明确 allowlist 后才执行。11.5 禁用网络/媒体工具hermes tools# curses UI 切换# 改动需新 session/reset生效12. 配置章节详解~/.hermes/config.yaml的所有顶层 sectionSection关键 keys作用modeldefault,provider,base_url,api_key,context_lengthLLM 配置agentmax_turns(90),tool_use_enforcement主循环terminalbackend(local/docker/ssh/modal),cwd,timeout(180)命令执行compressionenabled,threshold(0.50),target_ratio(0.20)Context 压缩displayskin,tool_progress,show_reasoning,show_costUIsttenabled,provider(local/groq/openai/mistral)语音转文本ttsprovider(edge/elevenlabs/openai/MiniMax/mistral/neutts)文本转语音memorymemory_enabled,user_profile_enabled,provider跨 session 内存securitytirith_enabled,website_blocklist,redact_secrets安全delegationmodel,provider,max_iterations(50),max_concurrent_children(3)subagentcheckpointsenabled,max_snapshots(50)filesystem 快照curatorenabled,interval_hours(24),stale_after_days(30)skill 维护auxiliaryvision,compression,title_generation各自的 provider辅助模型Toolsets按需启用hermes toolsenableNAME hermes tools disable NAME完整列表toolsets.py::_HERMES_CORE_TOOLSToolset用途webWeb 搜索 内容提取search仅搜索web 子集browser浏览器自动化Browserbase/Camofox/local ChromiumterminalShell 命令file读/写/搜索/patchcode_execution沙箱 Pythonvision图像分析image_genAI 图像生成video视频分析/生成ttsTTSskillsskill 浏览/管理memory内存session_search搜历史对话delegationsubagentcronjobcronclarify问用户澄清messaging跨平台消息todosession 内 todokanban多 agent 看板worker 默认 gatedebugging调试默认关safe低风险 toolsetspotifySpotifyhomeassistant智能家居默认关discord/discord_adminDiscordfeishu_doc/feishu_drive飞书yuanbao元宝rl强化学习默认关moaMixture of Agents默认关注意toolset 改动需要/reset新 session 才生效避免破坏 prompt cache。路径速查用途路径配置~/.hermes/config.yaml环境变量~/.hermes/.env认证~/.hermes/auth.json会话存储~/.hermes/state.db(SQLite FTS5)Gateway 日志~/.hermes/logs/gateway.logSkills 根~/.hermes/skills/cat/name/Profile skills~/.hermes/profiles/name/skills/...Profile config~/.hermes/profiles/name/config.yamlSkill 使用遥测~/.hermes/skills/.usage.jsonShell hooks 允许列表~/.hermes/shell-hooks-allowlist.json源码git 安装~/.hermes/hermes-agent/相关 Skillshermes-agent— 完整参考本文档是浓缩kimi-model-setup— Kimi/MiniMax 配置hermes-agent-skill-authoring— 写 SKILL.md 规范skill-invocation— 何时加载哪个 skillhermes-webhook-integration— Webhook 集成生成时间2026-06-05来源Hermes Agent 官方文档 实际使用经验对应文档hermes-commands-cheatsheet.md常用命令
Hermes Agent 内部/后端命令速查表
发布时间：2026/6/6 8:58:12
来源Hermes Agent 官方文档 实际使用验证适用版本Hermes Agent v0.11范围本文档覆盖 Hermes 的内部子命令、后台系统、底层配置、slash commands、agent 派生区别于hermes-commands-cheatsheet.md常用命令本文档聚焦进阶/底层功能目录MCP 服务器认证与凭据池插件管理内存系统ACP / IDE 集成其他内部命令In-Session Slash Commands派生 Agent 实例Durable Background SystemsVoice Transcription安全与隐私开关配置章节详解1. MCP 服务器# 启动 Hermes 作为 MCP server让 Claude Desktop / 其他 MCP client 连接hermes mcp serve# 加 MCP serverhermes mcpaddmyserver--urlhttp://localhost:8080 hermes mcpaddmyserver--commandnode /path/to/server.js# 删除hermes mcp remove myserver# 列出hermes mcp list# 测试连接hermes mcptestmyserver# 切换 tool 选择hermes mcp configure myserver解释MCP (Model Context Protocol) 是 Anthropic 开放的标准让外部工具/数据源接入 LLM。mcp serve把 Hermes 本身变成 MCP server暴露它的工具mcp add让 Hermes 连接其他 MCP server。2. 认证与凭据池# 交互式添加凭据hermes auth hermes authaddopenai-codex# OAuth flowhermes authaddanthropic# API key# 列出hermes auth list hermes auth list openai# 按 provider 过滤# 删除hermes auth remove openai-codex0# provider index# 重置 exhaustion 状态key 被标记为耗尽后hermes auth reset openai解释Hermes 支持凭据池 — 同一个 provider 可以配多个 API key自动轮换避免限流。auth list provider看每个 key 的状态。exhaustion表示 key 被标记为暂时用完rate limit 等reset恢复。3. 插件管理# 列出已装插件hermes plugins list# 安装hermes pluginsinstallhoncho hermes pluginsinstallgithub-url# 卸载hermes plugins remove honcho常用插件honcho— 跨 session 内存推荐kanban— 多 agent 协作web-search— 内置不需要装4. 内存系统# Honcho 集成hermes honcho setup# 配置hermes honcho status# 状态# Memory providerhermes memory setup# 初始化hermes memory status# 看配置hermes memory off# 禁用# 内存后端built-in, Honcho, Mem0看 plugins配置示例memory:memory_enabled:trueuser_profile_enabled:trueprovider:honcho# 或 built-in / mem0解释Memory 跨 session 持久化。Honcho 是 Nous Research 出的分布式 memory 服务能在多 device 同步。“User profile” 让 Hermes 自动学习 Jack 的偏好已经看到了 Jack 收藏的文章。5. ACP / IDE 集成hermes acp# 启动 ACP serverACP Agent Client Protocol。让 IDEVS Code、JetBrains作为 client 连接 Hermes。配置例子VS Codesettings.json{acp.agent.command:hermes,acp.agent.args:[acp]}解释通过 ACPIDE 内的文件/项目直接喂给 Hermes agentagent 改文件、跑命令像在 CLI 一样。6. 其他内部命令# 平台 DM 授权首次有人 DM Telegram bot 需 admin 批准hermes pairing list hermes pairing approvecodehermes pairing revokecode# 更新到最新版本hermes update# 卸载 Hermeshermes uninstall# 从 OpenClaw 迁移老项目hermes claw migrate# Shell 自动补全hermes completionbash~/.bash_completion hermes completionzsh${fpath[1]}/_hermes# 用量分析hermes insights--days30# Debug 报告上传到 nous 服务器生成可分享链接hermes debug解释pairing用于 DM-first 平台Telegram、Discord、Signal防止陌生人触发 agent。update拉最新 release。debug打包 system info logs config输出一个 URL 给开发者定位问题。7. In-Session Slash Commands这些是 chat session 内的命令输入/触发。Session 控制/new (/reset) 全新 session /clear 清屏 新 sessionCLI /retry 重发上一条 /undo 删最后一个 exchange /title [name] 命名当前 session /compress 手动压缩 context /stop kill 后台进程 /rollback [N] 恢复 filesystem checkpoint /snapshot [sub] 创建/恢复 Hermes 状态快照CLI /background prompt 后台跑 prompt /queue prompt 排队到下一 turn /steer prompt 在下一个 tool call 后注入不打断当前 /agents (/tasks) 列出活跃 subagent 和 running task /resume [name] 恢复命名 session /goal [text|sub] 设定持续目标agent 跨 turn 工作直到完成 sub: status, pause, resume, clear /redraw 强制刷新 UICLI配置/config 显示配置CLI /model [name] 显示或切换模型 /personality [name] 设定 personality /reasoning [level] none|minimal|low|medium|high|xhigh|show|hide /verbose off → new → all → verbose /voice [on|off|tts] voice 模式 /yolo 切换 approval bypass /busy [sub] 控制 Enter 行为queue, steer, interrupt, status /indicator [style] 选 busy-indicatorkaomoji, emoji, unicode, ascii /footer [on|off] gateway 元数据 footer /skin [name] 改主题CLI /statusbar 切换状态栏Tools Skills/tools 管理工具CLI /toolsets 列出 toolsetCLI /skills 搜索/安装 skillsCLI /skill name 加载 skill 到 session /reload-skills 重新扫描 ~/.hermes/skills/ /reload 重载 .envCLI /reload-mcp 重载 MCP servers /cron 管理 cron jobsCLI /curator [sub] 后台 skill 维护status, run, pin, archive, ... /kanban [sub] 多 profile 协作看板tasks, links, comments /plugins 列出插件CLIGateway/approve 批准待执行的命令 /deny 拒绝 /restart 重启 gateway /sethome 当前 chat 设为 home channel /update 更新 gateway /topic [sub] Telegram DM topic session /platforms (/gateway) 看平台连接状态Utility/branch (/fork) 分叉当前 session /fast 切换 priority/fast /browser 开 CDP 浏览器 /history 历史CLI /save 保存对话到文件CLI /copy [N] 复制最后一条到剪贴板 /paste 附剪贴板图片 /image 附本地图片Info/help 命令列表 /commands [page] 浏览命令 /usage token 用量 /insights [days] 分析 /gquota Gemini 配额 /status session 信息 /profile 当前 profile /debug 上传 debug 报告Exit/quit (/exit, /q) 退出 CLI解释slash commands 是 in-session 的快捷操作。/goal是 Hermes 独有 — 设定目标后 agent 跨多个 turn 工作直到完成适合长任务。8. 派生 Agent 实例8.1 vsdelegate_task的选择delegate_taskSpawnhermesprocess隔离独立对话共享 process完全独立 process时长分钟级小时/天工具父 agent 工具的子集完整工具交互否是PTY场景快速并行子任务长自主任务8.2 One-shot 模式# 前台跑terminal(commandhermes chat -q Research GRPO papers and write to ~/research/grpo.md,timeout300)# 后台跑不阻塞当前 turnterminal(commandhermes chat -q Set up CI/CD for ~/myapp,backgroundtrue)8.3 Interactive PTY 模式用 tmux# 启动派生 agentterminal(commandtmux new-session -d -s agent1 -x 120 -y 40 hermes,timeout10)# 等启动完后发消息terminal(commandsleep 8 tmux send-keys -t agent1 Build a FastAPI auth service Enter,timeout15)# 读输出terminal(commandsleep 20 tmux capture-pane -t agent1 -p,timeout5)# 后续指令terminal(commandtmux send-keys -t agent1 Add rate limiting middleware Enter,timeout5)# 退出terminal(commandtmux send-keys -t agent1 /exit Enter sleep 2 tmux kill-session -t agent1,timeout10)8.4 多 Agent 协调# Agent Aterminal(commandtmux new-session -d -s backend -x 120 -y 40 hermes -w,timeout10)terminal(commandsleep 8 tmux send-keys -t backend Build REST API for user management Enter,timeout15)# Agent B同时跑terminal(commandtmux new-session -d -s frontend -x 120 -y 40 hermes -w,timeout10)terminal(commandsleep 8 tmux send-keys -t frontend Build React dashboard Enter,timeout15)# 互相传递上下文terminal(commandtmux capture-pane -t backend -p | tail -30,timeout5)terminal(commandtmux send-keys -t frontend Here is the API schema from backend: ... Enter,timeout5)8.5 Session Resume# 恢复最近 sessionterminal(commandtmux new-session -d -s resumed hermes --continue,timeout10)# 恢复指定 sessionterminal(commandtmux new-session -d -s resumed hermes --resume 20260225_143052_a1b2c3,timeout10)8.6 派生参数# -w (worktree) — 隔离 git 改动hermes-wchat-qAdd OAuth# -p (profile) — 用指定 profilehermes-pmyproject chat-q...# 预加载 skillshermes-skimi-model-setup,planchat-qBuild a CLI tool# 传 session ID 给后续 system prompthermes --pass-session-id chat-q...解释-w防止多 agent 在同一 git 仓库改文件冲突。-p切换 profile独立 config/skills/memory。-s预加载 skills跳过自动触发。9. Durable Background Systems四个持久化系统subagent 派生、cron、curator、kanban。9.1 Delegation (delegate_task)# 通过 LLM 工具调用不是 CLI# 实际是 in-session 调delegate_task(goal...,context{...},toolsets[...])delegate_task(tasks[{goal:...},{goal:...}],...)# 并行配置delegation:model:kimi-k2.6provider:kimi-coding-cnmax_iterations:50reasoning_effort:mediummax_concurrent_children:3# 并行上限max_spawn_depth:1# 不允许嵌套不持久父 agent 中断时子任务被取消。需要持久化用cronjob或terminal(backgroundtrue, notify_on_completetrue)。9.2 Cron持久化调度hermescroncreate0 9 * * *\--promptDaily report\--skillsreport-aggregator\--delivertelegram\--deliver-extrachat_id-1001234567890支持的 schedule 格式30m,2h— 持续时间every monday 9am— 自然语言0 9 * * *— 5-field cron2026-07-01T09:00:00— ISO 时间戳不变量每次 run 3 分钟硬中断.tick.lock防多 process 重复 tickcron session 默认skip_memoryTrue投递用 header/footer 框架不污染目标 session9.3 Curatorskill 生命周期hermes curator status hermes curator run# 立即跑维护hermes curator pause hermes curator resume hermes curator pinskill# 钉住 不会被自动归档hermes curator unpinskillhermes curator archiveskill# 归档不删除hermes curator restoreskillhermes curator prune hermes curator backup hermes curator rollback作用后台维护 agent 创建的 skill。追踪使用率、标记 idle skill 为 stale、归档 stale。created_by: agent的 skill 才会被 curator 处理in-repo hub-installed 不动。不删除最大动作是 archive。遥测~/.hermes/skills/.usage.json记录use_count/view_count/last_activity_at/state/pinned。配置curator:enabled:trueinterval_hours:24min_idle_hours:72stale_after_days:30archive_after_days:90backup:enabled:truekeep:59.4 Kanban多 Agent 协作hermes kanban init hermes kanban createImplement X--assignbackend hermes kanban list# 别名 lshermes kanban showidhermes kanban assignidfrontend hermes kanbanlinkidother-id# 任务间链接hermes kanban commentid...hermes kanban completeidhermes kanban blockid等待 Yhermes kanban unblockidhermes kanban archiveidhermes kanbantailid# 跟 loghermes kanbanwatch# 实时hermes kanban stats hermes kanban runs hermes kanban logrun-idhermes kanban dispatch# 启动 dispatcherhermes kanban daemon# 后台跑 dispatcherhermes kanban gc# 清理特性持久化 SQLite boardDispatcher 自动 reclaim stale claims、原子认领任务、spawn 派给 profilefailure_limit次连续失败后自动 block taskWorker 通过kanban_*toolset 交互被HERMES_KANBAN_TASKenv gateBoard 是隔离边界tenant 是 workspace-path memory-key 隔离10. Voice Transcription10.1 STT语音 → 文本# 自动转录无需命令— gateway 收到 voice message 自动转# 配置 providerhermes configsetstt.enabledtruehermes configsetstt.provider groq# local / groq / openai / mistralhermes configsetGROQ_API_KEY ***# free tier优先级自动检测Local faster-whisper— 免费pip install faster-whisperGroq Whisper— 免费 tierOpenAI Whisper— 付费Mistral Voxtral— 付费stt:enabled:trueprovider:locallocal:model:base# tiny/base/small/medium/large-v310.2 TTS文本 → 语音ProviderEnv VarFree?Edge TTS(none)✓ 默认ElevenLabsELEVENLABS_API_KEYFree tierOpenAIVOICE_TOOLS_OPENAI_KEY付费MiniMaxMINIMAX_API_KEY付费Mistral VoxtralMISTRAL_API_KEY付费NeuTTS (local)无pip install neutts[all]✓ Free用法/voice on— voice-to-voice 模式/voice tts— 总是用 voice/voice off— 关闭11. 安全与隐私开关11.1 Secret Redactionhermes configsetsecurity.redact_secretstrue# 默认开hermes configsetsecurity.redact_secretsfalse# 调试用重要redact_secrets在启动时 snapshotsession 中改不生效。要重启 Hermes。效果tool output (terminal/read_file/web/subagent) 自动 scan 看起来像 API key/token 的字符串再进 context。11.2 PII RedactionGatewayhermes configsetprivacy.redact_piitrue# 开启hermes configsetprivacy.redact_piifalse# 默认关效果Gateway 哈希 user ID剥电话号码后再喂给 model。11.3 Command Approvalshermes configsetapprovals.mode manual# 默认每次危险命令都问hermes configsetapprovals.mode smart# 推荐LLM 判风险hermes configsetapprovals.mode off# 全跳过hermes--yolo# 单次 bypassexportHERMES_YOLO_MODE1# 临时开不变量YOLO 不关 secret redaction独立机制。11.4 Shell Hooks Allowlist# 首次跑会交互式询问# 手动管理~/.hermes/shell-hooks-allowlist.json解释Shell hook 是触发器pre/post command需明确 allowlist 后才执行。11.5 禁用网络/媒体工具hermes tools# curses UI 切换# 改动需新 session/reset生效12. 配置章节详解~/.hermes/config.yaml的所有顶层 sectionSection关键 keys作用modeldefault,provider,base_url,api_key,context_lengthLLM 配置agentmax_turns(90),tool_use_enforcement主循环terminalbackend(local/docker/ssh/modal),cwd,timeout(180)命令执行compressionenabled,threshold(0.50),target_ratio(0.20)Context 压缩displayskin,tool_progress,show_reasoning,show_costUIsttenabled,provider(local/groq/openai/mistral)语音转文本ttsprovider(edge/elevenlabs/openai/MiniMax/mistral/neutts)文本转语音memorymemory_enabled,user_profile_enabled,provider跨 session 内存securitytirith_enabled,website_blocklist,redact_secrets安全delegationmodel,provider,max_iterations(50),max_concurrent_children(3)subagentcheckpointsenabled,max_snapshots(50)filesystem 快照curatorenabled,interval_hours(24),stale_after_days(30)skill 维护auxiliaryvision,compression,title_generation各自的 provider辅助模型Toolsets按需启用hermes toolsenableNAME hermes tools disable NAME完整列表toolsets.py::_HERMES_CORE_TOOLSToolset用途webWeb 搜索 内容提取search仅搜索web 子集browser浏览器自动化Browserbase/Camofox/local ChromiumterminalShell 命令file读/写/搜索/patchcode_execution沙箱 Pythonvision图像分析image_genAI 图像生成video视频分析/生成ttsTTSskillsskill 浏览/管理memory内存session_search搜历史对话delegationsubagentcronjobcronclarify问用户澄清messaging跨平台消息todosession 内 todokanban多 agent 看板worker 默认 gatedebugging调试默认关safe低风险 toolsetspotifySpotifyhomeassistant智能家居默认关discord/discord_adminDiscordfeishu_doc/feishu_drive飞书yuanbao元宝rl强化学习默认关moaMixture of Agents默认关注意toolset 改动需要/reset新 session 才生效避免破坏 prompt cache。路径速查用途路径配置~/.hermes/config.yaml环境变量~/.hermes/.env认证~/.hermes/auth.json会话存储~/.hermes/state.db(SQLite FTS5)Gateway 日志~/.hermes/logs/gateway.logSkills 根~/.hermes/skills/cat/name/Profile skills~/.hermes/profiles/name/skills/...Profile config~/.hermes/profiles/name/config.yamlSkill 使用遥测~/.hermes/skills/.usage.jsonShell hooks 允许列表~/.hermes/shell-hooks-allowlist.json源码git 安装~/.hermes/hermes-agent/相关 Skillshermes-agent— 完整参考本文档是浓缩kimi-model-setup— Kimi/MiniMax 配置hermes-agent-skill-authoring— 写 SKILL.md 规范skill-invocation— 何时加载哪个 skillhermes-webhook-integration— Webhook 集成生成时间2026-06-05来源Hermes Agent 官方文档 实际使用经验对应文档hermes-commands-cheatsheet.md常用命令
