日期: 2026年5月7日

# Hermes / OpenClaw 模型 Provider 最小配置片段（可直接拷贝）

## Hermes（~/.hermes/config.yaml）

只保留：minimax（主力）+ mac(oMLX) 三模型（兜底）。

把下面两段直接替换到你的 `config.yaml` 对应位置即可：

“`yaml
custom_providers:
– name: mac
base_url: http://100.88.88.88:8000/v1
api_key: ${LOCAL_OMLX_API_KEY}
models:
– Qwen3.5-9B-OpusRsnDistV2-mlx-4bit
– Qwen3.5-9B-HauhauCS-Aggro-mlx-mxfp4
– qwen35-9b-mlx-turboquant-tq3

fallback_providers:
– provider: minimax-cn
model: MiniMax-M2.7
– provider: mac
model: Qwen3.5-9B-OpusRsnDistV2-mlx-4bit
– provider: mac
model: Qwen3.5-9B-HauhauCS-Aggro-mlx-mxfp4
– provider: mac
model: qwen35-9b-mlx-turboquant-tq3
“`

环境变量建议：

“`bash
export LOCAL_OMLX_API_KEY=’ollama-key’
export MINIMAX_CN_API_KEY=’sk-…’
“`

验证：
– oMLX：`GET http://100.88.88.88:8000/v1/models`（Bearer `${LOCAL_OMLX_API_KEY}`）能看到这 3 个 id。

## OpenClaw（~/.openclaw/openclaw.json）

只保留：minimax-portal（主力）+ mac(oMLX) 三模型（兜底）。

“`json
{
“auth”: {
“profiles”: {
“minimax-portal:default”: {
“provider”: “minimax-portal”,
“mode”: “oauth”
}
}
},
“models”: {
“providers”: {
“mac”: {
“baseUrl”: “http://100.88.88.88:8000/v1”,
“apiKey”: “${LOCAL_OMLX_API_KEY}”,
“api”: “openai-completions”,
“models”: [
{ “id”: “Qwen3.5-9B-OpusRsnDistV2-mlx-4bit”, “name”: “Opus (Top1)” },
{ “id”: “Qwen3.5-9B-HauhauCS-Aggro-mlx-mxfp4”, “name”: “Hauhau (Top2)” },
{ “id”: “qwen35-9b-mlx-turboquant-tq3”, “name”: “TurboQuant (Top3)” }
]
},
“minimax-portal”: {
“baseUrl”: “https://api.minimaxi.com/anthropic”,
“apiKey”: “minimax-oauth”,
“api”: “anthropic-messages”,
“models”: [
{ “id”: “MiniMax-M2.7”, “name”: “MiniMax-M2.7 (Portal)” }
]
}
}
},
“agents”: {
“defaults”: {
“model”: {
“primary”: “minimax-portal/MiniMax-M2.7”,
“fallbacks”: [
“minimax-portal/MiniMax-M2.7”,
“mac/Qwen3.5-9B-OpusRsnDistV2-mlx-4bit”,
“mac/Qwen3.5-9B-HauhauCS-Aggro-mlx-mxfp4”,
“mac/qwen35-9b-mlx-turboquant-tq3”
]
},
“models”: {
“minimax-portal/MiniMax-M2.7”: { “alias”: “m2.7” },
“mac/Qwen3.5-9B-OpusRsnDistV2-mlx-4bit”: { “alias”: “top1” },
“mac/Qwen3.5-9B-HauhauCS-Aggro-mlx-mxfp4”: { “alias”: “top2” },
“mac/qwen35-9b-mlx-turboquant-tq3”: { “alias”: “top3” }
}
}
}
}
“`

使用：
– 切换：`/model m2.7` 或 `/model top1` `/model top2` `/model top3`

**参考配置说明（只涵盖两类核心 provider：minimax-portal + mac(oMLX) 三模型）**

– **适用范围**
– 用于你后续批量改多个 OpenClaw 实例，以及 Hermes（只要 Hermes 也是走 OpenAI 兼容 `baseUrl + model id` 的方式即可复用 mac(oMLX) 部分）。

—

**1) Provider：minimax-portal（主力模型）**
– **认证方式**
– OpenClaw：使用 `auth.profiles` 的 OAuth（portal 登录态），provider 固定为 `minimax-portal`。
– 参考位置：[openclaw.json](file:///home/joehuang/.openclaw/openclaw.json#L18-L28)
– **模型引用格式**
– `minimax-portal/`
– 例：`minimax-portal/MiniMax-M2.7`
– **建议用法**
– 作为 `primary`（主模型）
– 作为 fallback 链条的第一个（保证 portal token 可用时优先走主力）

—

**2) Provider：mac（oMLX，本地三模型兜底）**
– **服务端要求（最关键）**
– oMLX 对外暴露的 `model id` = `GET /v1/models` 返回的 `data[].id`，它通常来自模型文件夹名。
– TG 点选要求：id 必须足够短（否则会因为 Telegram `callback_data` 64 bytes 限制导致“看得到但点不了”）。
– **OpenAI 兼容 endpoint**
– `baseUrl`: `http://100.88.88.88:8000/v1`
– `apiKey`: `ollama-key`（oMLX 这边用于鉴权）
– **三模型固定清单（按你当前 oMLX 实际存在的 id）**
– Top1：`Qwen3.5-9B-OpusRsnDistV2-mlx-4bit`
– Top2：`Qwen3.5-9B-HauhauCS-Aggro-mlx-mxfp4`
– Top3：`qwen35-9b-mlx-turboquant-tq3`
– **OpenClaw 配置位置（两处都要一致）**
– 全局 config：`models.providers.mac`
参考：[openclaw.json](file:///home/joehuang/.openclaw/openclaw.json#L30-L87)
– 主 agent 模型库：`agents/main/agent/models.json` 的 `mac` provider
参考：[models.json](file:///home/joehuang/.openclaw/agents/main/agent/models.json#L124-L177)
– **建议用法**
– 只作为 fallback 链条尾部兜底（推荐顺序 Top1 → Top2 → Top3）。
– 给别名便于所有实例统一操作：`top1/top2/top3`（可选但强烈建议）
参考：[openclaw.json](file:///home/joehuang/.openclaw/openclaw.json#L300-L327)

—

**3) 最小 fallback 链条模板（只保留两类 provider）**
– **推荐默认结构**
– `primary`: `minimax-portal/MiniMax-M2.7`（或你各实例实际主力模型）
– `fallbacks`（从高到低）：
– `minimax-portal/MiniMax-M2.7`
– `mac/Qwen3.5-9B-OpusRsnDistV2-mlx-4bit`（top1）
– `mac/Qwen3.5-9B-HauhauCS-Aggro-mlx-mxfp4`（top2）
– `mac/qwen35-9b-mlx-turboquant-tq3`（top3）
– 参考你当前默认链条位置（已包含 mac 兜底）：[openclaw.json](file:///home/joehuang/.openclaw/openclaw.json#L287-L299)

—

**4) 快速验收（用于每个实例改完后 10 秒确认）**
– oMLX 侧：
– `GET http://100.88.88.88:8000/v1/models`（带 Bearer `ollama-key`）应包含上述 3 个 id
– OpenClaw 侧：
– `openclaw models list –plain` 至少能看到：`minimax-portal/MiniMax-M2.7` + 3 个 `mac/…`
– `openclaw models status` 里 `Fallbacks` 的末尾应是 3 个 `mac/…`（按 top1/top2/top3 顺序）

如果你把 Hermes 的模型配置文件路径/格式贴出来（通常是 `providers` + `fallbacks` 或类似结构），我可以把上面的模板直接翻译成 Hermes 版本的“可复制配置段”。