Scope & Evidence
OpenClaw 官方支持通过 models.providers 注册自定义 OpenAI 或 Anthropic 兼容 Provider。MuxLLM 公开端点标签可以用于筛选候选模型，但工具调用、流式响应、上下文、重试和长期 Gateway 会话仍需要单独的 E3 实测。
| 等级 | 本页状态 | 已知边界 |
|---|---|---|
| E1 | MuxLLM 公开元数据已核对 | 可按 openai 或 anthropic 标签选择协议候选。 |
| E2 | OpenClaw 官方 Schema 已核对 | openclaw.json、models.providers、环境变量引用和模型引用结构有官方依据。 |
| E3 | 未执行 | 没有安装、启动 Gateway、测试连接或发送任何真实请求。 |
最后核验日期：2026-07-18。
Install
--install-daemon 或接入真实消息渠道。~/.openclaw/openclaw.json、当前默认模型和相关环境变量。npm install -g openclaw@latest
openclaw --versionCredential & Model
MODEL_NAME。export MUXLLM_OPENCLAW_KEY="YOUR_API_KEY"Protocol Matrix
| 候选路线 | 模型标签 | Base URL | OpenClaw api | 状态 |
|---|---|---|---|---|
| OpenAI 兼容 | openai | https://api.muxllm.com/v1 | openai-completions | E3 未实测，优先候选 |
| Anthropic Messages | anthropic | https://api.muxllm.com | anthropic-messages | E3 未实测，单独 Provider |
| Responses | openai-response | https://api.muxllm.com/v1 | 需按当前 OpenClaw Schema 另行设计 | 本页不提供未经验证配置 |
| Gemini 原生 | gemini | https://api.muxllm.com | 需要对应 Provider 插件或原生配置 | 不纳入本候选方案 |
Provider Config
OpenClaw 默认读取 ~/.openclaw/openclaw.json，文件格式为 JSON5。若已有配置，应合并 models 和 agents.defaults.model，不能整文件覆盖。
{
agents: {
defaults: {
model: { primary: "muxllm/MODEL_NAME" },
},
},
models: {
mode: "merge",
providers: {
muxllm: {
baseUrl: "https://api.muxllm.com/v1",
apiKey: "${MUXLLM_OPENCLAW_KEY}",
api: "openai-completions",
models: [
{ id: "MODEL_NAME", name: "MODEL_NAME" },
],
},
},
},
}mode: "merge"把自定义条目并入现有模型目录，避免无意覆盖其他 Provider。muxllm/MODEL_NAMEOpenClaw 的模型引用由 Provider ID 和模型 ID 两部分组成。${MUXLLM_OPENCLAW_KEY}运行时从环境变量取值，配置文件不保存真实 Key。api必须与模型端点标签对应；本例只适用于 openai 标签。muxllmAnthropic: {
baseUrl: "https://api.muxllm.com",
apiKey: "${MUXLLM_OPENCLAW_KEY}",
api: "anthropic-messages",
models: [
{ id: "MODEL_NAME", name: "MODEL_NAME" },
],
}该模型必须显示 anthropic 标签，默认模型引用改为 muxllmAnthropic/MODEL_NAME。此候选同样没有 E3 实测。
Controlled Validation
备份配置，确认 JSON5 Schema、Provider ID 和环境变量引用。
只列出 muxllm Provider 模型，不发送推理请求。
使用专用低额度 Key 执行一次 Test connection，记录状态码和延迟。
仅发送短文本，禁止工具、消息渠道、文件与 Shell。
Rollback
openclaw.json 的执行前备份，或精确移除 models.providers.muxllm 与对应默认模型引用。PREVIOUS_PROVIDER/PREVIOUS_MODEL，不要猜测原值。unset MUXLLM_OPENCLAW_KEYTroubleshooting
| 现象 | 可能原因 | 停止与检查 |
|---|---|---|
| 配置拒绝加载 | JSON5 结构、字段名或数组合并错误 | 停止启动，检查拒绝文件与 Schema；恢复备份，不做整文件重写。 |
| 401 | 环境变量未进入 Gateway 进程、Key 无效 | 检查服务进程环境来源与 Key 状态；不要把 Key 写入日志验证。 |
| 404 | Base URL、api 或模型标签不匹配 | 核对最终路径；OpenAI 兼容使用 /v1，Anthropic 候选使用根地址。 |
| 429 | 测试 Key 限额、余额、并发或上游限制 | 立即停止自动重试，核对已花费用量和停止条件。 |
| 文本可用但工具失败 | 模型工具能力、Schema 或代理兼容差异 | 保持页面未验证状态，单独设计最小工具调用测试，不扩大 Gateway 权限。 |
Gateway Security
Official Sources
Next Guide
OpenCode 可直接声明 OpenAI Compatible Provider，凭证仍应通过环境变量引用。