OpenClaw 怎么接入 OpenAI 兼容 API？Sublyx 配置方法

准备工作

• 确认 OpenClaw 能读取并加载当前使用的配置文件。
• 在 Sublyx 控制台创建 API Key，并记录安全存放位置。
• 选择一个支持 Chat Completions 的当前可用模型 ID。
• 修改前备份本地配置，并确认 YAML 缩进使用空格。

具体配置

按照项目现有 Sublyx 文档，在 OpenClaw 配置文件中设置：

providers:
  openai:
    baseURL: https://api.sublyx.org/v1
    apiKey: your-sublyx-key

baseURL 的大小写应保持不变，且 OpenAI 兼容地址末尾包含 /v1。模型选择若位于其他配置段，应填写 Sublyx 模型列表中的准确 ID。

如果希望避免把 Key 写入配置文件，且你的 OpenClaw 安装方式支持环境变量，也可以按现有文档设置：

export OPENAI_BASE_URL=https://api.sublyx.org/v1
export OPENAI_API_KEY=your-sublyx-key

最小验证请求

先绕过客户端直接测试兼容入口：

curl https://api.sublyx.org/v1/chat/completions \
  -H "Authorization: Bearer $SUBLYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "只回复 OK"}]
  }'

收到正常回复后，重启或重新加载 OpenClaw，再发送同样的短提示。这样能把服务端问题与客户端配置问题分开。

常见错误

现象	处理方法
配置不生效	确认编辑的是实际加载文件，YAML 缩进正确，并重启或重新加载客户端。
401	检查 apiKey 是否完整、已撤销或被旧环境变量覆盖。
404	确认字段为 baseURL，地址为 https://api.sublyx.org/v1，且没有重复的 /v1。
model not found	核对模型 ID 和账户可用范围。
429 或 5xx	限制并发并进行有上限的退避重试，参考 AI API 429 指南。

安全说明

配置文件若包含真实 Key，应限制文件权限，并确保不会同步到公开仓库或日志。更推荐在客户端支持时使用环境变量或密钥管理工具。不同设备和项目使用独立 Key，泄露后立即撤销。更多接口说明见 Sublyx 文档，OpenAI 兼容调用原理见 AI API 聚合网关指南。