8848AI 工具指南

已核验真实支持边界

Agent / CLI / 消息网关

Hermes Agent 接入 8848API 完整指南

使用 Hermes 官方 Custom endpoint 向导或 config.yaml 接入 8848API，再逐步配置工具和消息网关。

✅ 官方支持自定义 OpenAI-compatible Endpoint

官方文档 ↗查看 8848API 模型 →

8848API 信息

Base URL

https://api.884819.xyz/v1

API Key

控制台 → 令牌管理 → 添加令牌

协议要求

OpenAI-compatible Chat Completions：/v1/chat/completions

1. 安装 Hermes Agent

Linux / macOS / WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc  # 或 source ~/.zshrc

Windows PowerShell

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

2. 用官方向导添加自定义接口

hermes model

选择 Custom endpoint (self-hosted / VLLM / etc.)。
Base URL 填 https://api.884819.xyz/v1。
API Key 填 8848API 的 sk- 密钥。
Model name 填完整模型 ID。
保存后启动 hermes 测试对话。

3. 手动配置（可选）

编辑 ~/.hermes/config.yaml：

model:
  default: claude-sonnet-4.6
  provider: custom
  base_url: https://api.884819.xyz/v1
  api_key: ${API8848_KEY}

再设置环境变量：

export API8848_KEY="你的 sk- 密钥"

优先使用 hermes model，手动配置适合需要审计或批量部署的用户。

4. 验证和后续设置

运行 hermes，发送“只回复 OK”。
使用 /model 只能切换已经配置好的模型；添加新 Provider 要退出后运行 hermes model。
CLI 对话成功后，再运行 hermes gateway setup 添加 Telegram、Discord 等消息通道。
需要诊断时运行 hermes doctor。

常见问题

把 /model 当成配置向导：/model 不能添加新 Key 或 Endpoint。
模型能聊天但工具失败：所选模型需要正确支持 tool calls。
视觉失败：主模型必须支持多模态，或单独配置 auxiliary.vision。
旧 LLM_MODEL 环境变量：官方已以 config.yaml 为主要配置来源。