使用 hermes gateway start 命令让 AI 后台常驻运行

执行hermes gateway start后服务未持续运行，需依次检查命令可用性、启用--daemon模式、注册systemd服务或手动创建service文件

遇到执行 hermes gateway start 命令后服务没跑起来，或者终端一关就停，甚至干脆提示“command not found”？别急，这通常是启动模式没配好、服务没注册成系统守护进程，或者环境压根没初始化到位。下面这几个步骤，能帮你把问题定位清楚并解决掉。

一、确认 Hermes Gateway 命令可用性

这一步是基础排查，目的是确认你的命令行环境已经正确识别了 Hermes 命令。很多时候问题就出在环境变量没生效，导致系统“找不到”这个命令。

1. 先在终端里敲入 which hermes，看看它能不能返回一个类似 /home/username/.local/bin/hermes 的路径。有路径，说明命令是存在的。

2. 如果上面那条命令啥也没输出，那基本可以断定全局命令没注册成功。这时候，你需要重新跑一遍安装脚本，或者手动把 ~/.local/bin 这个目录加到你的 PATH 环境变量里去。

3. 别忘了，修改完环境变量后，执行一下 source ~/.bashrc（如果你用的是 Zsh，就换成 source ~/.zshrc）来刷新一下当前会话，让改动立刻生效。

二、使用 --daemon 参数启用后台常驻模式

如果命令找到了，但服务还是随着终端退出而停止，那很可能你缺了一个关键参数。直接用 --daemon 参数启动，能让 Gateway 转为后台守护进程模式，彻底脱离终端会话的束缚。

1. 首先，确保 Hermes 的初始配置已经完成，并且 ~/.hermes/.env 这个配置文件存在，里面的访问凭证也都是有效的。

2. 接下来，在终端输入：hermes gateway start --daemon。

3. 命令执行后如果没有报错，服务就已经在后台跑起来了。你可以通过 ps aux | grep hermes 这个命令来查验一下相关进程是否存在。

4. 需要停止服务的时候，运行 hermes gateway stop 即可。

三、注册为 systemd 系统服务（推荐长期部署）

对于需要7x24小时稳定运行，或者希望开机自启的生产环境，把 Hermes Gateway 注册为 systemd 系统服务是最规范、最省心的选择。它能提供自动重启、日志集中管理等一系列高级功能。

1. 执行命令来生成服务文件：hermes gateway setup-service。注意，有些旧版本可能需要先运行 hermes gateway setup 完成交互式配置。

2. 启用并立即启动服务：sudo systemctl enable --now hermes-gateway.service。

3. 查看服务的运行状态：sudo systemctl status hermes-gateway，如果一切正常，你会看到 active (running) 的提示。

4. 想实时追踪服务日志？用这个命令：sudo journalctl -u hermes-gateway -f。

四、手动创建 systemd 服务文件（兼容旧版或自定义路径）

如果官方提供的 setup-service 子命令在你的版本里不可用，或者你需要对安装路径、运行用户进行自定义，那么手动创建 systemd 单元文件就是你的不二之选。关键在于确保文件里的路径和变量都准确无误。

1. 创建服务文件：sudo nano /etc/systemd/system/hermes-gateway.service。

2. 将以下内容写入文件（请务必将 /home/youruser 替换成你实际的用户主目录）：

[Unit] Description=Hermes Gateway Service After=network.target [Service] Type=simple User=youruser WorkingDirectory=/home/youruser/.hermes EnvironmentFile=/home/youruser/.hermes/.env ExecStart=/home/youruser/.local/bin/hermes gateway start --no-interactive Restart=always RestartSec=10 [Install] WantedBy=multi-user.target

3. 保存退出后，重载 systemd 配置并启动服务：sudo systemctl daemon-reload && sudo systemctl enable --now hermes-gateway。

4. 最后，验证一下服务是否成功加载并启用：执行 systemctl list-unit-files | grep hermes，如果看到状态显示为 enabled，就大功告成了。