OpenClaw 接入

推荐方式

建议使用 cc-switch 配置：https://github.com/farion1231/cc-switch/releases

• 推荐先通过 cc-switch 处理 OpenClaw 的接入配置
• 配置完成后重启 OpenClaw

首选做法

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

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

1. 安装前准备

按 OpenClaw 官方安装页，CLI 方式的前置要求是：

• Node.js 22+
• macOS / Linux / Windows
• 如果你是从源码构建，额外需要 pnpm

如果你直接使用官方安装脚本，脚本会自动检测并补装缺失的 Node.js。

如果你打算自己通过 npm 或 pnpm 管理安装，可以先去 Node.js 官方页面安装： https://nodejs.org/en/download

• macOS / Windows：下载并安装 LTS 版本，建议使用满足 OpenClaw 要求的 Node 版本
• Linux：按该页面提供的发行版方式安装

如果你在 macOS 上已经安装了 Homebrew，也可以直接执行：

brew install node

这会同时安装 Node.js 和 npm。

然后再确认：

node -v
npm -v

如果你在 Windows 上使用命令行环境，官方建议优先在 WSL2 中运行 OpenClaw。

2. 安装

官方安装页：https://docs.openclaw.ai/install/index

推荐直接使用官方安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

如果你在 Windows 上使用 PowerShell，可按官方文档执行：

iwr -useb https://openclaw.ai/install.ps1 | iex

官方文档还提供了 npm / pnpm 安装方式；如果你已经自己管理 Node 环境，也可以改走那一套。

3. 启动向导

openclaw onboard

在向导中填写：

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

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

4. 设置默认模型

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

codex_proxy/gpt-5-codex-mini

5. 手动配置

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

{
  "models": {
    "providers": {
      "codex_proxy": {
        "baseUrl": "https://aiapi.aisonnet.org/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 或环境变量托管，再改成环境变量引用即可。

6. 验证

可以先检查模型状态：

openclaw models list
openclaw models status

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

说明

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