企业官网建设流程全解析

离线服务器上把 Hermes Agent 的镜像docker load进去、docker-compose up -d也看到两个容器都起来了，结果一跑任务就卡住——这是很多人在 Hermes Agent Docker 离线部署里踩的最后一个坑。镜像能搬、容器能起，但 Agent 真正要干活时得调用模型接口，离线环境里这一步最容易断。这篇就接着离线部署的流程往下走，重点补上模型接入这一段：先在 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建 Key，拿到统一 Base URL，再把 hermes-gateway 的模型接口指过去，让离线部署的 Hermes Agent 真正能跑任务。

一、离线部署 Hermes Agent 到底卡在哪一步

先把整条链路捋清楚。Hermes Agent 的离线部署，本质上是把「有网设备」当成搬运工，把 Docker 镜像打包成 tar，再弄进没有外网的服务器。原文的流程分得很清楚：

• 在有网设备上docker pull nousresearch/hermes-agent:latest，确认架构（uname -m看是 x86_64 还是 aarch64）；
• docker save导出成 tar 或 tar.gz；
• 通过 U 盘、内网 SCP 或者临时 HTTP 服务把包传过去；
• 在离线服务器上docker load -i导入；
• 写docker-compose.yml，同时起hermes-gateway和hermes-dashboard。

这套流程本身没问题，镜像搬运、导入、容器编排都能跑通。问题出在hermes-gateway这个服务上——它是真正处理消息和 API 请求的组件，Agent 要执行任务，就得通过它去调用大模型。而模型调用需要两样东西：一个可用的 API Key，一个能访问到的模型接口地址。

离线服务器没有外网，模型接口如果指向公网默认地址，请求根本发不出去；就算服务器能通外网，没有 Key 也一样跑不起来。所以离线部署 Hermes Agent 的最后一步，不是docker-compose up -d看到容器 running 就结束了，而是要让 gateway 拿着 Key、通过一个可达的接口地址，把模型请求正常发出去、正常收回来。

这一步在离线环境里之所以最容易卡，是因为它跨了两个域：Docker 编排属于本地运维，模型接入属于外部服务配置。很多人把镜像搬完就觉得大功告成，结果 dashboard 里任务一直转圈或者直接报错，回头查日志才发现是模型接口没配。

二、TaoToken 前置：先把 Key 和 Base URL 准备好

在继续搬运镜像之前，建议先把模型接入这一侧准备好，这样后面 compose 起来就能直接验证，不用来回改配置。

打开 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end ，注册登录后进入控制台，创建一个 API Key。这个 Key 就是后面hermes-gateway调用模型时用的凭证，格式上是一串以sk-开头的字符串，创建后建议立刻复制保存，页面刷新后不一定还能完整看到。

创建 Key 的入口在控制台的 API Keys 页面，对应的地址是 https://taotoken.net/console/api-keys 。如果你对 Key 的管理、额度查看、模型列表这些还不熟，可以顺手翻一下接入文档 https://taotoken.net/doc ，里面把 Base URL、鉴权方式、请求格式都写清楚了。

这里要记住两个关键信息：

• 统一 Base URL：https://taotoken.net/api
• API Key：你自己创建的那串sk-开头的字符串

TaoToken 用的是 OpenAI 兼容的接口格式，也就是说，任何支持自定义 Base URL 和 API Key 的客户端或服务，都可以把请求指过来。Hermes Agent 的 gateway 正好支持通过环境变量配置模型接口，这就对上了。

需要说明的是，离线服务器本身能不能访问到https://taotoken.net/api，取决于你的网络环境。如果离线服务器完全物理隔离、连内网出口都没有，那模型请求这一侧需要由你的网络架构来保证可达性；如果离线服务器只是不能直接上公网、但内网有统一出口，那把 Base URL 配好通常就能通。这一点在部署前要先确认，否则配了也发不出去。

三、可复制配置：把模型接口指向 TaoToken

现在回到离线部署流程。镜像搬运的部分按原文走就行，这里不重复。重点看docker-compose.yml里hermes-gateway的环境变量怎么配。

原文给出的 compose 文件是这样的：

services: hermes-gateway: image: nousresearch/hermes-agent:latest container_name: hermes-gateway restart: unless-stopped ports: - "8642:8642" volumes: - ~/.hermes:/opt/data command: ["gateway", "run"] hermes-dashboard: image: nousresearch/hermes-agent:latest container_name: hermes-dashboard restart: unless-stopped ports: - "9119:9119" volumes: - ~/.hermes:/opt/data command: ["dashboard", "--tui", "--host", "0.0.0.0", "--insecure", "--port", "9119"]

要让它接上 TaoToken，需要在hermes-gateway里补上模型相关的环境变量。改完之后的hermes-gateway部分大致是这样：

services: hermes-gateway: image: nousresearch/hermes-agent:latest container_name: hermes-gateway restart: unless-stopped ports: - "8642:8642" volumes: - ~/.hermes:/opt/data environment: - OPENAI_API_KEY=YOUR_API_KEY - OPENAI_BASE_URL=https://taotoken.net/api - OPENAI_MODEL=你的模型ID command: ["gateway", "run"]

几个点解释一下：

• OPENAI_API_KEY填你在 TaoToken 控制台创建的那串 Key，也就是把YOUR_API_KEY替换掉；
• OPENAI_BASE_URL固定填https://taotoken.net/api，注意结尾不要多加/v1之类的路径，具体以接入文档为准；
• OPENAI_MODEL填你要用的模型 ID，这个在 TaoToken 的模型列表里能看到，填你实际要跑任务用的那个。

如果你的 Hermes Agent 版本用的是别的环境变量名（比如HERMES_前缀或者LLM_前缀），以你实际镜像里的文档为准，核心逻辑是一样的：Key、Base URL、模型 ID 三样都要给到 gateway。

改完 compose 文件后，重新拉起服务：

cd /opt/hermes-agent docker-compose down docker-compose up -d docker-compose ps

看到hermes-gateway和hermes-dashboard都是 Up 状态，就说明容器层面没问题了。接下来才是真正的验证。

四、验证请求：dashboard 里看到调用成功

容器起来不等于任务能跑。要确认模型接入真的通了，得实际发一次请求。

最直接的方式是看 gateway 的日志。执行：

docker-compose logs -f hermes-gateway

然后在 dashboard 里触发一个简单的 Agent 任务，或者直接用 curl 打一下 gateway 的接口。如果配置正确，日志里会看到 gateway 向https://taotoken.net/api发起了请求，并且拿到了正常的响应，而不是连接超时或者 401。

打开 dashboard，地址是http://你的服务器IP:9119。在界面里发起一个测试任务，比如让 Agent 做一个简单的文本处理。任务跑完后，dashboard 里应该能看到这次调用的记录：请求发出去了、模型返回了结果、任务状态是成功。

如果 dashboard 里能看到调用成功的记录，说明整条链路是通的：

1. 离线服务器上的hermes-gateway容器正常运行；
2. gateway 读到了你配的 Key 和 Base URL；
3. 请求成功发到了 TaoToken 的接口；
4. 模型返回了结果，gateway 正常处理并回传给了 dashboard。

到这一步，Hermes Agent 的离线部署才算真正完成——不只是镜像搬进来了，而是 Agent 能实际干活了。

如果任务一直卡着不动，或者 dashboard 报错，先别急着怀疑镜像，八成是模型接入这一段的问题，往下看排查。

五、本篇常见错排查

离线部署 Hermes Agent 接 TaoToken，常见的坑集中在下面几个地方。

错误一：401 Unauthorized 或鉴权失败

日志里出现 401，基本是 Key 的问题。检查OPENAI_API_KEY是不是填对了，有没有多空格、少字符，或者把YOUR_API_KEY这个占位符原样留着了。另外确认这个 Key 在 TaoToken 控制台里是启用状态、没有过期。Key 的管理页面在 https://taotoken.net/console/api-keys ，可以对照着核对。

错误二：连接超时或无法解析地址

日志里出现 timeout、connection refused、no route to host 这类，说明离线服务器根本发不出去请求。先确认服务器到https://taotoken.net/api的网络可达性。如果服务器是完全物理隔离的，那模型请求这一侧需要由你的网络架构来保证出口；如果只是不能直接上公网，检查内网出口和 DNS 配置。这一步是环境问题，不是配置问题，配得再对也发不出去。

错误三：Base URL 写错导致 404

OPENAI_BASE_URL如果多写了/v1或者结尾斜杠处理不对，可能返回 404。按接入文档 https://taotoken.net/doc 里的说明，统一用https://taotoken.net/api，不要自己拼路径。不同客户端对 Base URL 的拼接方式不一样，有的会自动补/v1/chat/completions，有的不会，以文档为准。

错误四：模型 ID 填错

OPENAI_MODEL填了一个不存在或者没权限的模型 ID，会返回模型不存在的错误。去 TaoToken 的模型列表里确认你要用的模型 ID，原样填进去。模型对话页面 https://taotoken.net/models 可以直观地看到有哪些模型可用，也可以在那里先手动测一下这个模型能不能正常对话，确认没问题再填进 compose。

错误五：改了 compose 但没重启

改完docker-compose.yml后只执行了docker-compose restart，有时候环境变量不会重新加载。稳妥的做法是docker-compose down再docker-compose up -d，让容器带着新配置重新创建。改完配置先down再up，能省掉很多「明明改了却没生效」的困惑。

错误六：dashboard 能开但任务不执行

dashboard 是 Web 管理界面，它自己能起来不代表 gateway 能调模型。dashboard 显示正常、但任务一直 pending 或者失败，重点查 gateway 的日志，而不是 dashboard 的日志。两个容器虽然用同一个镜像，但职责不同，模型调用发生在 gateway 这一侧。

排查的时候有个通用思路：先看 gateway 日志里请求有没有发出去。发出去了但报错，是 Key 或模型 ID 的问题；根本没发出去，是网络或 Base URL 的问题。按这个顺序查，比盲目改配置快得多。

六、把离线部署和模型接入一次做对

Hermes Agent 的 Docker 离线部署，前半段是镜像搬运的体力活，后半段是模型接入的配置活。很多人把前半段做得很扎实，镜像 load 成功、容器也起来了，却在后半段卡住，本质上是把「部署完成」和「能跑任务」混为一谈了。

正确的顺序是：在有网设备上准备镜像包的同时，顺手在 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 把 Key 创建好，拿到统一 Base URLhttps://taotoken.net/api；镜像搬过去、docker load导入、compose 起来之后，在hermes-gateway的环境变量里把模型接口指向 TaoToken；最后通过 dashboard 发一次真实任务，确认调用成功。这样一套走下来，离线环境里的 Hermes Agent 才是真的能用。

如果你后面要长期跑 Agent 任务、做持续性的编码或自动化，可以了解一下 Coding Plan https://taotoken.net/coding-plan ，适合需要稳定模型调用的场景。如果只是想先验证某个模型能不能用，直接去模型对话页面 https://taotoken.net/models 手动测一下最快。接入过程中遇到配置问题，接入文档 https://taotoken.net/doc 和 API Keys 管理页 https://taotoken.net/console/api-keys 是两个最常回看的地方。把 Key、Base URL、模型 ID 这三样对齐，离线部署的 Hermes Agent 就能稳定跑起来了。