GPTsAPI 使用教程

1. 在 setting 的 models 里面点击 Override OpenAI Base URL

2. 填入 2233 base URL https://api.gptsapi.net/v1 和 2233 的 API key

OpenAI 模型就可以直接调用了

3. 调用 Claude

同样在 OpenAI API key 模式下，不要切换到 Anthropic API key。

点击 add model，可以增加以下模型（用 wild 替换模型中的 claude ，opus 和 haiku 同理）:

• 想用claude-opus-4-6 则填 wild-opus-4-6
• 想用claude-sonnet-4-6 则填 wild-sonnet-4-6
• 想用claude-haiku-4-5-20251001 则填 wild-haiku-4-5-20251001

即可正常调用 claude sonnet 模型。（上述支持的模型会不定期更新，可以在https://gptsapi.net/api 查看最新支持的模型）

1. 点击 cline 头像，在 Settings 中，选择 API Provider 为 OpenAI Compatible

2. 填入 2233 base URL https://api.gptsapi.net/v1 和 2233 的 API key

OpenAI 模型就可以直接调用了

3. 调用 Claude

同样在 OpenAI Compatible 模式下， 输入 model id 即可正常调用：

• claude-3-5-sonnet-20241022
• claude-3-5-sonnet-20240620
• claude-3-7-sonnet-20250219

1. 获取 API Key

在 gptsapi.net 注册并获取你的 API Key（通常以 sk- 开头）。

2. 将 API Key 写入环境变量

建议将 API Key 写入环境变量，避免明文存储在配置文件中：

# 写入 shell profile（如 ~/.bashrc 或 ~/.zshrc）
export GPTSAPI_KEY="sk-your-api-key-here"
source ~/.bashrc

如果你用 systemd 管理 OpenClaw Gateway，把这行加入 service 文件的 Environment= 或对应的 env file 中。

3. 编辑 openclaw.json

编辑 ~/.openclaw/openclaw.json，添加 provider 定义和模型 allowlist：

"defaults": {
  "model": {
    "primary": "gptsapi/claude-sonnet-4-6",
    "models": {
      "gptsapi/claude-sonnet-4-6": {}
    }
  },
  "mode": "merge",
  "providers": {
    "gptsapi": {
      "baseUrl": "https://api.gptsapi.net/v1",
      "apiKey": "${GPTSAPI_KEY}",
      "api": "openai-completions",
      "models": [
        {
          "id": "claude-sonnet-4-6",
          "name": "Claude Sonnet 4.5 via gptsapi",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 200000,
          "maxTokens": 8192,
          "cost": {
            "input": 0.003,
            "output": 0.015,
            "cacheRead": 0,
            "cacheWrite": 0
          }
        }
      ]
    }
  }
}

注意：models 数组中的 id 必须与 gptsapi.net 实际接受的模型名一致。上面的 claude-sonnet 是示例，请根据 gptsapi.net 支持的模型列表 替换。cost 字段用于 OpenClaw 的用量统计，按实际价格填写即可，不影响功能。

4. 验证配置

执行以下命令检查配置是否合法：

# 检查配置是否合法
openclaw doctor
openclaw models list

输出中应能看到 gptsapi/claude-sonnet-4-6 等条目。

5. 切换主模型（可选）

通过 CLI 切换主模型：

openclaw models set gptsapi/claude-sonnet-4-6

或在对话中发送 /model gptsapi/claude-sonnet-4-6 即时切换。

6. 配置 fallback（可选）

如果你同时有其他 provider 的 key，可以设置回退链。当 primary 模型遇到 rate limit 或服务异常时，OpenClaw 会自动按顺序尝试 fallback。

7. 重启 Gateway

修改配置后需要重启网关使配置生效：

openclaw gateway restart
# 或
openclaw gateway

配置生效后，所有 Channel（WhatsApp、Telegram、Slack 等）发来的消息都会通过 gptsapi.net 处理。

排查要点

• 模型不在列表中 → 检查 defaults.model.models 或 providers.gptsapi.models 中是否包含目标模型（如 gptsapi/claude-sonnet-4-6），模型 id 需与 gptsapi.net 支持的列表一致。
• 模型调用被拒绝 → 一旦设置了 defaults.model.models，它就变成白名单模式，未列出的模型全部被拦截。确认你要用的模型已加入该字段；如果不需要白名单限制，可以移除整个 defaults.model.models。
• 环境变量未生效 → 确认 Gateway 进程的运行环境能读到 GPTSAPI_KEY；可先执行 openclaw doctor 检查配置是否合法。