FlexAPI Docs

主题

OpenClaw 使用指南 ​

这份教程旨在让你在最短时间内完成 FlexAPI 与 OpenClaw 的对接。

右侧为页面导航，可根据需要直接导航到指定位置

OpenClaw 是什么 ​

OpenClaw 是一个偏代理式、可扩展的本地工具，配置项相对更多。

  • OpenClaw 如何安装（可复制命令）
  • openclaw.json 放置位置（默认路径 + 强制指定方式）
  • 必须使用 Responses（openai-responses）格式
  • 安装困难时：启动 Codex，让模型把 .codex 的 API 配置写入 OpenClaw（Responses 格式）

前置要求（重要） ​

OpenClaw 需要 Node.js 22+
Windows 环境建议优先使用 WSL2

Step 1: 获取 API Key ​

1. 登录 FlexAPI 控制台 ​

前往 FlexAPI，登录并选择对应的分组，创建 FlexAPI API Key。

2. 充值额度或购买订阅 ​

按照使用模式，选择按时长订阅或充值额度按量付费。

3. 获取 API Key ​

在控制台创建或复制你的 FlexAPI API Key，后续配置 CLI 和客户端时都要用到。

参考：FlexAPI API获取教程

Step 2：安装 OpenClaw ​

检查 Node.js 版本，请先确认 Node.js 已安装且版本满足 OpenClaw 的要求。
如果你在 Windows 下希望获得更接近 Linux 的运行环境，推荐优先使用 WSL2 安装 OpenClaw。

bash
curl -fsSL https://openclaw.ai/install.sh | bash
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后自检： ​

# 查看版本
openclaw --version

# 检查配置和环境问题
openclaw doctor

# 查看当前运行状态
openclaw status

# 打开 Web 控制面板
openclaw dashboard

Step 3：配置文件位置（非常重要） ​

文件名 ​

配置文件名固定为：openclaw.json。

默认位置 ​

默认建议放在（这样升级/重装不影响配置）：

  • Linux/macOS/WSL2：~/.openclaw/openclaw.json
  • Windows（不走 WSL2 时）：建议仍按“用户主目录 + .openclaw”放置

自定义位置 ​

如果你不想放默认位置，请用环境变量强制指定（最不容易踩坑）：

  • OPENCLAW_CONFIG_PATH：配置文件路径（推荐） 示例（PowerShell）：
PowerShell
$env:OPENCLAW_CONFIG_PATH = \"C:\\\\path\\\\to\\\\openclaw.json\" 
openclaw doctor

Step 4：必须使用 Responses（response 格式） ​

你要接入 OpenAI 的 Responses 协议时，配置里必须是：

  • api: "openai-responses"

你可以直接复制仓库根目录的示例配置作为起点：openclaw.json（再按下面步骤改 Key）。

外部案例配置下载（示例文件）：

下面这段只是配置的核心片段（最小示例），用于说明关键字段；并不是完整配置，单独使用可能无法直接运行：

json
{
  "models": {
    "mode": "merge",
    "providers": {
      "codex-vip": {
        "baseUrl": "https://flexapi.me",
        "apiKey": "your_flex_api_key_start_here",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.2",
            "name": "gpt-5.2"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "codex-vip/gpt-5.2"
      }
    }
  }
}

确保将 apiKey 字段改你自己的 Key

请务必把 apiKey 从占位符改成你自己的真实 Key：

  • apiKey: "your_flex_api_key_start_here"

另外，如果你启用了网关鉴权，也请同时修改你的 gateway.auth.token，不要沿用示例值。

提示：安装困难时可用技巧 ​

  • 启动 Codex，让模型把 .codex 的 API 配置写入 OpenClaw（Responses）

如果 OpenClaw 配不顺（Node/权限/路径各种问题），先启动 Codex CLI，然后告诉模型把用户目录 .codex 的 API 配置写入 openclaw.json

步骤：

1.启动 Codex CLI：codex

2.输入这句话给模型：

请把用户目录下.codex api 配置到openclaw中，注意是response格式。

保存后用 openclaw doctor 自检。

FlexAPI Docs

Copyright © 2026 FlexAPI