OpenClaw 接入

首选做法

优先直接用 cc-switch 完成配置。

如果你不用 cc-switch，OpenClaw 官方推荐走 openclaw onboard，然后选择 Custom Provider。

1. 启动向导

openclaw onboard

在向导中填写：

Provider 类型：Custom Provider
Compatibility：OpenAI-compatible
Base URL：https://codex.miaomiaocode.com/v1
API Key：你的 codex_... Key
Model ID：gpt-5-codex-mini
Endpoint ID：建议填 codex_proxy

这里的 API Key 直接填明文即可，不需要额外改成 OPENAI_API_KEY。

2. 设置默认模型

完成向导后，把默认模型设为：

text

codex_proxy/gpt-5-codex-mini

3. 手动配置

如果你不走向导，也可以直接写 OpenClaw 的 provider 配置：

{
  "models": {
    "providers": {
      "codex_proxy": {
        "baseUrl": "https://codex.miaomiaocode.com/v1",
        "apiKey": "codex_your_api_key",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5-codex-mini", "name": "gpt-5-codex-mini" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "codex_proxy/gpt-5-codex-mini" }
    }
  }
}

这份配置里也可以直接写 API Key 明文，不需要额外设置 OPENAI_API_KEY。

如果你自己更偏好 SecretRef 或环境变量托管，再改成环境变量引用即可。

4. 验证

可以先检查模型状态：

bash

openclaw models list
openclaw models status

如果能看到 codex_proxy/gpt-5-codex-mini 并且状态正常，就说明接入成功。

说明

OpenClaw 官方支持 Custom Provider
自定义 provider 可选 OpenAI-compatible 或 Anthropic-compatible
对当前服务，推荐优先使用 OpenAI-compatible
直接填 API Key 是默认做法；环境变量引用只是可选方案

OpenClaw 接入 ​

推荐方式 ​

首选做法 ​

1. 启动向导 ​

2. 设置默认模型 ​

3. 手动配置 ​

4. 验证 ​

说明 ​