ZBStream

接入 WorkBuddy & Hermes

WorkBuddy 桌面工作台与 Hermes Agent 都支持自定义 OpenAI 兼容接口。几步配置即可把 ZBStream 作为统一模型来源，一个 Key 切换全部模型。

支持的接入方式

说明

两种客户端都只支持 OpenAI 兼容协议。使用 Anthropic 接口的程序请参考 Anthropic 接口文档。

客户端配置方式适用对象
WorkBuddy模型选择器 → 配置自定义模型（图形界面）桌面工作台用户
WorkBuddy直接编辑 ~/.workbuddy/models.json批量 / 脚本化管理
Hermes Agenthermes config set 命令行Agent / 自动化工作流

WorkBuddy：图形界面配置

  • 第一步：点击底部模型选择器，进入「配置自定义模型」。
  • 第二步：点击「+ 添加模型」，提供商选择「自定义 / Custom」。
  • 第三步：接口地址填 https://api.zbstream.com/v1/chat/completions，粘贴 ZBStream API Key，模型名称填写 /v1/models 返回的精确 id（如 deepseek-v4-pro）。
  • 高级配置：按需勾选「工具调用」「图片输入」；模型为推理模型时可勾选「思考模式」。
  • 保存后模型立即出现在模型选择器中，可直接切换使用。

WorkBuddy：models.json 批量配置

需要一次添加多个模型时，可直接编辑本地配置文件：macOS / Linux 为 ~/.workbuddy/models.json，Windows 为 C:\Users\<用户名>\.workbuddy\models.json。保存后约 1 秒内自动热重载，无需重启。

配置仅存储在本地，不会上传云端。请勿将该文件提交到公共代码仓库。

{
  "models": [
    {
      "id": "deepseek-v4-pro",
      "name": "ZBStream DeepSeek Pro",
      "vendor": "ZBStream",
      "apiKey": "sk-你的_ZBStream_API_Key",
      "url": "https://api.zbstream.com/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": false
    }
  ]
}

Hermes Agent：命令行配置

Hermes Agent 通过 providers.custom 前缀配置自定义 OpenAI 兼容供应商。也可以在 config/hermes.yaml 的 api 段中直接填写 url 和 key。

# 配置 ZBStream 作为自定义 Provider
hermes config set providers.custom.base_url "https://api.zbstream.com/v1"
hermes config set providers.custom.api_key "sk-你的_ZBSTREAM_API_KEY"

# 设置默认模型
hermes config set default_model "deepseek-v4-pro"

# 重启 Hermes 后，底部模型选择器即可看到新模型

验证与排查

  • 先用 curl 请求 https://api.zbstream.com/v1/chat/completions 验证 Key 与模型可用。
  • 模型名称大小写敏感，必须与 /v1/models 返回值完全一致。
  • 接口地址末尾不要带多余斜杠；非标准端点需在 WorkBuddy 中勾选「自定义协议」。
  • 勾选「工具调用」前确认该模型支持 Function Calling，否则调用会失败。
  • 配置完成后发起一次短对话验证链路，再交给自动化任务使用。