**参考配置说明（只涵盖两类核心 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 版本的“可复制配置段”。