Hermes Agent 跨平台部署：服务器、容器与边缘盒的三场景指南

同一个 Hermes Agent，既要在全配置的云服务器上跑完整的终端工具链，又要在批量任务里按需唤醒、闲时休眠，还能塞进一块 4G 内存的边缘盒子。本文把这三条 Agent 跨平台部署路径拆成可敲的命令，读完即可动手。

🧭 部署选型速览：先定位你属于哪种场景

🖥️ 场景 A：标准服务器上跑通

克隆仓库并装好依赖

先把仓库拉下来，再用官方安装脚本补齐运行时——它会处理 uv、Python、Node.js、ripgrep 这些依赖，不用你逐个装：

git clone https://gitcode.com/GitHub_Trending/he/hermes-agent curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.bashrc

按适用时机区分两种服务类型

• OpenAI 兼容端点：调用 OpenAI、OpenRouter 或自建 vLLM/SGLang 推理服务时用，指向地址即可，Hermes 只关心接口不关心后端。
• 本地模型服务：网络隔离或不想付 API 费用时用，同机起一个 Ollama 之类的小服务即可。

两者之间用hermes model一条命令切换，不改代码。

验证安装是否成功

装完跑健康检查再进对话，有问题当场暴露：

hermes model # 选定服务商和模型 hermes doctor # 体检各项依赖与配置 hermes # 进入终端会话

📦 场景 B：容器化批量启动与托管平台部署

什么时候该上容器或 Modal

需要多个相互隔离的实例、或服务器大部分时间闲置不想白付钱时，就该换容器或托管方案。仓库的终端后端原生支持 Docker、Singularity、Modal、Daytona、Vercel Sandbox 等，其中 Modal 和 Daytona 带无服务器持久化：环境闲时休眠、按需唤醒，空闲期成本趋近于零。

用仓库自带 Dockerfile 构建启动

镜像入口就是仓库根目录的 Dockerfile。下面这条命令构建并启动容器，挂载卷把可写状态放在/opt/data，容器销毁后数据仍在：

docker build -t hermes-agent . docker run -it --rm -v ~/.hermes:/opt/data hermes-agent

📱 场景 C：边缘设备轻量部署

先确认硬件底线

双核 CPU、4G 内存、10G 可用磁盘是底线，再低就别硬上了，装完也转不动。

砍掉什么、保留什么

砍：语音转写、文本转语音、图片生成、云浏览器——这些是吃带宽和内存的周边能力。保留：终端工具链、文件操作、小模型对话循环，以及本地存储的内存与技能系统，它们在边缘盒上几乎零额外开销。

一条配置指向 CPU-only 轻量模型

把模型切到本地 3B 级别，再进配置把砍掉的能力逐项关闭：

hermes model # 选定本地轻量模型（Ollama 或小端点） hermes config set --help # 找到语音、图像、浏览器等开关并关闭

🛠️ 上线之后：监控、排障与终止

看一眼整体健康

hermes doctor随时输出诊断；要持续指标就看 agent/monitoring/ 里的网关健康检查与 OTel 导出模块。

连接失败按这三步查

• 先跑hermes doctor，确认端点地址与密钥是否读对；
• 再curl <端点>/models验证可达性，不通就查防火墙与端口；
• 还不行，换一台同网段机器测，排除目标服务本身宕机。

内存或 CPU 顶不住了

用hermes tools关掉用不到的工具；长会话用/compress压缩上下文；仍紧张就/model换更小的模型，动作成本最低。

一键终止所有实例

单机场景在终端Ctrl+C或会话内发/stop；容器批量场景用下面两条命令收尾：

docker ps --filter name=hermes docker stop $(docker ps -aq --filter name=hermes)

📚 延伸资源

• Dockerfile：镜像构建入口，能核对基础系统与/opt/data状态布局。
• agent/：Agent 主循环、模型接入与工具执行的实现所在。
• agent/monitoring/：网关健康、事件发射与指标导出。
• apps/desktop/README.md：桌面端构建与端到端测试入口。
• CONTRIBUTING.md：开发环境搭建与完整测试方法。

从云上的服务器到桌角的边缘盒，变的是 Hermes Agent 跑在哪里，不变的是那套配置——一份命令写对，就能跟着你搬到任何一台机器上。