词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"Open WebUI"
Open WebUI 集成
架构
AIAgent。工具调用在该 API 服务器运行的位置执行。pwd、文件工具、浏览器工具、本地 MCP 工具及其他工作区工具将在远程 API 服务器主机上运行，而非在笔记本电脑上。API_SERVER_CORS_ORIGINS。快速设置
本地一键引导（macOS/Linux，无需 Docker）
~/.hermes/.env 包含 API_SERVER_ENABLED、API_SERVER_HOST、API_SERVER_KEY、API_SERVER_PORT 和 API_SERVER_MODEL_NAME~/.local/open-webui-venv~/.local/bin/start-open-webui-hermes.sh 写入启动器launchd 用户服务；在支持 systemd --user 的 Linux 上安装用户服务http://127.0.0.1:8642/v1http://127.0.0.1:8080Hermes Agentsystemd --user 会话。如果你在无头 SSH 机器上并希望跳过服务安装，请运行：1. 启用 API 服务器
hermes config set 会自动将标志路由到 config.yaml，将密钥路由到 ~/.hermes/.env。如果 gateway 已在运行，请重启以使更改生效：2. 启动 Hermes Agent gateway
[API Server] API server listening on http://127.0.0.1:86423. 验证 API 服务器可访问
/health 失败，说明 gateway 未加载 API_SERVER_ENABLED=true——重启它。如果 /v1/models 返回 401，说明你的 Authorization 头与 API_SERVER_KEY 不匹配。4. 启动 Open WebUI
ENABLE_OLLAMA_API=false 会禁用默认的 Ollama 后端，否则它会显示为空并干扰模型选择器。如果你确实在同时运行 Ollama，可以省略此参数。docker logs open-webui 输出稳定后再打开 UI。5. 打开 UI
Docker Compose 设置
docker-compose.yml：通过管理员 UI 配置
1.
2.
3.
4.
5.
6.
http://host.docker.internal:8642/v1API_SERVER_KEY 完全相同的值7.
8.
警告
API 类型：Chat Completions 与 Responses
| 模式 | 格式 | 使用场景 |
|---|---|---|
| Chat Completions（默认） | /v1/chat/completions | 推荐。开箱即用。 |
| Responses（实验性） | /v1/responses | 通过 previous_response_id 实现服务端对话状态。 |
使用 Chat Completions（推荐）
使用 Responses API
1.
2.
3.
4.
input 数组 + instructions），Hermes Agent 可通过 previous_response_id 在多轮对话中保留完整的工具调用历史。当 stream: true 时，Hermes 还会流式传输符合规范的 function_call 和 function_call_output 事件，这使得支持 Responses 事件渲染的客户端能够展示自定义结构化工具调用 UI。备注
previous_response_id。Responses 模式目前的主要优势在于结构化事件流：文本增量、function_call 和 function_call_output 事件以 OpenAI Responses SSE 事件形式到达，而非 Chat Completions 分块。工作原理
1.
POST /v1/chat/completions 请求2.
AIAgent 实例3.
4.
`💻 ls -la`、`🔍 Python 3.12 release`）5.
6.
工具进度
配置参考
Hermes Agent（API 服务器）
| 变量 | 默认值 | 描述 |
|---|---|---|
API_SERVER_ENABLED | false | 启用 API 服务器 |
API_SERVER_PORT | 8642 | HTTP 服务器端口 |
API_SERVER_HOST | 127.0.0.1 | 绑定地址 |
API_SERVER_KEY | （必填） | 用于认证的 Bearer token（令牌）。需与 OPENAI_API_KEY 匹配。 |
Open WebUI
| 变量 | 描述 |
|---|---|
OPENAI_API_BASE_URL | Hermes Agent 的 API URL（包含 /v1） |
OPENAI_API_KEY | 不能为空。需与你的 API_SERVER_KEY 匹配。 |
故障排查
下拉列表中没有模型
/v1 后缀：http://host.docker.internal:8642/v1（不只是 :8642）curl http://localhost:8642/health 应返回 {"status": "ok"}curl -H "Authorization: Bearer your-secret-key" http://localhost:8642/v1/models 应返回包含 hermes-agent 的列表localhost 指容器本身，而非你的主机。请使用 host.docker.internal 或 --network=host。ENABLE_OLLAMA_API=false，Open WebUI 会在你的 Hermes 模型上方显示一个空的 Ollama 区域。请使用 -e ENABLE_OLLAMA_API=false 重启容器，或在 Admin Settings → Connections 中禁用 Ollama。连接测试通过但模型无法加载
/v1 后缀。Open WebUI 的连接测试只是基本的连通性检查——它不验证模型列表是否正常工作。响应耗时很长
"Invalid API key" 错误
OPENAI_API_KEY 与 Hermes Agent 中的 API_SERVER_KEY 匹配。警告
多用户设置与 Profiles
1. 创建 profiles 并配置 API 服务器
API_SERVER_* 是环境变量，而非 YAML 配置键，因此请将它们写入每个 profile 的 .env。选择默认平台范围之外的端口（8644 是 webhook 适配器，8645 是 wecom-callback，8646 是 msgraph-webhook），例如 8650+：2. 启动各 gateway
3. 在 Open WebUI 中添加连接
| 连接 | URL | API Key |
|---|---|---|
| Alice | http://host.docker.internal:8650/v1 | alice-secret |
| Bob | http://host.docker.internal:8651/v1 | bob-secret |
alice 和 bob 作为独立模型。你可以通过管理员面板将模型分配给 Open WebUI 用户，为每个用户提供其独立的 Hermes agent。自定义模型名称
.env 中设置 API_SERVER_MODEL_NAME：Linux Docker（无 Docker Desktop）
host.docker.internal 默认无法解析。可选方案：