hermes-agent 常用命令大全

冰上浮云 · 2026-06-27 08:28:09 发布

hermes-agent 常用命令大全（完整版速查）

本文整理 Hermes Agent 核心高频 CLI 命令，按使用场景分类，附带详细功能说明、参数解析和实操示例，覆盖初始化运维、配置管理、模型对话、技能管理、系统维护等全场景，适配日常开发、调试、部署全流程。

用于环境初始化、状态检测、故障排查，是安装部署后第一步操作，确保核心服务正常运行。

命令	功能说明	实操示例
`hermes setup`	初始化核心服务，自动检测并配置 Provider、Memory、Skills、Gateway 四大核心模块，生成默认配置文件，首次安装必须执行	`hermes setup`（直接执行，跟随指引完成初始化）
`hermes doctor`	环境诊断工具，全面检测系统依赖、端口占用、配置合法性、模型连通性，自动排查大部分启动报错、运行异常问题	`hermes doctor`（一键体检，输出异常修复建议）
`hermes config check`	校验当前所有配置文件完整性、格式合法性，检测配置缺失、参数错误等问题	`hermes config check`
`hermes status`	查看集群/服务运行状态，监控节点负载、端口状态、任务运行情况，快速定位超时、离线异常节点	`hermes status`
`hermes --tui`	启动交互式终端可视化界面，支持多行编辑、命令自动补全、会话历史回溯、流式输出，替代纯命令行操作	`hermes --tui`

专门用于查看、编辑、修改、重置 Hermes 全局配置，支持模型、密钥、环境变量等精细化配置。

命令	功能说明	实操示例
`hermes config`	查看当前完整全局配置，展示模型、密钥、服务端口、技能配置等所有参数	`hermes config`
`hermes config edit`	直接打开配置文件（config.yaml）进行可视化编辑，无需手动找文件路径	`hermes config edit`
`hermes config set`	单行快速修改指定配置项，无需打开配置文件，适合批量脚本配置	hermes config set model.default kimi-k2.6``hermes config set KIMI_CN_API_KEY 你的密钥
`hermes config get`	精准查询单个配置项的当前取值，快速核对配置是否生效	`hermes config get model.default`
`hermes config path`	输出配置文件本地存储路径，方便手动备份、替换配置文件	`hermes config path`
`hermes config env`	查看当前生效的环境变量配置，排查环境变量覆盖配置文件的问题	`hermes config env`

用于切换模型、发起对话、指定对话能力，支持自定义模型供应商、工具集、运行模式。

命令	功能说明	实操示例
`hermes model`	查看、管理、切换模型供应商（Provider），展示已配置的所有模型列表	`hermes model`
`hermes chat`	发起交互式 AI 对话，支持自定义模型、工具集、运行参数，是日常核心交互命令	# 指定模型和供应商对话`hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6`# 启用网页、终端、技能工具集`hermes chat --toolsets web,terminal,skills`# 静默输出JSON结果`hermes chat --quiet -q "输出当前系统信息"`
`hermes chat --worktree`	绑定当前工作目录，允许 AI 读取、修改本地项目文件，适配代码审查、项目开发场景	`hermes chat --worktree -q "审查当前仓库代码并提交优化建议"`
`hermes chat --ignore-user-config`	忽略个人自定义配置，使用系统默认配置对话，用于复现问题、标准化测试	`hermes chat --ignore-user-config --ignore-rules -q "标准化测试问答"`

用于浏览、搜索、安装、卸载官方/第三方技能，扩展 Agent 能力（代码、搜索、办公等）。

命令	功能说明	实操示例
`hermes skills browse`	浏览官方技能市场所有可用技能，查看技能简介、适配场景、版本信息	`hermes skills browse`
`hermes skills search`	关键词搜索目标技能，精准定位所需功能插件	hermes skills search github``hermes skills search code
`hermes skills install`	安装指定技能，一键部署依赖并启用功能	hermes skills install codex``hermes skills install github-tool
`hermes skills list`	查看当前已安装的所有技能，展示启用状态、版本、依赖信息	`hermes skills list`
`hermes skills uninstall`	卸载指定技能，清理对应依赖文件	`hermes skills uninstall codex`

用于版本更新、环境重置、软件卸载，适配迭代升级、环境重置场景。

命令	功能说明	实操示例
`hermes --version`	查看当前 Hermes Agent 安装版本，用于核对升级、兼容性问题	`hermes --version`
`hermes update`	拉取官方最新版本，自动更新程序并重装依赖，保留原有配置	`hermes update`
`hermes uninstall`	卸载 Hermes Agent，可选参数清空所有配置、缓存数据	# 普通卸载（保留配置）`hermes uninstall`# 彻底卸载（清空所有数据）`hermes uninstall --full --yes`
`hermes profile import`	导入自定义配置模板，快速复用他人配置、批量部署环境	`hermes profile import 配置文件路径`