Amux

OpenClaw

最近更新：2026年8月26日

OpenClaw 通过 OpenAI 兼容协议接入 Amux，在 openclaw.json 里加一个供应商即可。

OpenClaw 是一款跑在你自己机器上的个人 AI 助手，支持终端 TUI、网页面板、聊天软件等多种入口。它说的是 OpenAI 兼容协议。

推荐：用 CC Switch 配

CC Switch 支持 OpenClaw，添加一个供应商（Base URL 填 https://gateway.amux.ai/v1）即可，无需手动编辑 JSON。切换之后重启网关进程。

下面是手动配置的写法。

一、安装

npm i -g openclaw@latest

二、创建 Amux 密钥

在控制台的密钥页创建一把。创建后仍可在该页面再次查看，无需重新生成。

三、配置

编辑 ~/.openclaw/openclaw.json，在 models.providers 下加一段：

~/.openclaw/config.json

{
  "models": {
    "providers": {
      "amux": {
        "baseUrl": "https://gateway.amux.ai/v1",
        "apiKey": "你的 Amux 密钥",
        "api": "openai-completions"
      }
    }
  }
}
字段说明
baseUrl/v1 要带上
api请求形状，填 openai-completions
供应商名（这里是 amux）后面切模型时要用它做前缀

四、启动网关

OpenClaw 的各个入口都连它自己的网关进程：

openclaw gateway install
openclaw gateway start

改过配置之后重启它：

openclaw gateway restart

五、验证

进入任意一个入口（终端 TUI 或网页面板）发送一条测试消息。收到回复即可确认接通。

选模型

在对话里用 /model 切换，模型名是 <供应商名>/<规范 ID>：

/model amux/anthropic/claude-opus-5

前缀就是你在配置里起的那个名字。模型不限于 OpenAI 的。通过 OpenAI 协议也可以调用 Claude、Gemini 等模型；跨协议时的参数兼容性见协议转换参数兼容性。

要锁定供应商或指定路由策略，在规范 ID 后加冒号（/model amux/anthropic/claude-opus-5:@price），见 API 参考。

常见问题

改完配置没生效

通常是网关尚未重启。执行 openclaw gateway restart 后再试；各个入口都连接同一个网关进程，仅修改配置文件不会自动重新加载。

鉴权失败

确认密钥复制完整（最常见的问题是首尾空格或换行）、控制台中该密钥仍处于启用状态，且工作区余额充足。也请确认 baseUrl 包含 /v1；地址少一段时也可能表现为鉴权类错误。

切模型时提示找不到

模型名要带供应商前缀，也就是 amux/ 加规范 ID，两截都不能少。规范 ID 本身也带厂商前缀，所以完整形态是三段：amux/anthropic/claude-opus-5。

JSON 改坏了

openclaw.json 中多一个逗号就会导致整份配置失效，而 OpenClaw 可能会回退到默认供应商，看起来像是“配置未生效”。可先用任意 JSON 校验工具检查。