Hermes Agent 命令行速查与运维 SOP

本卡片整理 Hermes Agent 常用 CLI 命令、Profile 管理、网关守护进程、模型配置、终端 Backend 恢复及 Cron 定时任务的高频实用指令。


一、 升级与安装 (Update & Doctor)

# 1. 检查是否有新版本及更新日志
hermes update --check
 
# 2. 执行自动升级(更新 CLI、Python 隔离虚拟环境与依赖)
hermes update
 
# 3. 系统健康诊断自检与自动修复
hermes doctor
hermes doctor --fix

二、 配置模型与终端执行后端 (Model & Terminal Backend)

# 1. 交互式菜单更换模型
hermes model
 
# 2. 命令行一键设置默认模型与 Provider
hermes config set model.default gemini-3.6-flash-high --provider custom
 
# 3. 恢复本地 Terminal 执行后端 (用于从 SSH 模式切回本地)
hermes config set terminal.backend local && hermes config reload
 
# 4. 查看当前使用的模型与终端后端配置
hermes config get model.default
hermes config get terminal.backend

三、 网关守护进程管理 (Gateway Control)

# 1. 查看 Gateway 运行状态与端口
hermes gateway status
 
# 2. 重启 Gateway 网关进程 (重载飞书/平台适配器)
hermes gateway restart
 
# 3. 停止与启动 Gateway
hermes gateway stop
hermes gateway start

四、 定时任务管理 (Cron Jobs)

# 1. 列出系统当前所有定时任务
hermes cron list
 
# 2. 跑一次特定定时任务 (以 ID 测试)
hermes cron run <job_id>

五、 Docker 容器更新一键短别名 (VPS 运维)

up-cli    # 一键平滑更新 CLIProxyAPI 网关容器
up-ignis  # 一键平滑更新 Ignis 知识库看板
up-cf     # 一键平滑更新 Cloudflare Tunnel 隧道
up-all    # 一键更新服务器上的所有 Docker 容器并自动清理垃圾镜像