HermesAgent如何切换到本地后端运行模式

一、修改config.yaml配置文件

想让Hermes Agent摆脱网络和容器的束缚，直接在宿主机上“裸奔”执行命令吗？切换到Local本地模式就能实现。这个模式特别适合开发调试，或者在你完全信任的环境里快速跑任务。它的原理很简单：所有指令都会直接调用宿主机的shell进程，权限和环境变量都取决于当前运行的用户。下面，咱们就一步步把它切换到本地模式。

首先，也是最关键的一步，就是修改配置文件。Local模式需要在config.yaml里明确声明后端类型，并指定一个有效的系统用户，这样Agent才知道该以谁的身份去执行命令。这是切换成功的基石。

1. 找到Hermes Agent的配置文件config.yaml。它通常放在/etc/hermes/目录下，或者在你项目根目录的conf/子文件夹里。

2. 用你顺手的文本编辑器打开这个文件，找到专门配置backend的那个部分。如果找不到，那就手动添加一个。

3. 在backend配置节里，把type字段的值改成local。

4. 接着，在local这个子节下，设置user字段。这里要填一个当前系统里真实存在的用户名，比如hermes-user，甚至是root（当然，用root要格外小心，确保你清楚它的权限范围）。

二、验证并应用配置变更

配置文件改好了，但事情还没完。必须重启服务让新配置生效，同时还得确认Agent确实在以你指定的用户身份干活，否则可能会因为权限问题导致命令执行失败。

1. 保存好你修改的config.yaml文件。

2. 执行命令 hermesctl restart。这个操作会重新加载配置，并重启Hermes Agent的服务进程。

3. 重启后，别急着走，运行一下 hermesctl status 来检查服务状态。你需要确认两件事：一是backend类型已经显示为local，二是进程处于正常的running状态。

4. 最后，来个简单的验证。执行一条诸如 hermes run “whoami” 这样的命令，看看输出结果是不是和你在config.yaml里设置的user字段一致。如果一致，恭喜你，切换就大功告成了。