Hermes Agent 部署实战教程：从一行安装到 Telegram 机器人、自托管网关与 Docker 生产化

Hermes Agent 是 Nous Research 在 2025 年推出、并在 2026 年快速演进的一款”自托管 + 自我进化”型 AI 智能体。官方定位与同类开源 Agent 的最大差异在于：它把对话记忆、技能库、与外部工具的执行回路全部开放给用户私有化部署，并且内置了Honcho 辩证式用户建模 + FTS5 跨会话检索 + 周期性自我改进三层”自主学习”机制。本教程是一份按步骤走完就能落地的实战指南，覆盖从一行安装、配置向导、模型选型，到 Docker 生产化自托管、Telegram 机器人接入、systemd 服务化，以及常见踩坑与排错。

本文命令、版本、文件路径均来自 hermes-agent.nousresearch.com 官方文档（zh-Hans、en）以及多位社区作者的实操经验文，所有外部链接在文末统一列出。

一、为什么选 Hermes Agent

在动手部署之前，先对齐它的能力边界。Hermes Agent 不是”又一个大模型壳”，而是一个能放进本地或私有云的消息网关 + 工具执行 + 记忆系统集合体。官方把它定义为”具有自托管、可扩展、可观察、自我改进特性的个人 AI 助手”，具备如下几层支撑：

多模型接入：内置 Nous Portal（官方 OAuth 通道，开箱即用）、OpenRouter（200+ 模型）、OpenAI、MiniMax OAuth、Kimi、xAI Grok OAuth、OpenAI Codex OAuth 等多种 LLM 供应商。
多终端隔离：支持本地 shell、Docker 容器、SSH 远程、Singularity/Apptainer、Modal（云端无服务器）、Daytona（开发空间）六种 terminal backend。
多消息平台：同时挂载 Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost、Email、SMS、钉钉、飞书、企业微信、微信公众号、iMessage（BlueBubbles）、QQ Bot、元宝、Microsoft Teams、LINE、ntfy、Home Assistant、Google Chat 等 20+ 通道。
自我进化：Honcho 辩证式用户建模 + 本地 FTS5 跨会话检索 + 周期性”自我改进”提示词推送（agent-curated memory with periodic nudges）。
MCP 协议：完整支持 Anthropic 提出的 Model Context Protocol，可用社区已有的 MCP server 一键扩展工具集。

理解了这些，就能避免把 Hermes Agent 当作单纯的命令行玩具。它能做出真正可用的聊天机器人、私人知识库助理、自定义工作流代理，关键在于把上面这五层都打通。

二、环境与前置

Hermes Agent 安装脚本会自动准备 Python 3.11、uv、Node.js 22、ripgrep、ffmpeg、PortableGit，但在跑安装脚本前，机器本身需要满足：

项目	最低要求	推荐配置
操作系统	Linux / macOS / WSL2 / Windows 原生 / Termux (Android)	Ubuntu 22.04+ / macOS 13+ / Windows 11 原生 PowerShell
Python	3.10+	3.11（安装脚本自动装）
Node.js	18+	22（安装脚本自动装）
Git	任意	PortableGit（Windows 自动装）
内存	4 GB	16 GB（不调用本地大模型时）
磁盘	10 GB	50 GB（带 Docker 镜像时）
网络	能访问 github.com、hermes-agent.nousresearch.com	同上；如在国内，到官方文档站的速度受 DNS 影响

如果机器上已有 Python 3.10+ 与 Git，可以跳过内置依赖安装。如果用 Linux 跑 systemd 服务化，需要当前用户能执行 loginctl enable-linger <user>，否则 hermes gateway install 安装的 user service 会在登出后停掉。

三、一行安装

3.1 Linux / macOS / WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

这一行做四件事：检测当前 OS；通过 pipx 或 uv tool install 注入 hermes 命令；补齐 Python 3.11、Node.js 22、ripgrep、ffmpeg；最后写入 PATH。装完要重新加载 shell：

source ~/.bashrc
hermes --version

3.2 Windows 原生（PowerShell）

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Windows 的 install.ps1 与 Linux 安装脚本最终目标一致，只是改用 winget 或 Scoop 拉依赖；如果机器没装包管理器，它会下载嵌入式 PortableGit、嵌入式 Python 3.11，并把 hermes 入口写入 %LOCALAPPDATA%\hermes\bin\hermes.cmd。

3.3 Android / Termux

Termux（Android F-Droid 商店可装）跑同一行 shell 即可；安装脚本会自动切换到 Termux 的 proot-distro 内装 uv 与 Node，不建议在 root 设备上直接跑。

3.4 装完验真

hermes --version      # 输出版本号
hermes doctor         # 体检：检测 Python、Node、ripgrep、ffmpeg、网络

hermes doctor 是上手阶段的最佳搭档，它会逐项打勾；如果某行显示红色 FAIL，按提示补依赖即可（最常见的是 ripgrep 与 ffmpeg 在最小镜像里没装）。

四、目录结构与配置优先级

第一次启动后，Hermes 会在用户主目录建一个工作目录，路径因平台而异：

Linux / macOS / WSL2 / Termux：~/.hermes/
Windows 原生：%LOCALAPPDATA%\hermes\（等价 C:\Users\<you>\AppData\Local\hermes\）

目录包含以下几项（来自官方文档）：

~/.hermes/
├── config.yaml         # 非敏感配置（明文）
├── .env                # 敏感配置（API key、token，建议 600 权限）
├── auth.json           # 厂商 OAuth refresh token 自动存放
├── SOUL.md             # 个性化文档（agent 自描述、可被自身读取）
├── memories/           # 长记忆 / 摘要
├── skills/             # 本地技能库（每条 skill 一个 .md）
├── cron/               # 定时任务定义
├── sessions/           # 会话存档
└── logs/               # 运行日志

优先级（从高到低）：命令行参数 > config.yaml > .env > 默认值。这意味着：用 hermes --provider openrouter --model anthropic/claude-3.5-sonnet 启动时，会临时覆盖 yaml 里的同名设置；.env 适合放 API key（不会随 yaml 进 git），配置细节（门户、模型偏好、终端后端）放 config.yaml。

.env 的权限：Linux / macOS 用 chmod 600 ~/.hermes/.env 是公认的安全姿势；Windows 上 NTFS 默认 ACL 已经够用，避免把目录放进 OneDrive 同步盘。

五、第一次启动：hermes setup 向导

最省事的接入路径是 Nous Portal（官方 OAuth）。执行：

hermes setup

如果你只想要”最快的官方账户路径”，可以一步：

hermes setup --portal

向导会问：

是否登录 Nous Portal（推荐）— 浏览器弹出 OAuth，确认后 auth.json 里就会写好 refresh token；
是否要追加别的供应商 — 推荐至少加一个 OpenRouter，便于在 gateway 里动态切模型；
终端后端偏好 — 选 local 让它直接用本机 shell；想隔离就用 docker；
是否启用记忆与 Honcho 用户建模 — 默认开；
是否启用 tirith（命令行执行前安全审计，默认开）；
是否现在接入 Telegram / Discord 等消息平台（跳过也无所谓，后面用 hermes gateway setup 单独配）。

走完整套耗时约两分钟，最后输出 Hermes is ready.，并且在 ~/.hermes/config.yaml 写入了对应项。向导跑过一次后，所有配置都能用 hermes config set <key> <value> 独立修改，例如：

hermes config set provider openrouter
hermes config set model anthropic/claude-3.5-sonnet
hermes config set terminal.backend docker
hermes config set web.backend firecrawl
hermes config check        # 检查所有键是否合法
hermes config migrate      # 从旧版本配置平滑迁移

不建议在还没配好 LLM key 前就启动 gateway，否则会在日志里刷一堆 401 噪音。

六、LLM 供应商怎么选

Hermes 不强制绑死某一家的模型。官方文档列出的可选供应商与典型配置（~/.hermes/.env 片段）：

# 1) Nous Portal（OAuth，推荐）
NOUS_PORTAL_REFRESH_TOKEN=__OAUTH_AUTO__

# 2) OpenRouter（200+ 模型，单一 key）
OPENROUTER_API_KEY=sk-or-v1-...

# 3) OpenAI 兼容
OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://api.openai.com/v1   # 也可换成任何兼容 endpoint

# 4) Anthropic / Kimi / xAI ...
ANTHROPIC_API_KEY=sk-ant-...
KIMI_API_KEY=sk-kimi-...

# 5) OpenAI Codex OAuth / MiniMax OAuth
# 见官方 docs/zh-Hans/user-guide/authentication 页

选型的实际经验：

个人玩具 / 学习用：直接 Nous Portal OAuth，免去 key 申请。
严肃生产：用 OpenRouter 选 Anthropic Claude 3.5 Sonnet / Sonnet 4.x / Gemini Pro 一类长上下文模型，Hermes 的 tool-call 与 FTS5 检索在长上下文场景里受益最大。
国内部署：OpenAI 直连不稳定，可改 OpenAI 兼容的国内代理（DeepSeek、火山方舟、阿里百炼），把 OPENAI_BASE_URL 指向代理的 /v1 路径。
多供应商切换：在 config.yaml 里写 provider_fallback: [openrouter, openai, nous_portal]，主供应商失效时自动切到下一个。

七、六种终端后端

这是 Hermes 区别于普通 ChatGPT wrapper 的关键设计：智能体的”执行代码”这一步，可以在六种不同的隔离环境里跑。

7.1 本地（默认）

# config.yaml
terminal:
  backend: local
  allowed_commands:
    - "git *"
    - "pytest -q *"
    - "python -m *"

适合：开发者本机做”AI 配对编程”，agent 直接在你 shell 里执行。强烈建议用 allowed_commands 白名单 + 启用 tirith，否则 agent 能 rm -rf 全盘。

7.2 Docker（推荐做隔离）

terminal:
  backend: docker
  docker:
    image: "nikolaik/python-nodejs:python3.11-nodejs20"
    network_mode: bridge
    memory_limit: "4g"
    cpu_quota: 1.5
    read_only_fs: false

每次执行命令都在新建容器，结束后容器销毁，干净。镜像 nikolaik/python-nodejs 是社区维护的”Python+Node 二合一”通用镜像，覆盖 hermes 默认工具链。

Docker 后端的可观测性也比 local 好：可以用 docker ps -a 看每次任务留下的容器与日志。

7.3 SSH（远程跳板）

terminal:
  backend: ssh
  ssh:
    host: dev.example.com
    user: hermes
    key_file: "~/.ssh/hermes_ed25519"

适合让 hermes 跑在你自己的开发服务器上，本机只是个客户端；key 文件建议 ed25519。

7.4 Singularity / Apptainer（HPC 场景）

科研与超算用户常用，可在 SLURM 节点跑 hermes，调用集群上的软件栈。backend: singularity，镜像用 sif 文件路径。

7.5 Modal（云端无服务器）

terminal:
  backend: modal
  modal:
    app_name: "hermes-$$"
    gpu: "T4"
    timeout: 600

适合偶尔跑重计算（图像转码、大模型评测）。Modal 按秒计费，记得加 timeout 上限避免失控。

7.6 Daytona（开发空间）

Daytona 提供”开发容器”概念，适合需要长期保留工作目录的研发型 agent。Hermes 把每次会话挂到一个 Daytona workspace；底层类似 Code-Server。

实际建议：本地用 docker 起步；要跑生产网关再切 ssh 或 local + systemd；只在确实需要弹性算力时才用 Modal / Daytona。

八、Docker 生产自托管

想把 Hermes 部署到一台永远在线的服务器（自己的 NAS、家里的小主机、外面的云主机），官方推荐镜像 nousresearch/hermes-agent:latest + docker-compose。下面是一个社区作者（CSDN 161568267）经过实战检验的最小可用 compose 文件：

version: "3.9"

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes-agent
    restart: unless-stopped
    ports:
      - "8642:8642"   # gateway / API
      - "9119:9119"   # 内置仪表盘
    environment:
      TZ: Asia/Shanghai
      NOUS_PORTAL_REFRESH_TOKEN: ${NOUS_PORTAL_REFRESH_TOKEN}
      OPENROUTER_API_KEY: ${OPENROUTER_API_KEY}
      GATEWAY_ALLOWED_USERS: ${GATEWAY_ALLOWED_USERS}
      TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN}
      TELEGRAM_ALLOWED_USERS: ${TELEGRAM_ALLOWED_USERS}
      DASHBOARD_PASSWORD: ${DASHBOARD_PASSWORD}
    volumes:
      - ${HOME}/.hermes:/opt/data
      - ./logs:/var/log/hermes

配套 .env：

NOUS_PORTAL_REFRESH_TOKEN=
OPENROUTER_API_KEY=sk-or-v1-...
GATEWAY_ALLOWED_USERS=alice,bob
TELEGRAM_BOT_TOKEN=123456789:ABCdef...
TELEGRAM_ALLOWED_USERS=123456789
DASHBOARD_PASSWORD=strong-password

启停：

docker compose pull
docker compose up -d
docker compose logs -f hermes-agent

健康检查：

curl http://localhost:8642/health        # -> {"status":"ok"}
# 浏览器打开 9119 端口看仪表盘（默认需要 DASHBOARD_PASSWORD）

数据持久化只放在 ${HOME}/.hermes:/opt/data 一个挂载，会话、记忆、技能、cron 定义都活在里面；升级镜像时只要这条卷在，不丢数据。

若放在公网，一定要：

把 9119 仪表盘端口用 Nginx 反代 + basic auth 拦一道；
用 GATEWAY_ALLOWED_USERS 限制 Telegram/Discord 等通道的用户白名单；
把 DASHBOARD_PASSWORD 设成至少 16 位随机串；
挂上 cloudflare 或者自建 fail2ban，挡住 8642 端口的扫描。

九、Telegram 机器人接入

Telegram 是 Hermes 上手最快、最直观的实战演练对象。从 @BotFather 拿 token，到在你的 .env 配好用户白名单，10 分钟能跑通。

9.1 申请 Bot Token

用个人 Telegram 搜索 @BotFather；
发 /newbot；
按提示输入 name（如 MyHermesBot）和 username（必须以 bot 结尾，如 my_hermes_2026_bot）；
BotFather 返回一个 token，形如 123456789:ABCdefGHIjklMNopqrSTUvwxYZ。

9.2 拿到用户 ID

Hermes 的用户白名单只能接受纯数字 ID，不接受 @username。在 Telegram 里搜索 @userinfobot，对它发任意消息，它会回你 Id: 123456789，把数字存下来。

9.3 写入 .env

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNopqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789,987654321     # 多人用英文逗号分隔

注意：

必须是数字 ID，不是 @xxx；
多号用半角 ,，首尾无空格；
这是强白名单，未列在里面的用户发的消息 Hermes 不处理；
如果临时想接收所有用户，把 GATEWAY_ALLOW_ALL_USERS=true（警告：仅适合测试）。

9.4 重启 gateway

hermes gateway setup         # 交互式配置（也可全部用 env 跳过）
hermes gateway restart
hermes gateway status        # 看每个 channel 的连接状态
hermes gateway logs --tail 50

打开 Telegram 给你的 bot 发 /start，应该看到 Hermes 的欢迎语；发 /help 会列出所有内置斜杠命令。

十、20+ 消息平台支持

Hermes 抽象出统一 gateway，剩下的就是”平台通道插件”。除 Telegram 外：

开箱即用的高优先级：Discord、Slack、WhatsApp、Signal、Matrix、Mattermost、Email (SMTP/IMAP)、SMS (Twilio)、Microsoft Teams、Google Chat、LINE、ntfy。
中国开发者友好：钉钉、飞书、企业微信、微信公众号（Weixin）、QQ Bot、腾讯元宝。
Apple 生态：BlueBubbles（把 iMessage 接到 hermes，需要 macOS 服务器 + 越狱手机或旧 Mac）。
物联网 / 智能家居：Home Assistant。

每个平台在 ~/.hermes/config.yaml 有独立段落，例如飞书的最小配置：

messaging:
  backends:
    feishu:
      enabled: true
      app_id: "cli_xxx"
      app_secret: "..."
      allowed_users:
        - "ou_xxx"

实际工程经验：先在 Telegram / Discord 上跑通整条链路，再照葫芦画瓢把别的平台挂上。Hermes 对每个平台的 token 都支持热加载，无需在改配置后重启整套。

十一、服务管理与开机自启

gateway 跑起来后，最好用 systemd / launchd 托管，避免 SSH 登出进程被杀。

11.1 Linux / WSL2

hermes gateway install                  # 当前用户的 systemd service
sudo hermes gateway install --system    # 整机的 systemd service（开机自启）

systemctl --user status hermes-gateway
journalctl --user -u hermes-gateway -f  # 跟日志
loginctl enable-linger $USER            # 让 user service 在登出后继续

enable-linger 那一步是用户级别 service 的”开机自启”，不执行的话重启机器后进程不会起来。

11.2 macOS

hermes gateway install    # 自动写 ~/Library/LaunchAgents/com.hermes.agent.gateway.plist
launchctl list | grep hermes
launchctl unload ~/Library/LaunchAgents/com.hermes.agent.gateway.plist
launchctl load   ~/Library/LaunchAgents/com.hermes.agent.gateway.plist

11.3 Windows

Windows 用 Task Scheduler，把 hermes gateway 包装进 schtasks /Create /SC ONSTART。

十二、21+ 斜杠命令速查

Hermes 内置命令很多，下面是日常最常用的几个，来源是 hermes-agent.nousresearch.com docs 的 messaging 章节：

命令	用途	示例
/new	开新会话	/new （清空上下文）
/model	当前会话切换模型	/model openrouter:anthropic/claude-3.5-sonnet
/personality	切换人设	/personality concise
/retry	重跑上一条	/retry
/undo	撤销上一条工具调用	/undo
/status	看会话/网关状态	/status
/whoami	显示当前平台、用户 ID	/whoami
/stop	停止当前任务	/stop
/approve	放行危险命令	/approve
/deny	拒绝危险命令	/deny
/sethome	把当前 channel 设为默认	/sethome telegram
/compress	手动触发上下文压缩	/compress
/title	给会话起标题	/title Hermes 实战
/resume	恢复历史会话	/resume 2026-09-04-001
/usage	看 token 用量	/usage
/insights	查看 Honcho 用户画像	/insights
/reasoning	切换推理深度	/reasoning medium
/voice	切换 TTS/STT	/voice on
/rollback	回滚到上一稳定状态	/rollback
/bg	把任务后台跑	/bg pytest -q
/btw	旁注式提问	/btw 那行代码什么意思？
/reload-mcp	重载 MCP servers	/reload-mcp
/update	升级 hermes 自身	/update
/help	查看帮助	/help
/verbose	切换调试日志	/verbose on
/platform	查看当前消息平台	/platform

十三、安全白名单、配对码与命令审计

AI Agent 一旦被放到消息平台，就是”远程命令执行器”。Hermes 把安全设计分成四层：

用户白名单：每个 channel 各自的 allowed_users；并通过 GATEWAY_ALLOWED_USERS 统一再筛一遍。
配对码（pairing）：新用户发 /pair 时给她一个一次性配对码，到管理员侧用 hermes pairing approve <platform> <code> 放行，避免 Telegram 用户 ID 漂移带来的风险。
命令审计（Tirith）：每个即将执行的 shell 命令会被 tirith（Hermes 内置安全引擎）插桩扫描，发现 rm -rf /、curl | sh、chmod 777 / 这类高危模式直接拒绝并要求 /approve。
密钥脱敏：redact_secrets: false 改成 true 后，日志里 sk-...、ghp_... 都会被自动替换成 [REDACTED]。

示例：最小安全 config.yaml：

security:
  tirith_enabled: true
  redact_secrets: true
gateway:
  allowed_users:
    - "alice"
    - "bob"
  allow_all_users: false

十四、记忆、技能、Honcho 自我进化

Hermes 的”会越来越懂你”由三件事共同作用：

14.1 FTS5 跨会话记忆

每次对话结束，Hermes 提取要点（调用 LLM 摘要）写入 ~/.hermes/memories/，用 SQLite FTS5 建倒排索引。下一次新会话开始时，系统自动 SELECT 相关记忆塞回上下文。调参：

memory:
  enabled: true
  memory_char_limit: 2200     # 单条摘要长度
  recall_top_k: 8            # 每次召回几条
  compression:
    enabled: true
    threshold: 0.50           # 上下文使用率超过 50% 触发压缩
    target_ratio: 0.20        # 压缩到 20%
    protect_last_n: 20        # 保留最近 20 条不动

14.2 Honcho 辩证式用户建模

user_profile_enabled: true 开启后，Honcho 守护进程会用一种”辩证法”持续评估你：是矛盾、是情绪、是趋势。它会写一段比单独摘要更”看法化”的总结进 ~/.hermes/SOUL.md，/insights 命令可以查看。

14.3 技能库 + MCP

每个 skill 是一个 ~/.hermes/skills/<name>.md，前面 YAML frontmatter 描述触发条件，后面是用自然语言写的工具调用模板。Hermes 会按需调用。除此之外，~/.hermes/config.yaml 里可以挂 MCP server：

mcp_servers:
  filesystem:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-filesystem", "~"]
  fetch:
    command: uvx
    args: ["mcp-server-fetch"]

重启 gateway 或执行 /reload-mcp 即生效。社区已有上百个 MCP server 可用，复用它们等于免费扩展能力。

十五、cron 与定时任务

Hermes 内置一个 60s tick 的 cron 调度器，~/.hermes/cron/ 放 YAML：

# ~/.hermes/cron/daily_news.yaml
schedule: "0 8 * * *"
task: "汇总今日 arxiv cs.AI 排名前 5 篇，发送到 telegram channel main"
channel: main

适合做”每天早上 8 点把当日精选新闻扔到 Telegram”这类每日站。

十六、升级、回滚、卸载

16.1 升级

hermes update                       # 升级 CLI + 默认镜像
docker compose pull                 # 拉新版镜像
docker compose up -d                # 复用旧卷直接起新版

升级前建议把 ~/.hermes/ 整个目录 tar 备份：

tar czf hermes-backup-$(date +%F).tgz ~/.hermes

16.2 回滚

Docker 部署用 docker compose down && docker compose up -d --force-recreate nousresearch/hermes-agent:<old-tag>，把 compose 里 :latest 改成要回滚的 tag。CLI 用 pip install hermes-agent==<old-version>。

16.3 卸载

hermes gateway stop
hermes uninstall                   # 干掉 CLI + 配置 + systemd unit
docker compose down -v              # 删容器 + 删卷（慎！）

uninstall 会询问是否一并删 ~/.hermes，建议保留一段时间确认无误再手动删。

十七、踩坑与 FAQ

来自多位社区作者（CSDN 161568267、腾讯云 2666806、aliyun 1738949、scottalive.github.io、liukunup.github.io、hermes-agent.ai、hermes-agent.live）的常见踩坑：

Q1：hermes 命令找不到

A：source ~/.bashrc 一下，或者把 ~/.local/bin 加入 PATH；Windows 检查 %LOCALAPPDATA%\hermes\bin 是否在 PATH。

Q2：Telegram bot 一直不响应

A：九成是 TELEGRAM_ALLOWED_USERS 写成了 @user 而非纯数字 ID；用 @userinfobot 重新拿 ID。剩下的一成是 token 末尾多了空格或换行。

Q3：Tirith 拦了我自己的合法命令

A：回 /approve 单次放行；长期白名单写到 config.yaml 的 terminal.allowed_commands。

Q4：Docker 后端拉镜像慢

A：改 docker.image 到国内镜像仓库或者配 Docker daemon 的镜像加速；docker.image_pull_policy: if_not_present 也可减少重启时的拉取。

Q5：磁盘吃爆

A：~/.hermes/sessions/ 与 ~/.hermes/logs/ 是两个会无限增长的大户。加 logrotate：

# /etc/logrotate.d/hermes
/var/log/hermes/*.log {
    daily
    rotate 7
    compress
    missingok
    notifempty
}

在 config.yaml 里把 session.max_size_mb 与 session.retention_days 设限。

Q6：升级后旧配置不兼容

A：跑一次 hermes config migrate，它会把旧 yaml 字段 rename / 合并到新 yaml；失败的话用 hermes config check 列出所有错误项。

Q7：要让 hermes 调用本地大模型

A：把 OPENAI_BASE_URL 指向本地 Ollama 或 vLLM 提供的 /v1 端口：

OPENAI_BASE_URL=http://localhost:11434/v1   # Ollama
OPENAI_API_KEY=ollama                       # 任意非空字符串

Q8：多用户下的审计

A：开 audit_log: true，所有用户/命令/审批记录都会落到 ~/.hermes/logs/audit.jsonl，可独立 ELK 收集。

十八、参考来源

Hermes Agent 官方文档（zh-Hans）：https://hermes-agent.nousresearch.com/docs/zh-Hans/
官方安装指南：https://hermes-agent.nousresearch.com/docs/zh-Hans/getting-started/installation
官方配置详解：https://hermes-agent.nousresearch.com/docs/zh-Hans/user-guide/configuration
官方消息网关：https://hermes-agent.nousresearch.com/docs/zh-Hans/user-guide/messaging
CSDN 离线下部署：https://blog.csdn.net/m0_51729057/article/details/161568267
腾讯云开发者：Hermes Agent 生产部署 https://cloud.tencent.com/developer/article/2666806
阿里云开发者社区：https://developer.aliyun.com/article/1738949
Hermes Agent 官方博客：https://hermes-agent.ai
Hermes Agent 社区站：https://hermes-agent.live
中文实测笔记：scottalive.github.io、liukunup.github.io

完。Hermes Agent 不是给你一段对话界面就完事，它的价值在于把”模型 × 工具 × 记忆 × 通道 × 自我进化”五个维度捆绑给开发者，上面这套流程跑通之后，下一步通常是：把内部文档/代码库挂成 MCP、把常用工作流写成 skill、把 Honcho 的画像接进业务看板。继续玩得开心。