执行hermes gateway start后服务未持续运行，需依次检查命令可用性、启用--daemon模式、注册systemd服务或手动创建service文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您执行 hermes gateway start 命令后发现服务未持续运行、终端退出即停止，或提示“command not found”，则可能是由于启动模式配置缺失、服务未注册为系统级守护进程，或环境未完成初始化。以下是解决此问题的步骤：
一、确认 Hermes Gateway 命令可用性
该步骤用于验证当前 shell 环境是否已正确加载 Hermes 全局命令，避免因 PATH 未更新或安装脚本未生效导致命令不可用。
1、在终端中执行 which hermes，检查是否返回类似 /home/username/.local/bin/hermes 的路径。
2、若无输出，说明全局命令未注册，需重新执行安装脚本或手动将 ~/.local/bin 加入 PATH。
3、执行 source ~/.bashrc（或 source ~/.zshrc）刷新环境变量。
二、使用 --daemon 参数启用后台常驻模式
该方法通过内置守护进程机制使 Gateway 在后台静默运行，不依赖终端会话生命周期，适合日常稳定使用。
1、确保 Hermes 已完成初始配置，且 ~/.hermes/.env 文件存在并包含有效凭证。
2、在终端中输入：hermes gateway start --daemon。
3、执行后无报错即表示已进入后台；可通过 ps aux | grep hermes 查看进程是否存在。
4、如需停止，运行：hermes gateway stop。
三、注册为 systemd 系统服务（推荐长期部署）
该方式将 Hermes Gateway 注册为 Linux 系统级服务，支持开机自启、自动重启、日志集成与状态管理，适用于生产或免值守场景。
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、重载配置并启动：sudo systemctl daemon-reload && sudo systemctl enable --now hermes-gateway。
4、验证服务是否加载成功：systemctl list-unit-files | grep hermes，应显示 enabled。
