在 Hermes Agent 中使用 Muapi

将 Muapi 配置为自定义 OpenAI 兼容端点，即可在 Hermes Agent 中使用 Muapi 文本模型。

1. 创建密钥并选择模型

在 Muapi 控制台创建 API 密钥，然后列出可用文本模型：

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

选择 capabilities.tools: true 的模型。Hermes 智能体工作流要求上下文窗口至少为 64,000 tokens；选择前请检查模型上下文上限。

2. 配置 Hermes Agent

运行模型设置向导：

hermes model

选择 Custom endpoint，并填写 API 基础 URL https://api.muapi.ai/v1、Muapi API 密钥，以及 Muapi 文本模型列表中的准确模型 ID。

也可以在 ~/.hermes/config.yaml 中设置：

model:
  default: YOUR_MODEL_ID
  provider: custom
  base_url: https://api.muapi.ai/v1
  key_env: MUAPI_API_KEY

将密钥放入 ~/.hermes/.env：

MUAPI_API_KEY=your-muapi-api-key

将 YOUR_MODEL_ID 替换为 Muapi 模型列表中的准确 ID。

3. 启动 Hermes Agent

hermes
# 或：
hermes --tui

先测试一个会调用工具的小任务。模型正常工作后，可通过 hermes gateway setup 连接消息平台。

故障排查

• 检查基础 URL 是否以 /v1 结尾、密钥是否可用，以及模型 ID 是否完全一致。
• 若模型不调用工具，请选择 capabilities.tools: true 的模型。
• Hermes 要求上下文窗口至少 64K tokens。
• 从小任务开始，并在 Muapi 控制台查看用量。

端点配置请参阅 Hermes Agent 提供商文档，其他设置请参阅配置指南。