1. 为什么 Hermes Agent 需要一个 Web 控制台Hermes Agent 跑起来之后很多人第一反应是把它接到微信、飞书或者企微里发条消息就能拿到回复确实方便。但用久了你会发现一个很别扭的地方你只能看到「消息发出去」和「回复回来」这两个端点中间发生了什么完全是个黑盒。回复快了不知道是模型给力还是缓存命中回复慢了也分不清是模型响应慢、工具调用超时还是网络抖动。我试过连续几天盯着终端日志排查一次超时问题虽然最后定位到了但那种翻滚动日志的体验实在谈不上高效。Hermes Web UI 解决的正是这个问题它不替代 Hermes Agent而是给这个后台服务装一个浏览器可视化入口。对话记录、模型配置、频道管理、任务状态、日志信息都能在页面里直接看原本只能靠终端观察的东西现在变得可见、可点、可调试。这篇要交付的是一条完整链路本地 Hermes Agent 已经跑通的前提下装好 hermes-web-ui用 TaoToken 统一 Key/API 通道把模型配置写进 config.toml再用 cpolar 把本地 8648 端口映射到公网最后在浏览器里远程登录验证。目标很明确——30 分钟内跑通一个远程可访问的 Hermes 控制台。适合已经部署过 Hermes Agent、想给它加一层可视化管理入口的人也适合正在用 TaoToken 做统一模型接入、希望把配置集中管理的开发者。2. TaoToken 前置准备统一 Key 与 API 通道在动 Web UI 之前先把模型通道理顺。Hermes Agent 支持多个模型提供商但如果每个提供商都单独配 Key、单独改地址后期切换和排障会很乱。TaoToken 的作用是提供一个统一的 API 通道你只需要一个 Key就能在 config.toml 里把模型请求指向同一个入口。先到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录然后进入控制台创建 API Key。创建路径是 console 页面下的 api-keys 管理生成后先复制保存后面写进 config.toml 的就是这个值。这里有个细节要注意TaoToken 的 API 基础地址是 https://taotoken.net/api配置时不要带任何查询参数保持干净。很多接入失败不是因为 Key 错而是因为 base_url 后面被手动拼了多余的路径或参数导致请求 404。如果你后续打算长期跑编码类 Agent 或者多任务并发可以顺带看一下 Coding Plan 的额度说明如果只是想先验证模型通不通直接用模型对话页面发一条测试消息最快。这两步不是必须但能帮你在写配置之前确认 Key 本身是有效的。3. 可复制配置config.toml 骨架与 hermes-web-ui 安装3.1 config.toml 骨架配置Hermes Agent 的模型配置集中在 config.toml 里。下面这份骨架可以直接复制把 api_key 换成你自己的即可。核心思路是把 provider 指向 TaoToken 的统一入口模型名按你实际要用的填。[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-sonnet-4-20250514 timeout 120 [model.params] max_tokens 4096 temperature 0.7几个参数说明一下。provider 用 openai-compatible 是因为 TaoToken 走的是兼容 OpenAI 协议的通道Hermes Agent 侧不需要额外适配。timeout 建议给到 120 秒以上Agent 类任务经常涉及多轮工具调用超时太短会在复杂任务上误判为失败。base_url 结尾不要加斜杠也不要加 /v1保持 https://taotoken.net/api 这个形态。改完 config.toml 后重启 Hermes Agent让它重新加载配置。如果你不确定配置有没有生效可以先在终端里发一条简单对话看返回是否正常。3.2 安装 hermes-web-uiWeb UI 的安装有两种方式。推荐方式是直接让 Hermes Agent 自己装把下面这段提示词发给它请帮我在当前设备上安装 hermes-web-ui。先检查 Node.js 和 npm 是否可用 如果环境正常就使用 npm 全局安装 hermes-web-ui。安装完成后启动 hermes-web-ui 并告诉我本地和局域网访问地址以及登录 Token。如果端口被占用请先提示我不要删除任何文件。手动方式也不复杂。先确认 Node.js 版本hermes-web-ui 建议 Node.js 23 或更高node -v npm -v版本没问题就全局安装并启动npm install -g hermes-web-ui hermes-web-ui start启动成功后终端会输出本地地址 http://localhost:8648、局域网地址以及登录 Token。如果想改密码执行echo 你的新密码 ~/.hermes-web-ui/.token hermes-web-ui restart到这里Web UI 本身已经跑起来了本地浏览器访问 8648 端口就能看到登录页。4. cpolar 内网穿透与远程访问验证4.1 安装并启动 cpolar本地能访问还不够出门在外用手机流量就打不开了。cpolar 的作用是把本地 8648 端口映射成一个公网地址。以 macOS 为例用 Homebrew 安装最省事brew tap probezy/core brew install cpolar sudo cpolar service install sudo cpolar service start cpolar version看到版本号就说明装好了。然后浏览器访问 http://127.0.0.1:9200 进入 cpolar 管理界面用注册好的账号登录。4.2 创建指向 8648 的隧道进入隧道管理编辑或新建一条隧道。关键参数只有几个隧道名称填 hermesweb 方便辨识协议选 http本地地址填 8648地区选 China Top。保存后到在线隧道列表会看到一条 https 公网地址。用这个 https 地址在浏览器打开应该能看到 hermes-web-ui 的登录页。输入启动时生成的 Token就能进入控制台。这一步验证通过说明「本地服务 → cpolar 隧道 → 公网访问」这条链路是通的。4.3 固定二级子域名随机公网地址适合临时测试长期用会变。到 cpolar 预留页面保留一个二级子域名比如 hermes01然后回到隧道编辑页把域名类型改成二级子域名Sub Domain 填 hermes01更新后在线隧道列表里的地址就固定下来了。之后无论在家还是在外用这个固定地址都能打开 Web 控制台。5. 本篇常见错排查配置过程中最容易卡住的几个点我按出现频率排一下。第一个是 config.toml 里 base_url 写错。有人习惯性写成 https://taotoken.net/api/v1结果请求全部 404。正确写法就是 https://taotoken.net/api不要加后缀。如果模型对话一直报连接错误先检查这一行。第二个是 Node.js 版本过低。hermes-web-ui 在 Node.js 20 以下可能启动失败或页面白屏用 node -v 确认低于 23 就升级。第三个是 8648 端口被占用。启动时如果提示端口冲突先查一下谁占用了lsof -i :8648确认不是关键服务后再换端口或释放。不要直接删文件这是提示词里特意强调的。第四个是 cpolar 隧道建好了但打不开。先确认本地 http://localhost:8648 能正常访问如果本地都不通公网肯定不通。本地通、公网不通检查隧道协议是不是 http、本地地址是不是 8648、cpolar 服务有没有在运行。第五个是登录 Token 对不上。Token 在启动时输出过一次如果没记下来可以用改密码命令重置然后 restart 再用新密码登录。6. 后续怎么用起来Web 控制台跑通之后最直观的用法是建定时任务。比如在任务面板创建一个每天早上 8 点推送天气的任务先点「立即运行」手动测一次确认微信端能收到提醒再让它按计划跑。任务运行历史也会留在面板里成功失败一目了然。模型和频道配置也可以在 Web UI 里直接看和改不用每次都翻 config.toml。TTS 语音那块支持浏览器内置、OpenAI 兼容端点等多种方案想让 Agent 回复带语音播报的可以按需开。如果你在接入或排障过程中遇到 Key 或通道问题直接去 API Keys 管理页核对接入细节看接入文档想先验证模型通不通用模型对话页面发一条最快长期跑编码类 Agent 或多任务并发的可以了解下 Coding Plan 的额度。把这几步串起来Hermes Agent 就不再是一个只能靠聊天窗口感知的黑盒而是一个随时能打开、能看、能调的远程控制台。
