Hermes 接入快手万擎（StreamLake）超详细教程
📋 前置准备
- 登录快手万擎后台
https://console.streamlake.com/wanqing/proj-weyxmv-1776329345892708365/ai-square/model-list
- 选取需要接入的模型，获取该模型以下三个核心信息 (以 KAT-Coder-Pro-V2 模型为例）：
核心信息获取路径：模型详情 ➡️ API调用
模型 ID：
ep-r33h9s-1776348******537797
API Base URL：
https://wanqing.streamlakeapi.com/api/gateway/v1/endpoints
API Key：
3DxY8PP9k8mF0jVqYg*********32dYEnwDNqWjJ94o
⚙️ 安装 Hermes
步骤 1：在终端安装 Hermes
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
- 将以上Hermes 官方一键自动安装命令粘贴至“ 终端（Terminal）”中，并按回车执行安装。
- 继续选择 Quick setup，一键配置 模型服务商、接口地址、模型 ID、基础对话功能。
步骤 2：安装完成
- 当终端显示 Skills synced to ~/.hermes/skills/ 时，表示 Hermes 已安装完成。
🚀 配置步骤
步骤 1：选择模型服务商
接下来会自动进入配置引导界面，该界面会列出多个模型服务商（如 OpenAI、Anthropic 等），按方向键选中 Custom endpoint (enter URL manually)，按 Enter 键确认。
步骤 2：输入万擎核心信息
- 输入前置准备环境中已准备好的万擎核心信息，按终端提示依次输入：API Base URL / API Key / Model name
- 输入后出现 Connect a messaging platform? 选择 Skip - set up later with 'hermes setup gateway'（IM配置方法见下文）
步骤 3：完成配置
所有信息输入完成后，终端会提示 Ready to go!
- 输入：Y 进入 Hermes 对话模式；
直接输入问题（如 “你好”），如果能正常回复，这匹马就算是牵到了我们电脑里，说明配置成功了！🎉
🌍 Hermes 接入通讯平台
在终端输入该命令，可选择接入即时通讯工具。
hermes setup gateway按提示操作：
- 使用 ↑↓ 方向键 选择平台
- 按 空格键 选中
- 按 Enter 确认
- 输入对应平台的配置信息
*以微信为例：
❓ 常见问题快速修复
报错现象 | 原因 | 修复方法 |
command not found: hermes | 环境变量未配置 / 未生效 | 重新执行环境变量配置命令：source ~/.zshrc（bash 终端替换为 ~/.bashrc），重启终端 |
显示 WARNING gateway.run: No messaging platforms enabled | 是正常提示，仅表示你未配置飞书/微信等外部聊天平台 | 不影响模型调用，无需处理 |
Invalid API key | API Key 填写错误、过期、权限不匹配（大多情况是API Key填写错误） | 核对万擎后台复制的完整密钥，前后无多余空格换行 |
model not found | 模型 ID 填写错误、无该模型调用权限、模型已下架（大多情况是模型ID填写错误） | 1. 核对必须填写 ep - 开头模型 ID，不可填写模型中文名称； 2. 确认万擎后台该模型已开通调用权限； 3. 更新配置后重启 Hermes 对话 |
Missing Action parameter | API 请求格式错误，URL 路径不正确 | 确保 API Base URL 为https://wanqing.streamlakeapi.com/api/gateway/v1/endpoints 调用时不要随意添加额外路径； 若用 curl 测试，使用万擎官方格式 |
401 Unauthorized | API 密钥无效、填写错误、权限过期，身份认证不通过 账号余额不足、服务失效，拒绝身份鉴权 | 1. 核对万擎后台 API Key，完整复制无前后空格、换行 2. 确认密钥未过期、项目拥有该模型调用权限 3. 重新执行hermes setup更新密钥配置 4.检查万擎账号余额充值缴费，重新配置密钥后重启对话 |
403 Forbidden | 1. 权限不足：API Key 所属账号无该模型调用权限 2. IP 白名单限制：万擎后台未配置你的本地 IP 访问 3. 账号异常：账号被风控、封禁或处于异常状态 | 1. 核对万擎后台： - 确认 API Key 归属的项目 / 账号拥有该模型的调用权限 - 检查IP 白名单是否包含你的当前公网 IP 2. 重新生成 API Key 并配置 (hermes setup) |
404 Not Found | Base URL 路径错误、接口地址拼写不对，找不到万擎服务接口 | 正确 Hermes Base URL：https://wanqing.streamlakeapi.com/api/gateway/v1/endpoints 不要额外添加/chat/completions后缀，核对地址拼写无误后重启对话 |