1. Rocky Linux 上跑 Hermes Agent先把 Node.js 和统一 Key 这两件事理顺Hermes Agent 是一个能在终端里直接对话、读写文件、执行命令的 AI 编码代理Hermes-Web-UI 则是它的浏览器图形界面两者配合可以让你在服务器上拥有一个随时可用的 AI 工作台。这套组合适合谁适合手上有 Rocky Linux 服务器、想跑一个私有 AI 代理、又不想在每台机器上重复配置模型 Key 的开发者。我自己在 Rocky Linux 10 上从零走了一遍最大的感受是真正卡人的不是 Hermes 本身而是 Node.js 版本和模型接口地址这两处。Node.js 版本不够Web UI 直接起不来接口地址填错Agent 能启动但一问就报连接失败。这篇指南按“系统准备 → Node.js 环境 → Hermes Agent 核心 → TaoToken 统一 Key 接入 → Web UI → 验证 → 排障”的顺序展开每一步都给可复制的命令和配置骨架。你跟着敲完应该能一次跑通并且用同一个 Key 同时驱动 Agent 和 Web UI。下面所有路径和端口都以我实测的 Rocky Linux 10 为准Rocky 8/9 同样适用差异我会单独标注。2. 前置准备Rocky Linux 系统依赖与 Node.js 23 环境2.1 系统要求与基础工具Rocky Linux 8/9/10 都可以内存建议 2GB 以上磁盘至少留 5GB。生产环境强烈建议创建一个专用普通用户比如 hermes来安装和运行不要长期用 root。实验环境图省事可以用 root但你要清楚这只是在测试。先更新系统并装基础工具# 更新系统 sudo dnf update -y # 安装基础工具 sudo dnf install -y curl git xz wget vim # 启用 EPEL 和 CRB 仓库Rocky 8/9/10 都需要 sudo dnf install epel-release -y sudo dnf config-manager --enable crb如果你要用到 TTS 语音消息功能还需要 ffmpeg它来自 RPM Fusion# 添加 RPM Fusion 仓库 sudo dnf install --nogpgcheck https://mirrors.rpmfusion.org/free/el/rpmfusion-free-release-$(rpm -E %rhel).noarch.rpm -y # 安装 ffmpeg sudo dnf install ffmpeg -y2.2 安装 Node.js 23.xHermes-Web-UI 要求 Node.js ≥ 23这是硬性门槛。Rocky 自带的 Node 版本通常偏低用 NodeSource 源安装最省事# 添加 NodeSource 23.x 源 curl -fsSL https://rpm.nodesource.com/setup_23.x | sudo bash - # 安装 Node.js sudo dnf install -y nodejs # 验证版本应显示 v23.x.x 或更高 node --version npm --version这里有个坑如果你之前装过旧版 Nodednf 可能因为依赖冲突装不上。先sudo dnf remove nodejs -y清掉旧版再装。装完node --version如果还是旧版本检查一下which node是不是指向了/usr/local/bin下的残留文件。3. TaoToken 统一 Key一个通道驱动 Agent 和 Web UI3.1 为什么用统一 KeyHermes Agent 和 Hermes-Web-UI 各自都要配模型接口。如果分别去填不同的 Key 和地址改一次模型就要改两处很容易漏。TaoToken 提供统一的 API 通道你只需要一个 Key、一个 Base URLAgent 和 Web UI 都指向它模型切换在服务端完成本地配置不用动。TaoToken 的 API 地址是https://taotoken.net/api兼容 OpenAI 的 chat_completions 协议所以 Hermes 里 provider 选 custom、api_mode 选 chat_completions 就能对接。先去控制台创建一个 API Key# 控制台创建 Key浏览器打开 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contenthermes_rocky创建后把 Key 复制下来形如sk-xxxxxxxx。这个 Key 后面会同时写进 Hermes 的 config 和 Web UI 的设置页。3.2 接入文档与模型列表不同模型的调用名和参数在文档里有对照表配置前扫一眼能少踩坑# 接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contenthermes_rocky文档里会列出当前可用的模型名比如deepseek-v4-pro这类。你填进 config 的default字段要和文档里的名字完全一致大小写错了会报 model not found。4. 安装 Hermes Agent 核心4.1 一键安装脚本官方提供了一键脚本但国内访问 GitHub 可能不稳用镜像加速curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash如果脚本中途报error: RPC failed或Connection timed out说明 Git 克隆失败走下面的手动流程。4.2 手动安装克隆失败时# 清理可能残留的文件 sudo rm -rf /usr/local/lib/hermes-agent sudo rm -f /usr/local/bin/hermes # 用镜像下载代码压缩包 wget https://ghproxy.com/https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.tar.gz -O /tmp/hermes-agent-main.tar.gz # 检查下载是否完整文件应大于 1MB ls -lh /tmp/hermes-agent-main.tar.gz # 解压到目标目录 sudo tar -xzf /tmp/hermes-agent-main.tar.gz -C /usr/local/lib/ sudo mv /usr/local/lib/hermes-agent-main /usr/local/lib/hermes-agent # 创建 hermes 命令软链接 cd /usr/local/lib/hermes-agent sudo chmod x hermes sudo ln -s $(pwd)/hermes /usr/local/bin/hermes4.3 安装 Python 依赖Hermes 用 uv 管理虚拟环境依赖从清华源装会快很多cd /usr/local/lib/hermes-agent # 创建虚拟环境 /root/.hermes/bin/uv venv source .venv/bin/activate # 安装主依赖 /root/.hermes/bin/uv pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple # 安装扩展依赖 /root/.hermes/bin/uv pip install aiohttp cryptography -i https://pypi.tuna.tsinghua.edu.cn/simple4.4 修复解释器路径安装脚本生成的 hermes 命令可能指向系统 Python导致找不到依赖。改成虚拟环境的 Pythonsed -i 1s|.*|#!/usr/local/lib/hermes-agent/.venv/bin/python| /usr/local/bin/hermes然后把必要路径加进 PATHecho export PATH/usr/local/bin:$PATH ~/.bashrc echo export PATH/root/.hermes/bin:$PATH ~/.bashrc source ~/.bashrc # 验证核心安装 hermes --version看到版本号如 v0.14.0就说明核心装好了。5. 可复制配置config.toml 与 settings.json 骨架5.1 Hermes Agent 的 config.yamlHermes 的主配置在~/.hermes/config.yaml环境变量在~/.hermes/.env。用 TaoToken 统一通道时provider 选 custombase_url 填 TaoToken 的 API 地址model: provider: custom base_url: https://taotoken.net/api api_key: sk-你的TaoToken密钥 api_mode: chat_completions default: deepseek-v4-pro theme: dark把 Key 单独放.env更安全# ~/.hermes/.env TAOTOKEN_API_KEYsk-你的TaoToken密钥对应 config 里改成api_key: ${TAOTOKEN_API_KEY}。注意base_url结尾不要多加/v1TaoToken 的地址就是https://taotoken.net/api多写会 404。5.2 Hermes-Web-UI 的 settings.jsonWeb UI 全局安装后配置在~/.hermes-web-ui/settings.json部分版本在安装目录下。骨架如下{ apiBaseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, defaultModel: deepseek-v4-pro, apiMode: chat_completions, port: 3000, host: 0.0.0.0 }Web UI 和 Agent 用同一个 Key、同一个 Base URL这就是统一 Key 的意义改模型只改defaultModel一处两边同步生效。6. 安装并启动 Hermes-Web-UI6.1 全局安装# 切到稳定目录避免工作目录被删导致 uv_cwd 错误 cd ~ # 全局安装 npm install -g hermes-web-ui安装时 node-pty 相关的警告可以忽略不影响核心功能。6.2 启动服务# 前台启动测试用 hermes-web-ui start --port 3000 --host 0.0.0.0 # 后台持续运行 nohup hermes-web-ui start --port 3000 --host 0.0.0.0 /var/log/hermes-web-ui.log 21 开放防火墙端口sudo firewall-cmd --permanent --add-port3000/tcp sudo firewall-cmd --reload浏览器打开http://你的服务器IP:3000首次登录部分版本要求设置密码或用默认 admin/123456。登录后在设置页确认 API Key 和模型信息与 config 一致。7. 验证请求确认接口连通与成功结果7.1 运行诊断hermes doctor这个命令会检查配置、依赖和接口连通性。如果接口地址或 Key 有问题这里会直接报出来。7.2 测试对话hermes 你好请介绍一下你自己正常返回一段模型回复说明 TaoToken 通道打通了。如果报 401是 Key 错了报 404是 base_url 多写了/v1报 model not found是default字段的模型名和文档不一致。7.3 检查 Web UIcurl http://localhost:3000返回 HTML 内容说明 Web UI 在跑。再在浏览器里发一条消息确认 Web UI 也能正常调用模型。两边都能回统一 Key 配置就算成功了。8. 本篇常见错排查Q1: hermes: command not found/usr/local/bin不在 PATH。执行echo export PATH/usr/local/bin:$PATH ~/.bashrc source ~/.bashrc。Q2: Git 克隆失败RPC failed / Connection timed outGitHub 连接不稳参考 4.2 节用镜像手动下载代码。Q3: uv: command not founduv 没进 PATH。用完整路径/root/.hermes/bin/uv或把它加进 PATH。Q4: ModuleNotFoundError: No module named yamlhermes 命令用的 Python 环境缺依赖。改 shebang 指向虚拟环境 Python见 4.4 节或在虚拟环境里pip install pyyaml -i https://pypi.tuna.tsinghua.edu.cn/simple。Q5: process.cwd failed / ENOENT: uv_cwd当前终端所在目录被删了。cd ~切回主目录再操作。Q6: Node.js 版本过低要求 ≥ 23参考 2.2 节通过 NodeSource 升级。Q7: Playwright / Chromium 安装失败Playwright 在 Rocky Linux 上需要额外系统依赖且自动脚本用的是 apt-get。这是可选项不影响 Hermes 核心直接忽略警告即可。Q8: 接口报 401 / 404 / model not found401 查 Key 是否复制完整404 查 base_url 是否多写/v1model not found 查default字段模型名是否和文档一致。9. 后续怎么用模型对话、Coding Plan 与接入文档跑通之后日常使用有几个入口。想快速验证模型效果、对比不同模型的回答直接用模型对话页最方便https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contenthermes_rocky如果你打算长期用 Hermes 做编码和 Agent 任务按量计费不如包月划算Coding Plan 适合高频调用场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contenthermes_rocky需要新建或轮换 Key 时去控制台https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contenthermes_rocky配置参数拿不准就翻接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contenthermes_rocky最后提醒一句config.yaml 和 settings.json 里的 base_url 都写https://taotoken.net/api不要自作主张加/v1这是我在 Rocky 上踩过最隐蔽的一个坑——Agent 能启动但每次请求都 404排查了半天才发现是地址多了一段。