在 Ubuntu 上从 0 到 1 搭建 Hermes Agent 实战指南

大家好！我是写代码的中年人！最近 Hermes Agent 非常火爆，已超过 OpenClaw的热度。本次我们就从0安装体验一下 Hermes Agent，来看下它和 OpenClaw 有什么不同。

Hermes Agent 是由Nous Research 开发的一款开源自主 AI 智能体，以 MIT 协议发布。与传统的 AI 对话工具不同，Hermes Agent 被设计为一个运行在服务器上的持久化 Agent，它拥有自主记忆、技能学习、定时任务和多平台通信等核心能力，能够随着使用时间的增长不断进化和成长。

Hermes Agent 的特性有哪些呢？结合官网文档，我们聊一聊：

最近Skill非常火，Hermes Agent 有一个闭环学习机制：Agent 会根据每次完成的任务信息，自动创建技能(Skill)，并在后续同类任务中自动复用，越用越聪明。

Hermes Agent 基于 SQLite FTS5 全文检索的记忆系统并配合 Honcho 用户建模，Agent 能记住你的偏好、项目背景和历史上下文。

Hermes Agent 可以支持多平台接入，一个 Agent 实例可同时接入 Discord、Slack、WhatsApp、Signal、Email、Home Assistant、DingTalk、飞书、企业微信等 15+ 平台的消息网关。

Hermes Agent 支持任意模型接入，如 OpenAI、DeepSeek、GitHub Copilot、Kimi/Moonshot、MiniMax 等几乎所有主流 LLM 提供商，随时通过 hermes model 切换，无需修改任何代码。

Hermes Agent 支持多种后端交互，如 本地、Docker、SSH、Daytona、Singularity、Modal，支持容器隔离与 Serverless 持久化执行。多行编辑、斜杠命令自动补全、实时 Token 用量监控、流式工具输出，专为终端用户打造。

Hermes Agent 支持定时自动化任务，它内置 Cron 支持，可用自然语言描述定时任务，通过消息网关自动推送结果。

Hermes Agent 可对MCP协议进行支持，可接入任何MCP，来扩展能力。

说了那么多，Hermes Agent 有哪些适用场景呢？

开发者：需要一个能执行终端命令、操作文件、搜索代码库、跨 IDE 协作的智能助手。

研究人员：需要批量处理数据、生成训练轨迹、调用多模型对比实验的工具。

运维工程师：需要一个可挂载到飞书等终端上、定期检查服务状态并汇报的自动化 Agent。

普通用户：希望在手机上通过终端软件随时访问一个运行在云服务器上的私人 AI 助手。

下面我们就来实战安装：

Hermes Agent 官方支持Linux（包括 Ubuntu）、macOS 和 WSL2。原生 Windows 不受支持，请通过 WSL2 使用。以下是 Ubuntu 上的建议配置：

需要准备 LLM API 密钥

Hermes Agent 需要连接至少一个 LLM 提供商。以下是常用选项：

我们开始进行实战安装：

Hermes Agent 提供了一个一键安装脚本，会自动完成所有依赖安装、仓库克隆、虚拟环境创建和全局命令配置，安装时间依据你的网络配置。

打开 Ubuntu 终端，执行以下命令：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

等待安装程序执行完成：

然后验证安装是否成功：

hermes version   # 显示当前版本号hermes doctor    # 运行诊断，确认所有组件正常hermes status    # 查看配置状态

如果 hermes doctor 输出全部绿色，说明安装完全正常。如果出现黄色警告，通常是可选功能（如语音）未安装，不影响核心使用。

输入 hermes 进入命令交互界面:

接下来我们对Hermes Agent进行基本配置：

LLM 提供商与模型配置：

输入一下命令进行配置：

hermes model

程序向导会列出所有支持的提供商，可用方向键选择，按 Enter 确认。以下是国内用户常用的选项：

一旦配置完成，随时可以通过 hermes model 重新切换，无需重启，也无需修改任何配置文件。

如果你想进行全量全量配置如模型提供商、工具、消息平台等，可运行：

hermes setup

Hermes Agent 内置了大量工具，可通过以下命令管理：

hermes tools              # 查看并配置当前启用的工具

默认启用的工具集包括：网页搜索、终端命令执行、文件操作、代码执行、图像生成等。

CLI 的使用指南：

Hermes Agent 的 CLI是一个完整的终端用户界面，支持多行编辑、斜杠命令自动补全、会话管理、实时 Token 监控等功能。

启动对话

hermes                    # 启动交互式对话（默认）hermes chat -q "你好"     # 单次查询模式hermes --continue         # 恢复最近一次会话hermes -c                 # 同上，简写形式hermes --resume <id>      # 按 Session ID 恢复特定会话

键盘快捷键

斜杠命令参考

在输入框中键入 / 会弹出命令自动补全菜单。常用命令如下：

启动网关配置向导：

hermes gateway setup

配置网关的守护进程模式：

我们以守护进程方式运行网关，确保服务器重启后自动恢复：

sudo nano /etc/systemd/system/hermes-gateway.service

Unit]Description=Hermes Agent GatewayAfter=network.target[Service]User=你的用户名WorkingDirectory=/home/你的用户名ExecStart=/home/你的用户名/.local/bin/hermes gateway runRestart=alwaysRestartSec=10[Install]WantedBy=multi-user.target

保存后启用服务：

sudo systemctl daemon-reloadsudo systemctl enable hermes-gatewaysudo systemctl start hermes-gatewaysudo systemctl status hermes-gateway

定时自动化任务：

Hermes Agent 内置了自然语言 Cron 功能，你可以用日常语言描述定时任务，Agent 会自动创建 Cron 作业并通过消息网关推送结果。

创建定时任务

直接在对话中描述你的需求：

每天早上 9 点检查 Hacker News 的 AI 新闻并发摘要到飞书每小时检查一次服务器内存使用率，超过 90% 时发送告警每周一早上 8 点发送本周待办任务列表

Agent 会自动设置 Cron 作业，此后便会按时执行并推送结果，无需任何额外操作。

管理定时任务：

hermes cron list       # 列出所有定时任务hermes cron pause <id> # 暂停指定任务hermes cron resume <id># 恢复任务hermes cron delete <id># 删除任务

Docker 沙箱后端：

为了安全地执行 Agent 生成的代码，强烈建议启用 Docker 沙箱：

首先确保 Docker 已安装：

curl -fsSL https://get.docker.com | bashsudo usermod -aG docker $USER && newgrp docker然后切换

Agent 的终端后端：

hermes config set terminal.backend docker也可以通过

Docker Compose 直接运行整个 Hermes Agent 的容器化实例：

mkdir -p ~/.hermesdocker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setupdocker run -d --name hermes --restart unless-stopped --memory=4g --cpus=2   -v ~/.hermes:/opt/data nousresearch/hermes-agent gateway run

多 Profile 并行运行：

Hermes Agent 支持运行多个隔离的 Agent 实例，适合将工作、个人、测试等场景分开：

hermes --profile work          # 使用 work Profilehermes --profile personal      # 使用 personal Profile

每个 Profile 有独立的配置、记忆和会话，互不干扰。

MCP 服务器集成：

通过 Model Context Protocol，可以为 Agent 扩展连接 GitHub、数据库等外部工具。在 ~/.hermes/config.yaml 中添加：

mcp_servers:  github:    command: npx    args: ["-y", "@modelcontextprotocol/server-github"]    env:      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

语音模式：

安装语音扩展后可启用 CLI 麦克风输入和 TTS 朗读功能：

pip install "hermes-agent[voice]"pip install faster-whisper   # 推荐：本地免费语音识别

在Hermes 对话中启用：

/voice on

按Ctrl+B 开始录音，或用 /voice tts 让 Agent朗读回复。

常见问题与故障排查：

在运行中如果我们遇到任何问题，优先运行以下诊断命令：

hermes doctor    # 自动诊断并给出修复建议hermes chat --verbose   # 查看详细调试日志

更新与卸载：

更新 Hermes Agent，更新到最新版本只需一条命令：

hermes update

更新过程不会影响你的配置、记忆和技能数据，所有用户数据均安全保留在 ~/.hermes/ 目录中。

卸载

如果需要完全卸载，执行以下步骤：

rm ~/.local/bin/hermes                  # 删除全局命令rm -rf ~/hermes-agent                   # 删除仓库（按实际克隆路径）rm -rf ~/.hermes                        # 删除所有配置和数据（不可逆！）