HermesAgent远程SSH连接：在服务器上运行AI智能体教程
需先配置Python 3.11、Git与uv，再克隆Hermes Agent项目、建虚拟环境、安装依赖、配置SSH目标设备，最后启动服务实现远程命令执行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在远程服务器上运行 Hermes Agent 并通过 SSH 进行连接与管理，则需确保服务器环境已正确配置 Python、Git 及必要依赖，同时完成项目克隆、虚拟环境搭建与服务启动。以下是具体实施步骤：
一、连接并登录云服务器
该步骤旨在建立安全、稳定的远程终端会话，为后续部署提供操作入口。所有命令将在服务器端执行，需使用具备 root 或 sudo 权限的账户。
1、打开本地终端或 SSH 客户端（如 PuTTY、Windows Terminal 或 macOS Terminal）。
2、执行 SSH 登录命令，替换 your_server_ip 为实际服务器公网 IP 地址：
ssh root@your_server_ip
3、输入密码或使用密钥认证完成登录。
二、安装基础运行环境
Hermes Agent 依赖 Python 3.11、Git 和 uv 包管理器，本步骤将统一安装并验证版本兼容性，避免因环境缺失导致后续构建失败。
1、更新系统包索引：
apt update && apt upgrade -y
2、安装 Git 和 curl（Ubuntu/Debian 系统）：
apt install -y git curl wget
3、安装 uv（推荐替代 pip 的现代 Python 包管理器）：
curl -LsSf https://astral.sh/uv/install.sh | sh
4、加载 uv 到当前 shell 环境：
source ~/.cargo/env
5、验证 Python 版本是否满足要求（必须为 3.11.x）：
python3.11 --version
三、克隆与初始化 Hermes Agent 项目
此步骤拉取最新源码及全部子模块，确保 SSH 执行模块（tools/environments/ssh.py）、本地环境适配器等关键组件完整可用。
1、创建工作目录并进入：
mkdir -p ~/hermes && cd ~/hermes
2、克隆主仓库并递归初始化子模块：
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git .
3、若初次克隆未带子模块，补全执行：
git submodule update --init --recursive
四、配置虚拟环境并安装依赖
通过隔离的 Python 虚拟环境避免系统级依赖冲突，同时启用全功能模块支持（含 SSH 远程执行、消息网关、语音等）。
1、使用 uv 创建 Python 3.11 虚拟环境：
uv venv venv --python 3.11
2、激活虚拟环境：
稿定PPT
海量PPT模版资源库
下载
source venv/bin/activate
3、安装 Hermes Agent 及全部可选依赖：
uv pip install -e ".[all]"
4、验证安装是否成功：
hermes --help
五、配置 SSH 远程执行能力
该步骤启用 Hermes Agent 的 tools/environments/ssh.py 模块，使其能作为中控节点向其他设备发起诊断性 SSH 连接，需预置目标设备的认证信息与连接参数。
1、编辑配置文件 ~/.hermes/config.yaml（若不存在则新建）：
mkdir -p ~/.hermes && nano ~/.hermes/config.yaml
2、写入以下 SSH 目标设备配置（示例中目标地址为 192.168.1.100，端口为 22，用户名为 admin）：
environments:
ssh_target:
type: ssh
host: 192.168.1.100
port: 22
username: admin
key_path: /root/.ssh/id_rsa
3、确保私钥文件存在且权限为 600：
chmod 600 /root/.ssh/id_rsa
六、启动 Hermes Agent 服务
启动后 Agent 将监听本地终端输入，并可通过 CLI 指令触发远程 SSH 命令执行，例如采集系统信息、重启服务或读取日志。
1、确保虚拟环境已激活：
source venv/bin/activate
2、启动交互式聊天界面：
hermes
3、在对话中输入自然语言指令，例如：
“请通过 SSH 连接到 192.168.1.100，运行 df -h 并返回磁盘使用情况”
4、Agent 将自动调用 ssh.py 模块完成连接与命令执行，并结构化返回结果。