跳转到主要内容
HermesAgent.Work
Commands

Hermes Agent 常用命令速查表

安装、模型、Skills、Gateway 和工作流调试常用命令放在一个页面,新手遇到问题先从这里回到最小可用状态。

环境与模型验收

适合刚安装或换模型后使用,先确认 Hermes Agent 能正常启动、读取配置和调用 Provider。

hermes setup

交互式设置向导:选 Provider 和模型,配置终端后端、消息平台和工具;也可以用 hermes setup model 只重跑某一段。

首次运行会先让你选设置方式。新版默认推荐 Nous Portal 快速设置(浏览器登录),国内用户建议选 Full setup,再选国内 Provider。

hermes doctor

检查环境、依赖、配置和常见错误。

遇到异常先跑 doctor,再看日志。

hermes config check

检查配置文件有没有缺项或版本过旧。

它不验证 API Key 是否有效;Key 和依赖问题用 hermes doctor 查。

hermes model

打开交互式选择器,查看并切换 Provider 和模型。

model not found 先在这里核对模型名;会话里也可以用 /model 临时切换。

Skills 浏览、安装和维护

适合已经跑通基础环境,想把重复流程沉淀成 Skill 的用户。

hermes skills browse

浏览可用 Skills 和分类。

不知道装什么时先浏览,不要一次装太多。

hermes skills search github

按关键词搜索 Skills。

把 github 换成 research、calendar、content 等场景词。

hermes skills install official/creative/baoyu-comic

从命令行安装指定 Skill(这里以宝玉的知识漫画技能为例)。

v0.21 起它不再内置,需要这样安装;安装后先用只读任务验证触发和输出。

/github

在会话里调用内置的 github 技能,处理 Issue、PR 和代码审查。

它通过 gh CLI 工作,需先装好并 gh auth login。旧教程里的 github-pr-workflow、github-code-review 等技能,v0.21 起已合并进这一个。

hermes skills update

更新已安装 Skills。

长期使用建议每月检查一次。

Gateway 与消息入口

适合把 Hermes Agent 接入 Telegram、飞书、企业微信或团队群时使用。

hermes gateway status

查看消息入口连接状态。

平台能收到消息但不回复时,先区分 Gateway 和模型问题。

hermes logs gateway

查看 Gateway 日志;加 -f 实时跟踪。

日志里不要泄露 API Key、Token 或客户敏感信息。

hermes gateway restart

改完配置后重启 Gateway,让后台进程读取新配置。

CLI 正常但 Gateway 不正常时,重启后再看 hermes gateway status 和 hermes logs gateway。

工作流调试

适合日报、Issue 分类、周报、FAQ 更新等模板第一次落地时使用。

hermes

打开交互式会话,先用短输入验证模型和上下文。

复杂工作流出错前,先确认最短问答能完成。

hermes doctor

把复杂问题拆回环境、模型、权限和输入来源。

不要在一个失败工作流里同时改十个变量。

hermes skills search workflow

查找适合当前流程的 Skill 或模板思路。

先复制低风险模板,再沉淀成长期 Skill。