hermes-ops

运维 Hermes Agent 的实战技能。适用于用户提到“运维 hermes”“排查 hermes 问题”“gateway 异常”“平台掉线”“cron 不执行”“profile 配置混乱”“skills 或 tools 不生效”“想让其他 agent 帮忙维护 hermes”时使用。基于 hermes-agent 源码和官方命令入口，优先执行检查、定位、修复、验证四步，杜绝凭感觉随意修改。 具体操作如下： 1. **检查（Check）** - 使用 `hermes-agent status` 查看服务运行状态，确认进程是否存活、端口是否监听。 - 执行 `hermes-agent config check` 校验当前 profile 配置语法及完整性，识别配置混乱或缺失项。 - 检查日志：`tail -f /var/log/hermes-agent/hermes-agent.log`，重点关注 ERROR、WARN 级别日志。 - 验证 gateway 连通性：`hermes-agent gateway ping`，确认与平台通信正常。 - 检查 cron 任务：`crontab -l | grep hermes`，确认定时任务配置正确且未被注释。 2. **定位（Diagnose）** - 若 gateway 异常，运行 `hermes-agent debug gateway` 获取详细握手与认证信息，判断是网络、证书还是权限问题。 - 若平台掉线，结合 `hermes-agent network test` 和平台侧状态，区分是客户端还是服务端故障。 - 若 cron 不执行，检查系统时间、时区、cron 服务状态（`systemctl status cron`），并确认 hermes-agent 路径在 cron 环境变量中。 - 若 skills/tools 不生效，使用 `hermes-agent skill list --verbose` 和 `hermes-agent tool list --verbose` 查看加载状态，排查插件路径、权限或依赖问题。 - 通过 `hermes-agent trace <component>` 开启组件级追踪，精确定位异常模块。 3. **修复（Fix）** - 配置文件问题：依据官方 schema 修正 profile，使用 `hermes-agent config validate` 二次确认后重启服务。 - 服务异常：执行 `hermes-agent restart --clean` 清理缓存并重启，避免残留状态干扰。 - 插件失效：重新安装或更新 skill/tool，确保版本兼容，如 `hermes-agent skill install <name> --force`。 - 权限或环境问题：修正文件权限（如 `chmod 600 ~/.hermes/profile.yaml`），或在 cron 中显式设置 PATH 和 HERMES_HOME。 - 多 agent 协同维护：通过 `hermes-agent delegate --target <agent-id> --task "restart hermes"` 委托其他 agent 执行指定运维操作。 4. **验证（Verify）** - 重启后再次运行 `hermes-agent status` 和 `hermes-agent health`，确认所有组件状态正常。 - 触发一次手动任务（如 `hermes-agent run cron --test`）验证 cron 逻辑是否恢复。 - 观察日志至少 5 分钟，确认无新增错误。 - 使用 `hermes-agent report --summary` 生成运维报告，归档问题根因与修复措施。 始终基于 hermes-agent 官方命令和源码行为进行操作，避免手动修改二进制文件或绕过标准流程。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本